Seedance / 豆包视频生成走火山方舟(Ark)原生任务协议,平台透明转发:请求体、响应体与状态枚举均与火山方舟官方一致,鉴权替换为你的 MaiToken API Key 即可。可用模型(如 doubao-seedance-2-0、doubao-seedance-1-5-pro、doubao-seedance-1-0-pro 等)以 列出模型 返回为准。
Authorizations
Bearer Token 认证。 获取 API Key:访问 API Key 管理页面
Authorization: Bearer YOUR_API_KEY提交生成任务
POST /api/v3/contents/generations/tasks请求头与火山方舟官方一致,仅需 Authorization: Bearer <token> 与 Content-Type: application/json(Seedance 系官方仅支持 API Key 鉴权,无其他特殊头)。请求体为火山方舟原生格式:
model(必填):模型名,以/v1/models为准content(必填):内容数组——type: "text"为提示词(可在文本尾部追加--resolution 720p --duration 5等参数指令);type: "image_url"为参考图,image_url.url支持公网 URL、Base64 data URI 或已入库素材的asset://<ASSET_ID>(见 虚拟人像素材),role可标注first_frame/last_frame/reference_image- 其余参数与火山方舟官方文档一致,平台原样透传:
resolution/duration/ratio/seed/watermark/camera_fixed/generate_audio/return_last_frame(返回尾帧图)/service_tier(default/flex)/callback_url(任务状态变更回调)等
查询任务
GET /api/v3/contents/generations/tasks/{id}响应为火山方舟原生任务体,状态枚举(方舟原生):queued / running / succeeded / failed / cancelled / expired。成功后 content.video_url 为生成视频地址(24 小时有效,请及时转存);若提交时带 return_last_frame: true,尾帧图在 content.last_frame_url。
列出任务
GET /api/v3/contents/generations/tasks?page_num=1&page_size=20火山方舟原生列表端点,支持 filter.status、filter.task_ids、filter.model 等过滤参数(page_num / page_size 取值 1–500),响应为 items[] + total。
取消 / 删除任务
DELETE /api/v3/contents/generations/tasks/{id}火山方舟原生语义:对 queued 任务为取消(状态转 cancelled);对 succeeded / failed / expired 任务为删除记录;running 与 cancelled 状态不支持此操作。成功返回空 JSON {}。