ImageCreateBody

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/adsturbo-ai/json-schema/adsturbo-ai-image-create-body-schema.json",
  "title": "ImageCreateBody",
  "description": "Create or edit images. `model` is the short model name. If omitted, the server defaults to `nanobanana-pro`.\nFor text-to-image, send an empty `image_urls` array. For image editing, send one or more `image_urls`.\n\n**Mode support**:\n- Text-to-image only: `grok-2-image`\n- Editing only: `seedream-4.5-seq`, `seedream-5.0-lite-seq`, `grok-imagine-image`\n- Text-to-image + editing: `nanobanana-pro`, `nano-banana-2`, `nano-banana-2-fast`, `seedream-4.5`, `seedream-5.0-lite`, `gpt-image-2`\n\n**Model-specific parameters**:\n- Supported `ratio` values vary by model.\n- `resolution` is supported only by `nanobanana-pro`, `nano-banana-2`, `nano-banana-2-fast`, and `gpt-image-2`.\n- `quality` is supported only by `gpt-image-2`.\n- `num_images` is supported only by `seedream-4.5-seq` and `seedream-5.0-lite-seq`, with a maximum of 15.",
  "x-generated": "2026-10-31",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/adsturbo-ai-openapi.json#/components/schemas/ImageCreateBody",
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "description": "Text prompt for image generation."
    },
    "image_urls": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Empty for text-to-image. Non-empty for image editing."
    },
    "model": {
      "type": "string",
      "enum": [
        "nanobanana-pro",
        "nano-banana-2",
        "nano-banana-2-fast",
        "seedream-4.5",
        "seedream-4.5-seq",
        "seedream-5.0-lite",
        "seedream-5.0-lite-seq",
        "gpt-image-2",
        "grok-2-image",
        "grok-imagine-image"
      ],
      "description": "Optional. Defaults to `nanobanana-pro`."
    },
    "ratio": {
      "type": "string",
      "description": "Supported values vary by model. See the request body description.",
      "enum": [
        "1:1",
        "3:2",
        "2:3",
        "3:4",
        "4:3",
        "4:5",
        "5:4",
        "16:9",
        "9:16",
        "21:9"
      ]
    },
    "resolution": {
      "type": "string",
      "description": "Supported only by selected models. See the request body description.",
      "enum": [
        "0.5k",
        "1k",
        "2k",
        "4k",
        "8k"
      ]
    },
    "quality": {
      "type": "string",
      "description": "Supported only by `gpt-image-2`.",
      "enum": [
        "low",
        "medium",
        "high"
      ]
    },
    "num_images": {
      "type": "integer",
      "format": "int32",
      "minimum": 1,
      "maximum": 15,
      "description": "Supported only by `seedream-4.5-seq` and `seedream-5.0-lite-seq`."
    },
    "concurrency": {
      "type": "integer",
      "format": "int32",
      "description": "Number of concurrent outputs to generate."
    },
    "sync_mod": {
      "type": "boolean"
    }
  }
}