Using 4o Image in your workflow

Sorceress brings OpenAI models into a shared API catalog. Select this model explicitly, check its supported inputs, and keep your API key on your server. Model capabilities differ; the schema and options on this page describe this entry rather than every model from the same brand.

Create visual concepts and iterate on art direction.
Build images into an asset pipeline using the supported inputs below.

Pricing and availability

Sorceress pricing is awaiting activation. The reference catalog lists 6 credits per image; that reference is not a Sorceress quote. This entry cannot currently be invoked through Sorceress.

Inputs and supported options

{
  "type": "object",
  "required": [
    "size"
  ],
  "properties": {
    "size": {
      "enum": [
        "1:1",
        "3:2",
        "2:3"
      ],
      "type": "string",
      "title": "Size",
      "description": "(Required) Aspect ratio of the generated image. Must be one of the listed values."
    },
    "prompt": {
      "type": "string",
      "title": "Prompt",
      "description": "(Optional) Text prompt that conveys the creative idea you want the 4o model to render. Required if neither `files_url` nor `file_url` is supplied. At least one of `prompt` or `files_url` must be provided."
    },
    "file_url": {
      "type": "string",
      "title": "File URL",
      "format": "uri",
      "x-media": "image",
      "description": "(Optional, Deprecated) File URL, such as an image URL. If file_url is provided, 4o image may create based on this image. This parameter will be deprecated in the future, please use files_url instead."
    },
    "files_url": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      },
      "title": "Files URL",
      "x-media": "image",
      "description": "(Optional) Up to 5 publicly reachable image URLs to serve as reference or source material. Use this when you want to edit or build upon an existing picture. Supported formats:.jfif,.pjpeg,.jpeg,.pjp,.jpg,.png,.webp. At least one of `prompt` or `files_url` must be provided."
    }
  }
}

Completion, results and billing

Save the job identifier returned by asynchronous requests and poll the jobs endpoint until the job succeeds or fails. Do not resubmit a generation just because it is still processing. Chat returns a completed reply and usage details. A multi-step workflow can include separately billed successful steps even if a later step fails. Keep returned asset links with your project, and consult each action for its output format.

Coding agents can discover the current catalog and input requirements from the Sorceress agent instructions. Use a Sorceress key; provider credentials stay on the server.