创建视频任务（火山原生格式）

创建一个异步 Seedance 视频生成任务。HTTP 200 表示已受理，返回的 id 用于后续查询；不表示视频已经生成成功。

请求与鉴权

请求：POST /api/v3/contents/generations/tasks。

使用 JSON 请求体，必填 model 和非空 content 数组。

请求头：Authorization: Bearer YOUR_API_TOKEN、Content-Type: application/json。

使用本站 API 令牌，令牌必须具有所选模型的访问权限及足够额度。

创建请求会按本站规则预扣及结算费用；示例是请求结构说明，本次文档整理未执行新的付费生成。

调用流程

选择当前账号可用的模型，准备文本或素材。

提交本接口，将响应中的 id 原样保存。

使用 GET /api/v3/contents/generations/tasks/{id} 查询。建议每 5 秒轮询一次，并自行设置整体等待超时。

queued、running 时继续等待；succeeded 时读取 content.video_url；failed、cancelled 时停止轮询。

也可以使用同一个本站 ID 调用 /v1/videos/{id}，该入口采用 OpenAI 兼容格式。

模型与输入

常用公开模型示例：seedance-2.0-480P、seedance-2.0-720P、seedance-2.0-1080P；是否可调用以当前账号的模型权限为准。

文本内容使用 { "type": "text", "text": "提示词" }。

首帧/首尾帧模式使用 image_url 和 first_frame / last_frame；参考模式使用 reference_image / reference_video / reference_audio，两种模式不要混用。

图片可使用公网 URL、模型支持的图片 Data URI 或 asset:// 素材 URI；视频使用公网 URL 或素材 URI；音频来源按所选模型支持范围使用。

示例中的 URL、素材 URI、任务 ID 均为占位值，调用前必须替换。URL 素材应可被服务端和上游访问，已登记素材应处于可用状态。

多模态素材的数量、尺寸、格式、总时长以及组合限制随模型变化，本站不承诺所有透传字段在所有模型上都有效；具体限制参考所选模型的官方说明。

当前线上约定

建议每次显式填写布尔值 generate_audio。

false、0 等显式值在原生参数序列化时会保留，但它们是否在某个参数的合法范围内仍由模型规则决定。

callback_url 当前不支持，必须完全省略；传空字符串或 null 也会拒绝。请使用查询接口轮询。

创建响应当前只返回本站任务 id，不返回视频地址、最终状态或实际用量。

不建议在创建超时后立即反复重提；请先确认是否已经受理，避免重复创建和计费。

错误处理

任务处理层常见结构：{ "code": "...", "message": "...", "data": null }。

鉴权、权限或路由层常见结构：{ "error": { "message": "...", "type": "new_api_error", "code": "..." } }。

上游参数错误通常会转换为本站 fail_to_fetch_task，具体上游错误可能保留在 message 中。

成功受理后发生的生成失败需要通过任务查询识别，不会回写已经结束的创建 HTTP 请求。

cURL 示例

API_TOKEN 为本站 API 令牌。

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

application/json

任务已受理。保存 id 后通过查询接口读取最终状态和结果。

Bodyapplication/json

示例

{
    "id": "task_example_created"
}

创建视频任务（火山原生格式）

请求与鉴权

调用流程

模型与输入

当前线上约定

错误处理

cURL 示例

请求参数

请求示例代码

返回响应

创建视频任务（火山原生格式）

请求与鉴权#

调用流程#

模型与输入#

当前线上约定#

错误处理#

cURL 示例#

请求参数

请求示例代码

返回响应

请求与鉴权

调用流程

模型与输入

当前线上约定

错误处理

cURL 示例