API 文档 · 任务
异步任务与状态
状态机、失败码与请求字段。
POST /v1/videos/generations 校验通过后立即返回 202 和任务对象。受理之后发生的失败不会改变已返回的 202，只体现在任务对象的 error 字段中。账号或 Key 同时进行中的任务数达到上限时返回 429 rate_limited（Retry-After: 10）。
任务状态
| status | 说明 |
|---|---|
| 排队中 | 已受理，等待处理 |
| 准备素材 | 正在把输入素材准备到处理渠道 |
| 生成中 | 正在生成 |
| 恢复处理中 | 当前渠道出现异常，平台正在另一条渠道恢复处理；任务 ID 不变 |
| 核查中 | 平台在核对上游的最终结果，避免重复生成或重复计费 |
| 结算中 | 保存结果并结算 |
| 成功 | 成功，result 中有视频地址；终态 |
| 失败 | 失败，error 中有失败码与说明；终态 |
只有 succeeded 和 failed 是终态。请不要依赖中间状态的顺序，平台可能跳过某些状态，或在恢复时从 running 回到 recovering。
失败码
| error.code | 建议动作 |
|---|---|
no_available_channel | 本站暂时没有可用的处理线路。请稍后用新的幂等键重新提交。 |
upstream_status_unknown | 平台未能确认生成结果。请查看下方费用明细，并用新的幂等键重新提交。 |
task_deadline_exceeded | 任务超过处理时限仍未完成。可降低时长或分辨率后重新提交。 |
content_rejected | 提示词或生成内容未通过内容审核。请调整描述后重新提交，重复提交同样内容仍会失败。 |
asset_rejected | 输入素材未通过审核或格式校验。请更换素材后重试。 |
invalid_parameter | 参数组合不受支持。请对照模型能力表检查分辨率、比例、时长与输入数量。 |
account_suspended | 账号已被停用，请联系运营。 |
result_unavailable | 生成结果无法取回。请重新提交。 |
internal_error | 平台内部错误。请稍后重试；如反复出现，请带上请求 ID 联系运营。 |
请求字段
| 字段 | 说明 |
|---|---|
model | 必填，模型 ID；必须在 Key 的白名单中，且账号已开通（否则 403 permission_denied） |
prompt | 提示词；不带任何 inputs 的文生视频必填，长度上限见能力表 |
inputs | 输入素材数组 { type, asset_id, role }，最多 20 个；首帧、尾帧不能与参考类角色同时使用 |
duration | 必填，时长（秒）；能力表允许时可传 -1 由模型自动决定 |
resolution / ratio | 必填，分辨率与画面比例，取值见能力表 |
max_budget | 可选，单任务预算上限（字符串金额）；冻结上界超过它时返回 402 quota_exceeded |
callback_url | 可选，终态时推送 Webhook |
metadata | 可选，字符串键值，原样返回；最多 32 条，键 ≤ 64 字符、值 ≤ 512 字符，合计 ≤ 8 KiB |
provider_options | 可选，模型特有参数（扁平键值，如 seed），可用的键与类型见能力表；值为布尔、整数或不超过 32 字符的字符串 |
fallback_models | 可选，跨模型兜底：主模型所有线路都不可用时按顺序改用这些模型（最多 3 个）。按实际模型计费，冻结额按候选中最贵的一个；返回的 model_used 写明实际模型 |
allow_fallback | 可选，为 true 时使用平台为该模型配置的默认兜底链（模型列表的 default_fallbacks）；不传或 false 时不兜底 |
结果字段
任务成功后 result 包含 video_url、last_frame_url、url_expires_at 与 retained_until，有效期见结果保留。如账号开通了返回上游原链接，还会带 upstream_video_url 与 upstream_url_expires_at（上游原链接通常在生成完成后 24 小时内有效）。
参考图 + 参考音频
POST https://cn-api.aitoken.tools/v1/videos/generations
{
"model": "seedance-2.0-standard",
"prompt": "人物看向镜头微笑，背景虚化",
"inputs": [
{ "type": "image", "asset_id": "asset_xxx", "role": "reference_image" },
{ "type": "audio", "asset_id": "asset_yyy", "role": "reference_audio" }
],
"duration": 8,
"resolution": "1080p",
"ratio": "9:16",
"max_budget": "30.000000",
"callback_url": "https://example.com/hooks/video",
"metadata": { "order_id": "A-1001" }
}