图片生成

POST /v1/images/generations 提供 OpenAI Images 风格的同步图片生成接口。当前首个上游为火山方舟 Seedream；可用模型以 /v1/model-catalog 中 task_type=image 的记录为准。

文生图

curl -X POST https://llm.xiaoyue9527.xyz/v1/images/generations \
  -H 'Authorization: Bearer sk-gtw-REPLACE_ME' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "doubao-seedream-5-0-lite-260128",
    "prompt": "雨后竹林中的白色小猫，柔和自然光",
    "size": "2K",
    "response_format": "url"
  }'

图生图

image 可传一条 HTTPS 图片 URL、Base64 图片 Data URI，或由它们组成的数组。

{
  "model": "doubao-seedream-5-0-lite-260128",
  "prompt": "保留构图，改为水彩插画风格",
  "image": [
    "https://cdn.example.com/reference.png"
  ],
  "size": "2K",
  "response_format": "url"
}

请求字段

字段	必填	说明
model	是	图片生成模型 ID
prompt	是	图片描述或编辑指令，最多 20 KiB
image	否	图生图输入，最多 10 张；远程地址必须使用 HTTPS
n	否	最大生成张数，默认 1，范围 1-15；多图模式按实际上游返回张数结算
size	否	1K、2K、4K 或 WIDTHxHEIGHT
response_format	否	url（默认）或 b64_json
output_format	否	png 或 jpeg
watermark	否	是否启用上游水印
stream	否	当前只支持同步调用；传 true 返回 400

内联图片仅接受 image/png、image/jpeg、image/webp 的 Base64 Data URI，单项编码内容不超过 2 MiB。网关会拒绝明文 HTTP、内网 IP、localhost 和带嵌入式凭据的 URL。

成功响应

{
  "created": 1788200000,
  "model": "doubao-seedream-5-0-lite-260128",
  "data": [
    {
      "url": "https://example.com/generated.png",
      "size": "2048x2048"
    }
  ],
  "usage": {
    "generated_images": 1,
    "output_tokens": 123,
    "total_tokens": 123
  }
}

url 是上游临时结果地址，客户端应及时下载并持久化；需要长期保存时，不要依赖该 URL 的有效期。选择 b64_json 时，data[] 返回 b64_json。

计费与失败边界

• 按实际成功返回的图片张数计费，不把图片数量按文本 token 计费。
• 请求调用上游前必须同时命中有效的平台图片单价和当前供应商凭据成本价；缺少任一价格时返回 503 billing_error，不会调用付费上游。
• 路由支持健康检查与可重试错误回退；每个候选渠道都独立校验供应商成本价。
• 审计只记录模型、路由、状态码和正文大小等元数据，不记录提示词、参考图或生成图片正文。
• 上游鉴权失败、响应过大、没有图片或返回图片数超过请求上限时，网关返回受控错误。