生成图组或修改参考图 · Alibaba

{
  "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": "可选整数。非图组模式请求 1 至 4 张，文档默认 1；enable_sequential=true 时设置 1 至 12 张的上限，文档默认 12，实际张数由模型决定且不超过上限。"
        },
        "seed": {
          "type": "integer",
          "maximum": 2147483647,
          "minimum": 0,
          "description": "可选整数，范围 0 至 2147483647。用于复用随机起点，不保证图片完全一致或主体保持不变。"
        },
        "size": {
          "anyOf": [
            {
              "enum": [
                "1K",
                "2K"
              ],
              "type": "string"
            },
            {
              "type": "string",
              "pattern": "^\\d+\\*\\d+$"
            }
          ],
          "default": "2K",
          "description": "可选 1K、2K（默认）或 width*height，例如 1536*1024。所有模式的自定义总像素范围为 768×768 至 2048×2048、宽高比为 1:8 至 8:1，不支持 4K；不是每条边的独立范围，实际尺寸可能略有差别。无参考图时预设为方图，有参考图时预设比例跟随最后一张输入。"
        },
        "images": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "description": "非空的公开 HTTPS URL。每张 JPG/JPEG、无透明通道的 PNG、BMP 或 WEBP 不超过 20 MB，每边须在 240 至 8000 像素之间，宽高比为 1:8 至 8:1。本工具的参考图输入不接受本地文件、base64 或 HTTP 链接。"
          },
          "maxItems": 9,
          "description": "可选数组，最多九张公开 HTTPS 图片链接，用于编辑或多图参考。按希望使用的顺序提供；纯文字生成时省略整个字段。"
        },
        "prompt": {
          "type": "string",
          "maxLength": 5000,
          "minLength": 1,
          "description": "必填非空文字，最多 5000 个字符。描述新画面、编辑要求或图组中相互关联的场景。不提供单独的 negative_prompt 字段；希望排除的内容写在描述里，但不保证一定不会出现。"
        },
        "bbox_list": {
          "type": "array",
          "items": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": -9007199254740991
              },
              "maxItems": 4,
              "minItems": 4
            }
          },
          "description": "可选列表，外层与输入图片一一对应。每张图可提供零至两个框，格式 [x1,y1,x2,y2]，四个整数坐标使用原图绝对像素、左上角为 (0,0)。某张图不设框时填 []，坐标应在对应原图范围内。"
        },
        "watermark": {
          "type": "boolean",
          "default": false,
          "description": "可选布尔值，默认 false；启用时请求添加 AI Generated 水印。"
        },
        "color_palette": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "hex",
              "ratio"
            ],
            "properties": {
              "hex": {
                "type": "string",
                "pattern": "^#[0-9A-Fa-f]{6}$",
                "description": "每个配色项中必填，以 # 开头的六位十六进制颜色，例如 #C2D1E6。"
              },
              "ratio": {
                "type": "string",
                "pattern": "^\\d+(\\.\\d{1,2})?%$",
                "description": "每个配色项中必填的百分比字符串。为兼容服务，按两位小数填写，例如 33.34%；所有项须合计 100.00%。"
              }
            },
            "additionalProperties": false
          },
          "maxItems": 10,
          "minItems": 3,
          "description": "可选数组，包含 3 至 10 种颜色，建议八种；图组模式不可用。填写各颜色和比例，所有比例合计 100.00%。"
        },
        "thinking_mode": {
          "type": "boolean",
          "description": "可选布尔值，文档默认 true。仅在无输入图且未开启图组模式的文字生成中生效，会增加处理时间，不保证效果一定更好。"
        },
        "enable_sequential": {
          "type": "boolean",
          "default": false,
          "description": "可选布尔值，默认 false。启用时在一次请求中生成相关场景图组，n 表示张数上限；不保证达到上限或完全连贯，思考模式和自定义配色不可用。"
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}