API字节跳动Seedance 系列模型
创建任务
创建异步视频生成任务。
请求
POST /ai/api/v3/contents/generations/tasks
Authorization: Bearer <TUIWO_API_TOKEN>
Content-Type: application/json{
"model": "<seedance-model-id>",
"content": [
{"type": "text", "text": "A calm lake at sunrise, cinematic lighting"}
],
"callback_url": "https://example.com/callback"
}参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型 ID，以控制台当前分组可用模型为准 |
content | array | 是 | Ark 风格内容数组 |
resolution | string | 否 | 分辨率，具体支持范围由模型决定 |
duration | number | 否 | 时长（秒），具体范围由模型决定 |
ratio | string | 否 | 画面比例，具体支持范围由模型决定 |
seed | number | 否 | 随机种子 |
generate_audio | boolean | 否 | 是否生成音频，具体支持范围由模型决定 |
callback_url | string | 否 | 终态回调地址，必须是公网 HTTPS |
content 的具体可用类型（文本、图片、视频等）由模型与平台能力决定。文档只保证 Ark 结构兼容，不承诺所有模型支持全部内容类型。
响应
{
"id": "cgt-xxxxxxxx",
"task_id": "task_xxxxxxxx"
}id是兼容任务 ID，可能为空字符串。task_id是 TUIWO 平台任务 ID。- 不要依赖
id一定存在；需要稳定标识时使用task_id或两者之一查询。
错误
| HTTP | code | 说明 |
|---|---|---|
| 400 | InvalidParameter | 请求体无效、缺少 model 或无法解析 |
| 401 | AuthenticationError | 令牌无效 |
| 403 | AccessDenied | 分组/模型权限不足 |
| 404 | NotFound | 模型在当前分组不可用 |
| 409 | AmbiguousServiceConfiguration | 多个服务配置匹配同一分组/模型 |
| 409 | SubmissionUncertain | 提交结果不确定，使用返回的 task_id 查询确认 |
| 429 | RateLimitExceeded | 请求过于频繁 |
| 503 | ServiceUnavailable | 任务服务暂不可用 |
幂等
创建接口使用平台幂等机制；请勿用创建任务探测模型是否存在，以免产生费用。