Doubao Seedream 3.0 T2I(异步任务)
bytedance/doubao-seedream-3.0-t2i
异步任务:POST /v1/tasks/generations 提交 → GET /v1/tasks/generations/{request_id} 轮询结果(POST 发送后 request_id 自动填入 GET)。
BASE URL
https://router.shengsuanyun.com/api认证方式
Authorization: Bearer YOUR_API_KEY端点列表
POST/v1/tasks/generations豆包 图像生成-异步
异步任务:POST 提交后返回 request_id,再用 GET /v1/tasks/generations/{request_id} 轮询结果。
请求体
application/json
| 字段 | 类型 | 说明 |
|---|---|---|
prompt必填 | stringtextarea | |
response_format | string | 可选值:"url" · "b64_json" |
size | string | 可选值:"1280x720" |
seed | integer | |
guidance_scale | number | |
watermark | boolean | |
model必填 | string | 路由模型,本页固定为 bytedance/doubao-seedream-3.0-t2i |
{
"guidance_scale": 2.5,
"model": "bytedance/doubao-seedream-3.0-t2i",
"prompt": "在虚空中展现许多打开的门,每扇门里都有不同世界、不同地区、不同时代的景象,如同平行时空,下面一个渺小的男子的背影,望着这片虚空,站在光线暗淡阴沉,奇幻诡异的风格。图片中人物保持动态模糊,数字矩阵中交织着噪点与频谱美学。超现实主义。幻想。暗黑美学,生物学,实验,数字,函数。模糊处理,暗调,恢宏史诗级震撼美学,oc渲染,c4d,高分辨率。宗教,神话,幻想。光线追踪,动态模糊,景深,超现实主义,深灰,画面通过细腻的丰富的色彩层次塑造主体与场景,质感真实,暗黑风背景的光影效果营造出氛围,整体兼具艺术幻想感,夸张的广角透视效果,耀光,反射,时空之门,梦核,能量,洞穴场景,石门,哈利波特",
"response_format": "url",
"seed": -1,
"size": "1280x720",
"watermark": false
}请求示例
参考地址:https://router.shengsuanyun.com/api。路径参数与凭据需替换;非 JSON 请求体需按对应格式准备。
curl -X POST 'https://router.shengsuanyun.com/api/v1/tasks/generations' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
--data '{
"guidance_scale": 2.5,
"model": "bytedance/doubao-seedream-3.0-t2i",
"prompt": "在虚空中展现许多打开的门,每扇门里都有不同世界、不同地区、不同时代的景象,如同平行时空,下面一个渺小的男子的背影,望着这片虚空,站在光线暗淡阴沉,奇幻诡异的风格。图片中人物保持动态模糊,数字矩阵中交织着噪点与频谱美学。超现实主义。幻想。暗黑美学,生物学,实验,数字,函数。模糊处理,暗调,恢宏史诗级震撼美学,oc渲染,c4d,高分辨率。宗教,神话,幻想。光线追踪,动态模糊,景深,超现实主义,深灰,画面通过细腻的丰富的色彩层次塑造主体与场景,质感真实,暗黑风背景的光影效果营造出氛围,整体兼具艺术幻想感,夸张的广角透视效果,耀光,反射,时空之门,梦核,能量,洞穴场景,石门,哈利波特",
"response_format": "url",
"seed": -1,
"size": "1280x720",
"watermark": false
}'响应
200 提交成功,返回 request_id / task_id
application/json
未提供结构定义。
{
"code": "success",
"message": "",
"data": {
"request_id": "REQ_xxx",
"task_id": "TASK_xxx",
"action": "GENERATION",
"status": "PENDING",
"progress": "0%"
}
}400 请求参数错误
401 未授权(API Key 无效)
429 请求过于频繁
500 服务器内部错误
GET/v1/tasks/generations/{request_id}查询异步任务状态与产物
通过 POST /v1/tasks/generations 返回的 request_id 轮询任务状态、进度与产物 URL(image_urls / video_urls / audio_urls / file_urls / text)。下方「在线测试」填入 request_id 即可发送查询;若上方 POST 已发送成功,request_id 会自动填入。
请求参数
| 参数 | 位置 / 类型 | 说明 |
|---|---|---|
request_id必填 | path / string | POST /v1/tasks/generations 返回的请求 ID |
请求示例
参考地址:https://router.shengsuanyun.com/api。路径参数与凭据需替换;非 JSON 请求体需按对应格式准备。
curl -X GET 'https://router.shengsuanyun.com/api/v1/tasks/generations/{request_id}' \
-H 'Authorization: Bearer YOUR_API_KEY'响应
200 任务状态与产物
application/json
未提供结构定义。
{
"image_urls": [
"https://oss.shengsuanyun.com/example/modelinfo/128/2025-09-23_15:43:20_output_1.png"
],
"progress": 100
}