生成图片或修改参考照片 · Alibaba

{
  "type": "object",
  "required": [
    "body"
  ],
  "properties": {
    "body": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "prompt",
        "size"
      ],
      "~standard": {
        "vendor": "zod",
        "version": 1,
        "jsonSchema": {}
      },
      "properties": {
        "n": {
          "type": "integer",
          "default": 1,
          "maximum": 6,
          "minimum": 1,
          "description": "可选整数，范围 1 至 6，默认 1。设置本次请求生成或编辑的图片数量，实际成功张数以返回结果为准。"
        },
        "seed": {
          "type": "integer",
          "maximum": 2147483647,
          "minimum": 0,
          "description": "可选整数，范围 0 至 2147483647。用于复用随机设置，同一种子不保证得到完全相同的图片。"
        },
        "size": {
          "type": "string",
          "pattern": "^\\d+\\*\\d+$",
          "description": "必填 width*height 格式字符串，例如 1024*1024，使用星号分隔，不能用 x 或 auto。生成和编辑都要求总像素在 512×512 至 2048×2048 之间、宽高比在 1:8 至 8:1 之间；不是每条边的独立范围，实际尺寸可能略有差别。"
        },
        "images": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "description": "非空、可公开访问的 HTTPS 图片 URL。支持 JPG、JPEG、PNG、BMP、TIFF、WEBP、GIF，每张不超过 10 MB；每边 384 至 2048 像素是建议范围，不是硬性边长限制。"
          },
          "maxItems": 3,
          "description": "可选数组，最多包含三张公开 HTTPS 图片链接，数组顺序就是参考顺序。纯文字生成时省略整个字段，不要假定空数组能选择该模式。"
        },
        "prompt": {
          "type": "string",
          "minLength": 1,
          "description": "必填非空文字，用于描述新画面或对输入图的修改目标。建议最多 4500 tokens，并非 4500 字符上限。可说明希望保留的主体细节，效果不保证完全符合描述。"
        },
        "watermark": {
          "type": "boolean",
          "default": false,
          "description": "可选布尔值，默认 false；启用时请求添加 AI Generated 水印。"
        },
        "prompt_extend": {
          "type": "boolean",
          "default": true,
          "description": "可选布尔值，默认 true。让模型在生成或编辑前改写描述，不保证效果一定更好。"
        },
        "enable_thinking": {
          "type": "boolean",
          "description": "可选布尔值，文档默认 true。要求 prompt_extend=true，会增加处理时间，不保证图片质量或还原程度。"
        },
        "negative_prompt": {
          "type": "string",
          "description": "可选文字，描述希望排除的元素；可引导模型，但不保证这些内容一定不会出现。"
        },
        "prompt_extend_mode": {
          "enum": [
            "direct",
            "agent"
          ],
          "type": "string",
          "description": "可选 direct 或 agent，文档默认 direct。direct 支持生成和编辑；agent 仅用于不带输入图的纯文字生成，进行更充分的描述改写。"
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}