{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://hop-base.com/spec/models/seedream-5-0-pro.json",
  "title": "POST /v1/images/generations · seedream-5-0-pro",
  "description": "Seedream 5.0 Pro 的请求体契约，由插件校验代码导出的 spec 生成。未列出的字段网关会忽略或原样转发。",
  "type": "object",
  "required": [
    "model",
    "prompt"
  ],
  "properties": {
    "model": {
      "const": "seedream-5-0-pro"
    },
    "prompt": {
      "type": "string",
      "minLength": 1,
      "pattern": "\\S",
      "description": "去除首尾空白后不能为空，否则 400「missing prompt」"
    },
    "size": {
      "description": "简写 1K / 1.5K / 2K，或 宽x高：总像素 921600–4624220，宽高比 1:16–16:1",
      "anyOf": [
        {
          "enum": [
            "1K",
            "1.5K",
            "2K"
          ]
        },
        {
          "type": "string",
          "pattern": "^[1-9][0-9]*x[1-9][0-9]*$"
        }
      ],
      "x-hopbase-constraints": {
        "pixels": {
          "min": 921600,
          "max": 4624220
        },
        "max_aspect_ratio": 16
      }
    },
    "n": {
      "const": 1,
      "default": 1,
      "description": "only a single output is supported (n=1)"
    },
    "response_format": {
      "enum": [
        "url"
      ],
      "default": "url"
    },
    "output_format": {
      "enum": [
        "png",
        "jpeg"
      ]
    },
    "optimize_prompt_options": {
      "type": "object",
      "properties": {
        "mode": {
          "enum": [
            "standard",
            "fast"
          ]
        }
      }
    },
    "image": {
      "description": "参考图（传入即图生图 / 编辑）：最多 10 张；Data URL 单张 ≤ 31457280 字节；URL 提交时不下载",
      "anyOf": [
        {
          "type": "string",
          "pattern": "^(https?://|data:image/)",
          "description": "HTTP(S) URL 或图片 Data URL"
        },
        {
          "type": "array",
          "items": {
            "type": "string",
            "pattern": "^(https?://|data:image/)",
            "description": "HTTP(S) URL 或图片 Data URL"
          },
          "minItems": 1,
          "maxItems": 10
        }
      ]
    },
    "watermark": {
      "description": "服务端固定为 false，传了不生效"
    }
  },
  "additionalProperties": true,
  "$defs": {
    "edits": {
      "$comment": "POST /v1/images/edits（multipart 为主）：至少 1 张参考图，不接受 mask（null 也拒）",
      "type": "object",
      "required": [
        "model",
        "prompt",
        "image"
      ],
      "properties": {
        "model": {
          "const": "seedream-5-0-pro"
        },
        "prompt": {
          "type": "string",
          "minLength": 1,
          "pattern": "\\S",
          "description": "去除首尾空白后不能为空，否则 400「missing prompt」"
        },
        "size": {
          "description": "简写 1K / 1.5K / 2K，或 宽x高：总像素 921600–4624220，宽高比 1:16–16:1",
          "anyOf": [
            {
              "enum": [
                "1K",
                "1.5K",
                "2K"
              ]
            },
            {
              "type": "string",
              "pattern": "^[1-9][0-9]*x[1-9][0-9]*$"
            }
          ],
          "x-hopbase-constraints": {
            "pixels": {
              "min": 921600,
              "max": 4624220
            },
            "max_aspect_ratio": 16
          }
        },
        "n": {
          "const": 1,
          "default": 1,
          "description": "only a single output is supported (n=1)"
        },
        "response_format": {
          "enum": [
            "url"
          ],
          "default": "url"
        },
        "output_format": {
          "enum": [
            "png",
            "jpeg"
          ]
        },
        "optimize_prompt_options": {
          "type": "object",
          "properties": {
            "mode": {
              "enum": [
                "standard",
                "fast"
              ]
            }
          }
        },
        "image": {
          "description": "参考图（传入即图生图 / 编辑）：最多 10 张；Data URL 单张 ≤ 31457280 字节；URL 提交时不下载",
          "anyOf": [
            {
              "type": "string",
              "pattern": "^(https?://|data:image/)",
              "description": "HTTP(S) URL 或图片 Data URL"
            },
            {
              "type": "array",
              "items": {
                "type": "string",
                "pattern": "^(https?://|data:image/)",
                "description": "HTTP(S) URL 或图片 Data URL"
              },
              "minItems": 1,
              "maxItems": 10
            }
          ]
        },
        "watermark": {
          "description": "服务端固定为 false，传了不生效"
        },
        "mask": false
      },
      "additionalProperties": true
    }
  },
  "x-hopbase": {
    "model_name": "Seedream 5.0 Pro",
    "family": "seedream",
    "endpoints": [
      "POST /v1/images/generations",
      "POST /v1/images/edits"
    ],
    "response_field": "data[].url",
    "groups": [
      {
        "id": 21,
        "name": "Seedance 海外 · Seedream",
        "name_en": "Seedance overseas + Seedream"
      },
      {
        "id": 24,
        "name": "Seedream 生图分组",
        "name_en": "Seedream Image Generation"
      }
    ],
    "pricing": {
      "currency": "USD",
      "label": "官方价，实际按分组倍率计费",
      "source": "https://api.hop-base.com/api/v1/models/pricing",
      "snapshot": "2026-09-25",
      "unit": "image",
      "per_image_le_2_61mp": 0.045,
      "per_image_gt_2_61mp": 0.09,
      "per_input_reference": 0.003
    },
    "rejected": [
      {
        "field": "mask",
        "status": 400,
        "message": "seedream does not accept a traditional mask; draw the annotation on the reference image and describe it in the prompt"
      }
    ],
    "references": {
      "max": 10,
      "enforced_by": "gateway",
      "max_bytes": 31457280
    },
    "size_shorthands": [
      "1K",
      "1.5K",
      "2K"
    ],
    "reference_mimes": [
      "image/jpeg",
      "image/png",
      "image/webp",
      "image/bmp",
      "image/tiff",
      "image/gif",
      "image/heic",
      "image/heif"
    ],
    "url_ttl_hours": 24,
    "verified": {
      "date": null,
      "feed": "https://hop-base.com/docs-verified.json",
      "route": "media/images"
    },
    "docs": "https://hop-base.com/zh-cn/docs/media/images#seedream-请求参数",
    "source": [
      "toc-landing/docs-app/spec/seedance.json#images.models[id=seedream-5-0-pro] (airgate-seedance)"
    ],
    "generated_by": "toc-landing/docs-app/scripts/build-model-schemas.mjs"
  }
}