图片生成

本部分的异步任务接口仅适用于下列协议兼容模型；不是所有图片模型都使用 /v1/videos。本站在线生图另见 生图工作台教程。

提交请求后返回统一任务 ID，并自动写入 DragonAPI 任务日志。

POST /v1/videos

创建图片任务

请求参数

参数	类型	必填	说明
model	string	是	图片模型 ID，见图片/视频模型目录
prompt	string	是	图片内容、构图、风格与光线描述
size	string	否	宽高比，如 1:1、16:9、9:16、3:2
resolution	string	否	分辨率档位，如 1k、2k、4k；以模型能力为准
n	integer	否	生成数量，默认 1
reference_images	string[]	否	公开可访问的参考图 URL 数组
image_urls	string[]	否	兼容参考图字段

文生图

curl --request POST \
  --url https://newapi.dragon3api.com/v1/videos \
  --header 'Authorization: Bearer YOUR_DRAGONAPI_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedream-4-0",
    "prompt": "未来城市夜景海报，霓虹灯，电影感构图",
    "size": "16:9",
    "resolution": "1k",
    "n": 1
  }'

参考图生成

curl --request POST \
  --url https://newapi.dragon3api.com/v1/videos \
  --header 'Authorization: Bearer YOUR_DRAGONAPI_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedream-4-0",
    "prompt": "保持主体结构，改成赛博朋克广告海报",
    "size": "16:9",
    "reference_images": ["https://your-domain.example/reference.png"]
  }'

响应

{
  "id": "task_xxxxxxxxxxxxxxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxxxxxxxxxxxxxx",
  "object": "generation.task",
  "model": "doubao-seedream-4-0",
  "status": "queued",
  "progress": 0
}

参考图必须可访问

建议使用你自己的 HTTPS 对象存储地址。客户端无需也不应接触渠道侧上传地址或渠道令牌。