图像生成 - OpenAI Images 协议

接口概述

使用 OpenAI Images 格式生成图片，适用于豆包 Seedream 系列模型，支持文本生图、图生图 / 多图融合、组图序列生成。请求体是扁平结构（参数直接放在顶层），图片地址在响应的 data[] 里取。

本页只讲这一套协议；通义千问 / 万相系模型使用另一套报文，见「文生图-DashScope 协议」页。

按张计费，每次费用可在控制台「费用中心」查看。

接口地址

POST https://test.jw-info.com/v1/images/generations

请求头

请求参数

本协议下无需传 watermark（默认不加水印）。

模型差异

doubao-seedream-5.0-pro、doubao-seedream-5.0-pro-0724 同属这一协议，参数写法一致。

分辨率说明

• 像素格式为 <宽>x<高>（使用小写字母 x），总像素范围 [3,686,400, 16,777,216]、宽高比范围 [1/16, 16]；传得过小会被拒绝（错误正文会说明要求）
• 默认分辨率为 2048x2048，也支持预设档位：1K、2K、3K、4K
• 推荐分辨率：

请求示例

最简请求：

{
  "model": "doubao-seedream-4.5",
  "prompt": "一只白色猫咪坐在书桌上，阳光从窗户照进来"
}

完整请求（含尺寸、返回格式与提示词优化模式）：

{
  "model": "doubao-seedream-5.0-lite",
  "prompt": "一张科技感十足的海报，标题为「AI未来」，蓝色渐变背景",
  "size": "2048x2048",
  "response_format": "url",
  "output_format": "png",
  "stream": false,
  "optimize_prompt_options": { "mode": "standard" }
}

图生图请求：

{
  "model": "doubao-seedream-4.5",
  "prompt": "将背景改为星空，保持主体不变",
  "size": "2048x2048",
  "response_format": "url",
  "image": ["https://example.com/photo.jpg"]
}

组图序列生成请求：

{
  "model": "doubao-seedream-4.5",
  "prompt": "一组四张的咖啡店菜单插画，风格统一",
  "sequential_image_generation": "auto",
  "sequential_image_generation_options": { "max_images": 4 }
}

响应参数

响应示例

url 模式：

{
  "model": "doubao-seedream-4.5",
  "created": 1719820800,
  "data": [
    { "url": "https://example.com/generated_image.jpg", "b64_json": null, "size": "2048x2048" }
  ],
  "usage": {
    "generated_images": 1,
    "output_tokens": 16384,
    "total_tokens": 16384,
    "image_count": 1
  }
}

b64_json 模式：

{
  "model": "doubao-seedream-4.5",
  "created": 1719820800,
  "data": [
    { "url": null, "b64_json": "/9j/4AAQSkZJRgABAQEASABIAAD/2wBD...", "size": "2048x2048" }
  ],
  "usage": {
    "generated_images": 1,
    "output_tokens": 16384,
    "total_tokens": 16384,
    "image_count": 1
  }
}

组图序列生成会一次返回多张，data[] 每张一个元素，usage.image_count 为实际张数。

错误响应

请求参数或鉴权有问题时返回 400 / 401 / 402，正文为 {"detail": "说明文字"}；模型侧报错时返回 502 并保留模型返回的原始错误正文，便于定位。尺寸不合法（原始正文含说明）：

{
  "detail": "模型服务返回错误 400：{\"error\":{\"message\":\"The parameter `size` specified in the request is not valid: image size must be at least 3686400 pixels.\"}}"
}

模型名写错（原始正文含 code）：

{
  "detail": "模型服务返回错误 400：{\"error\":{\"message\":\"Model not found: doubao-seedream-xxx\",\"type\":\"invalid_request_error\",\"code\":\"model_not_found\"}}"
}

完整状态码见「错误码」页。

代码示例

cURL：

curl -X POST https://test.jw-info.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{
    "model": "doubao-seedream-4.5",
    "prompt": "一只白色猫咪坐在书桌上，阳光从窗户照进来",
    "size": "2048x2048",
    "response_format": "url"
  }'

Python：

import requests

BASE = "https://test.jw-info.com"
API_KEY = "sk-你的密钥"

payload = {
    "model": "doubao-seedream-4.5",
    "prompt": "一只白色猫咪坐在书桌上，阳光从窗户照进来",
    "size": "2048x2048",
    "response_format": "url",
}
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_KEY}",
}

response = requests.post(f"{BASE}/v1/images/generations", json=payload, headers=headers)
result = response.json()

if response.status_code == 200:
    for item in result["data"]:
        print("图片 URL:", item["url"])
    print("用量:", result["usage"])
else:
    print("请求失败:", result.get("detail", result))

可用模型

模型清单与单价以模型广场为准（含上架状态）。

计费

• 按张计费：单价 × 实际出图张数（组图序列生成一次回多张时按多张计），单价见模型广场
• 按输出像素分档：doubao-seedream-5.0-pro 一类模型按 size 判档（如 ≤ 261 万像素一档、超出按更高档，以模型广场展示为准）；size 无法判断时按高档计
• 调用报错记 0 费用；每次费用可在控制台「费用中心」查看