图像模型进阶用户更新于
POST/v1/images/generations
Doubao Seedream 5.0 Lite
请求 ID doubao-seedream-5-0-lite
协议
认证
请求需要 API Key。在控制台的 API Key 管理 获取密钥。发送 JSON 请求时，设置 Content-Type: application/json。
Authorization: Bearer YOUR_API_KEY
请求参数
POST /v1/images/generations
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
model | string | 必填 | 填写此模型的请求 ID doubao-seedream-5-0-lite. |
prompt | string | 必填 | 描述要生成的图像。 |
aspect_ratio | string | 选填 | 输出图像的宽高比。 可用值 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9. 默认 1:1. 有参考图时也可传 auto。 |
image_size | string | 选填 | 输出分辨率档位。 可用值 2K, 3K. 默认 2K. |
n | integer | 选填 | 生成张数，可传 1–4。 默认 1. |
image_urls | string[] | 选填 | JSON 参考图数组。每项可为公开 HTTPS 图片链接或 Base64 图片 data URL。 兼容字段 image_input. |
?async | string | 选填 | URL 查询参数。传 1、true 或 yes 返回 202 和 task_id。省略时等待生成结果。 |
请求示例
先将 API Key 设置为本机环境变量 ICODEEASY_API_KEY，并选择支持直接 HTTP 调用的接入点。接入点要求特定客户端时，按对应客户端指南配置。
示例中的素材 URL 和素材 ID 需要替换成自己的有效素材。
Images Generations
bash
curl -sS 'https://api.icodeeasy.cc/v1/images/generations' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"model": "doubao-seedream-5-0-lite",
"prompt": "A watercolor illustration of a paper lantern by a lake."
}'
查询图片任务
bash
curl -sS 'https://api.icodeeasy.cc/v1/images/tasks/YOUR_TASK_ID' \
-H "Authorization: Bearer $ICODEEASY_API_KEY"
响应与任务
HTTP 200 · 同步成功
使用 ?sync=1 时，成功响应中的 data[].url 是图片地址。created 为 Unix 秒时间戳，id 为任务 ID。
json
{
"id": "d142c93a-de26-40c9-be62-0de840d10960",
"created": 1781599773,
"data": [
{
"url": "https://example.com/generated-image.png"
}
]
}
HTTP 202 · 异步提交
json
{
"task_id": "d142c93a-de26-40c9-be62-0de840d10960",
"status": "pending"
}
使用 ?async=1 后，用同一 API Key 查询 GET /v1/images/tasks/{task_id}。status 可为 pending、completed 或 failed。完成后从 result_url 读取图片地址。
HTTP 200 · 查询到已完成任务
json
{
"task_id": "d142c93a-de26-40c9-be62-0de840d10960",
"status": "completed",
"model": "doubao-seedream-5-0-lite",
"result_url": "https://example.com/generated-image.png"
}
常见错误
查询返回 failed 时读取 error。若存在 error_detail，根据 retryable 判断是否适合重新提交。
完整接入指南 · 查看完整接口指南，了解请求字段、任务状态和响应格式。
能力与限制
text_to_image· 支持image_to_image· 有条件支持 — 需要以支持的请求格式提供有效参考图image_editing· 未公开承诺reference_images· 有条件支持 — 需要以支持的请求格式提供有效参考图
兼容别名与退役重定向
doubao-seedream-5.0-lite→doubao-seedream-5-0-lite(别名)