获取 API Key 获取 API
文档

Seedream-5.0-Pro 图像生成

- 异步处理模式,返回任务 ID 用于后续查询

  • 支持文生图、单图生图、多参考图生图(最多 10 张参考图)
  • 支持 1K / 1.5K / 2K 分辨率档位,或 size 直接指定精确像素
  • 单图模型:每次仅生成 1 张;支持 PNG / JPEG 输出
  • 生成的图像链接,有效期为72小时,请尽快保存

请求示例

curl --request POST \
  --url https://api.openveer.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedream-5-0-pro",
    "prompt": "赛博朋克风格的城市夜景,霓虹灯反射在湿润街道上",
    "size": "16:9",
    "resolution": "2K"
  }'

响应示例

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

Authorizations

Authorization string

所有接口均需要使用Bearer Token进行认证

获取 API Key:

访问 API Key 管理页面 获取您的 API Key

使用时在请求头中添加:

Authorization: Bearer YOUR_API_KEY
信息

单图模型:doubao-seedream-5-0-pro 每次请求仅生成 1 张图像。以下参数会直接拒绝(返回 400,不建任务、不扣费):

  • n > 1
  • sequential_image_generation: "auto"(不支持组图)
  • image_urls 超过 10 张

以下参数会被静默忽略:tools(联网搜索)、stream、optimize_prompt_options。

Body

model string

图像生成模型名称

  • doubao-seedream-5-0-pro(推荐)
  • 亦接受:doubao-seedream-5.0-pro
prompt string

图像生成的文本描述

建议: 控制在 600 英文单词以内,描述过长可能导致细节丢失。

resolution string

分辨率档位(兼容小写)

  • 1K(默认)
  • 1.5K(与 1K 同价,画质更好,无特殊理由建议优先用 1.5K)
  • 2K

传入 3K / 4K 等不支持档位会返回 400。

警告



当 size 为精确像素值(如 2048x1024)时,本字段被忽略,尺寸完全由 size 决定。

size string

宽高比、auto,或精确像素值。两种写法不要混用:

### 写法 ①:档位 + 宽高比

与 resolution 配合使用。支持的宽高比:

  • 1:1、4:3、3:4、16:9、9:16、3:2、2:3、21:9
  • 兼容 16x9 这种 x 写法
  • auto(默认):只下发分辨率档位,最终宽高比由模型根据 prompt / 参考图自动判断

列表外的宽高比(如 9:21)直接返回 400,不会静默回退成 1:1。

档位 × 比例 → 实际输出像素:

分辨率 1:1 4:3 3:4 16:9 9:16 3:2 2:3 21:9
1K 1024×1024 1152×864 864×1152 1312×736 736×1312 1248×832 832×1248 1568×672
1.5K 1536×1536 1792×1344 1344×1792 2048×1152 1152×2048 1872×1248 1248×1872 2352×1008
2K 2048×2048 2304×1728 1728×2304 2560×1440 1440×2560 2496×1664 1664×2496 3024×1296

### 写法 ②:精确像素

size 写成 宽x高 时按像素输出,resolution 不参与。兼容 2048X1024 / 2048×1024。

约束 取值
总像素(宽 × 高) [921600, 4624220](约 1280×720 \~ 2048×2048×1.1025)
宽高比(宽 / 高) [1/16, 16]

警告



限制的是宽高乘积,不是单边。例如 512×512 总像素过低会 400;2048×1024 合法。

image_urls array

参考图像的 URL 列表,用于单图 / 多参考图生图,最多 10 张

支持两种格式:

1. 公网 URL

  • http:// 或 https:// 可访问链接
  • 示例:https://example.com/image.jpg

2. Base64(Data URI)

  • 格式:data:image/<格式>;base64,<编码>,<格式> 必须小写
  • 示例:data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...

单张图片限制:

  • 格式:jpeg / png / webp / bmp / tiff / gif / heic / heif
  • 宽高比(宽/高):[1/16, 16]
  • 单边 > 14 px
  • 大小 ≤ 30 MB
  • 总像素 ≤ 6000×6000(36,000,000)

计费: 第 1 张参考图免费,第 2 张起每张加收固定单价。

output_format string

输出图片格式

  • jpeg(默认)
  • png

兼容: response_format 与 output_format 等价,其余取值按 jpeg 处理。

watermark boolean

是否在生成图像右下角添加 "AI generated" 水印

  • true:添加
  • false:不添加(默认)

请求示例

文生图(档位 + 比例)

{
  "model": "doubao-seedream-5-0-pro",
  "prompt": "赛博朋克风格的城市夜景,霓虹灯反射在湿润街道上",
  "resolution": "2K",
  "size": "21:9",
  "output_format": "png"
}

文生图(精确像素)

{
  "model": "doubao-seedream-5-0-pro",
  "prompt": "极简风格电商主图,白底,产品居中",
  "size": "1600x1600"
}

多参考图

{
  "model": "doubao-seedream-5-0-pro",
  "prompt": "将图 1 的服装换为图 2 的服装",
  "image_urls": [
    "https://example.com/person.jpg",
    "https://example.com/dress.jpg"
  ],
  "resolution": "2K",
  "size": "auto"
}

推荐:1.5K 同价更好画质

{
  "model": "doubao-seedream-5-0-pro",
  "prompt": "一只可爱的橘猫坐在窗台上,午后阳光,电影感",
  "resolution": "1.5K",
  "size": "16:9"
}

计费说明

总价 = 输出图单价 + 输入参考图加价 × max(0, 参考图张数 − 1)

输出图按实际总像素分档(约 2.61M = 2,601,124):

条件 单价
总像素 ≤ 2.61M(1.5K 及以下:resolution 为 1K / 1.5K / 不传,或精确像素 ≤ 2,601,124) \$0.045 / 张
总像素 > 2.61M(高于 1.5K:resolution: "2K",或精确像素 > 2,601,124) \$0.09 / 张
  • 1.5K 与 1K 同价(均为 \$0.045)。
  • size 为精确像素时按实际输出面积计费,resolution 不影响(例如 size: "2048x2048" 按 \$0.09)。
  • 第 1 张参考图免费,第 2 张起每张另计参考图加价。
  • 任务失败自动全额退款。

常见错误

场景 说明
不支持的 resolution 档位 如 3K / 4K → 400
列表外的宽高比 如 9:21 → 400
精确像素总像素越界 须在 [921600, 4624220]
精确像素宽高比越界 须在 [1/16, 16]
n > 1 / 组图参数 单图模型,拒绝
参考图超过 10 张 拒绝
注意

⏱️ 生成较慢:1K 约 90 秒、2K 约 160 秒(质量优先)。提交后每 5\~10 秒轮询一次 获取任务状态,客户端超时建议 5 分钟。生成的图像链接有效期为 72 小时,请尽快保存。

Response

code integer

响应状态码

data array
返回数据数组
status string

任务状态

  * submitted - 已提交
task_id string

任务唯一标识符