获取 API Key 获取 API
文档

Seedream-4.0 图像生成

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

  • 支持文本转图片、图生图、图像编辑等多种生成模式
  • 生成的图像链接,有效期为24小时,请尽快保存

请求示例

curl --request POST \
  --url https://api.openveer.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-4-0",
    "prompt": "可爱的熊猫在竹林中玩耍",
    "size": "1:1",
    "resolution": "2K",
    "n": 1,
    "image_urls": [
      "https://cdn.openveer.com/doc/1761215838466614297_9852.png"
    ]
  }'

响应示例

{
  "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

Body

model string

图像生成模型名称

支持的模型:doubao-seedance-4-0、doubao-seedream-4.0、doubao-seedream-4-0、Doubao-Seedream-4.0

Example: "doubao-seedance-4-0"

prompt string

图像生成的文本描述

最长 1000 个字符

size string

图像生成的宽高比

支持的宽高比:

  • 1:1 - 正方形(默认)
  • 4:3 - 横向 4:3
  • 3:4 - 纵向 3:4
  • 16:9 - 横向宽屏
  • 9:16 - 纵向竖屏
  • 3:2 - 横向 3:2
  • 2:3 - 纵向 2:3
  • 21:9 - 超宽屏
  • 9:21 - 超竖屏
  • auto - 自动匹配参考图像比例(需要提供 image_urls)
resolution string

图像分辨率

支持的分辨率:

  • 1K - 基础分辨率
  • 2K - 标准分辨率(默认)
  • 4K - 高清分辨率

分辨率参考尺寸:

分辨率 1:1 尺寸 16:9 尺寸
1K 1024x1024 1280x720
2K 2048x2048 2560x1440
4K 4096x4096 5404x3040
**1K 分辨率**

| 比例   | 像素        |
| ---- | --------- |
| 1:1  | 1024x1024 |
| 4:3  | 1152x864  |
| 3:4  | 864x1152  |
| 16:9 | 1280x720  |
| 9:16 | 720x1280  |
| 3:2  | 1248x832  |
| 2:3  | 832x1248  |
| 21:9 | 1512x648  |
| 9:21 | 648x1512  |

**2K 分辨率**

| 比例   | 像素        |
| ---- | --------- |
| 1:1  | 2048x2048 |
| 4:3  | 2304x1728 |
| 3:4  | 1728x2304 |
| 16:9 | 2560x1440 |
| 9:16 | 1440x2560 |
| 3:2  | 2496x1664 |
| 2:3  | 1664x2496 |
| 21:9 | 3024x1296 |
| 9:21 | 1296x3024 |

**4K 分辨率**

| 比例   | 像素        |
| ---- | --------- |
| 1:1  | 4096x4096 |
| 4:3  | 4694x3520 |
| 3:4  | 3520x4694 |
| 16:9 | 5404x3040 |
| 9:16 | 3040x5404 |
| 3:2  | 4992x3328 |
| 2:3  | 3328x4992 |
| 21:9 | 6198x2656 |
| 9:21 | 2656x6198 |
n integer

生成图像的数量

取值范围:1-15(最少 1 张,最多 15 张)

默认值:1

注意:

  • 必须输入纯数字(如 1),不要加引号,否则会报错

会根据生成数量进行预扣费

注意

image_urls 中的参考图数量 + n 指定的最终生成图片数量必须 ≤ 15 张。

image_urls array

参考图像的 URL 列表,用于图生图或图像编辑

支持两种格式:

1. 完整的图像URL地址

  • 公开可访问的图像URL(http\:// 或 https\://)
  • 示例:https://example.com/image.jpg

2. Base64 编码格式

  • 必须使用完整的 Data URI 格式
  • 格式:data:image/{格式};base64,{base64数据}
  • 支持的图片格式:jpeg、png
  • 示例:data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • ⚠️ 注意:必须包含 data:image/jpeg;base64, 前缀部分

限制:

  • 图片格式:jpeg、png
  • 宽高比(宽/高)范围:[1/3, 3]
  • 宽高长度(px)> 14
  • 单张图片大小:不超过 10MB
  • 总像素:不超过 6000×6000 px
注意

image_urls 中的参考图数量 + n 指定的最终生成图片数量必须 ≤ 15 张。

optimize_prompt_options string

提示词优化模式

  • standard:标准模式,生成内容的质量更高,耗时较长
  • fast:快速模式,生成内容的耗时更短,质量一般

默认值:standard

sequential_image_generation string

组图生成模式(豆包特有功能)

用于控制是否生成多张图片:

  • disabled:禁用组图模式,即使有多张参考图也只生成 1 张图片(默认)
  • auto:启用组图模式,可以生成多张图片

使用说明:

  • ✅ 必须提供 image_urls - 至少需要 1 张参考图
  • ✅ 设置 n: 3 或使用 sequential_image_generation: "auto" + max_images: 3
  • ✅ 这样会基于参考图生成 3 张不同的图片
  • ⚠️ 当 n > 1 时会自动设置为 auto

限制:

  • 纯文生图(没有 image_urls)无法生成多张,这是豆包 API 的限制
sequential_image_generation_options object

组图生成选项

当 sequential_image_generation 设置为 auto 时可用

属性:

  • max_images (integer): 指定生成图片的数量,取值范围:1-15

示例:

"sequential_image_generation": "auto",
"sequential_image_generation_options": {
  "max_images": 3
}
watermark boolean

是否在生成的图像上添加水印

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

Response

code integer

响应状态码

data array
返回数据数组
status string

任务状态

  * submitted - 已提交
task_id string

任务唯一标识符