View raw JSON
{
"type": "object",
"required": [
"body"
],
"properties": {
"body": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"prompt"
],
"~standard": {
"vendor": "zod",
"version": 1,
"jsonSchema": {}
},
"properties": {
"n": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Optional integer. Outside set mode, request 1–4 images, documented default 1. With enable_sequential=true, choose a cap of 1–12, documented default 12; the model chooses the actual count without exceeding the cap."
},
"seed": {
"type": "integer",
"maximum": 2147483647,
"minimum": 0,
"description": "Optional integer from 0 to 2147483647. Reuses a random starting value; it does not ensure identical images or an unchanged subject."
},
"size": {
"anyOf": [
{
"enum": [
"1K",
"2K"
],
"type": "string"
},
{
"type": "string",
"pattern": "^\\d+\\*\\d+$"
}
],
"default": "2K",
"description": "Optional 1K, 2K (default), or width*height such as 1536*1024. All modes allow custom total pixel area from 768×768 to 2048×2048 and aspect ratio 1:8–8:1, without 4K. These are not independent side bounds; actual dimensions may vary slightly. Presets are square without references and use the last reference aspect ratio when images are supplied."
},
"images": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"description": "Nonempty public HTTPS URL. Each JPG/JPEG, PNG without alpha, BMP or WEBP image must be at most 20 MB, with both sides 240–8000 pixels and aspect ratio 1:8–8:1. Local files, base64 and HTTP links are not accepted reference inputs here."
},
"maxItems": 9,
"description": "Optional array of up to nine public HTTPS image links for editing or multi-image reference. Keep the intended order. Omit the whole field for text-only generation."
},
"prompt": {
"type": "string",
"maxLength": 5000,
"minLength": 1,
"description": "Required nonempty text, at most 5000 characters. Describe a new image, an edit or the related scenes in a set. There is no separate negative_prompt input; include any exclusions in this description, without expecting guaranteed absence."
},
"bbox_list": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"maxItems": 4,
"minItems": 4
}
},
"description": "Optional list aligned one-to-one with the input images. For each image, provide zero to two boxes [x1,y1,x2,y2] using four integer coordinates in original-image pixels, with top-left origin (0,0). Use [] for an image without boxes and choose coordinates within that image."
},
"watermark": {
"type": "boolean",
"default": false,
"description": "Optional boolean, default false. Enable it to request an AI Generated watermark."
},
"color_palette": {
"type": "array",
"items": {
"type": "object",
"required": [
"hex",
"ratio"
],
"properties": {
"hex": {
"type": "string",
"pattern": "^#[0-9A-Fa-f]{6}$",
"description": "Required within each palette entry: a six-digit hexadecimal color preceded by #, such as #C2D1E6."
},
"ratio": {
"type": "string",
"pattern": "^\\d+(\\.\\d{1,2})?%$",
"description": "Required percentage string within each palette entry. For provider compatibility, use two decimal places, such as 33.34%; all entries must add up to 100.00%."
}
},
"additionalProperties": false
},
"maxItems": 10,
"minItems": 3,
"description": "Optional array of 3–10 colors; eight are recommended. Unavailable in set mode. Supply each color and its percentage share, with the shares totaling 100.00%."
},
"thinking_mode": {
"type": "boolean",
"description": "Optional boolean, documented default true. Effective only for text-only generation outside set mode; it adds processing time without guaranteeing a better result."
},
"enable_sequential": {
"type": "boolean",
"default": false,
"description": "Optional boolean, default false. Enable it to request related scenes in one set, with n acting as the count cap. Actual quantity and visual continuity are not guaranteed; thinking mode and the custom palette are unavailable."
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}