方舟 Seedance：创建视频任务

提交火山方舟 Seedance 原生异步视频生成任务。认证须使用 Portal「API 密钥」页创建的视频类型 key（普通 key 无法创建视频任务）。

相关：查询任务状态 · 素材库

接口地址

POST /api/v3/contents/generations/tasks

Base 示例：https://ai.youqi.tech（以控制台公布的 Gateway 为准，路径不含 /v1 前缀）。

认证

Authorization: Bearer sk-YOUR_VIDEO_API_KEY

可选幂等头：Idempotency-Key: <unique-string>（同一用户下相同 body 可安全重试）。

请求要点

字段	必填	说明
model	是	账户白名单内的 Seedance 模型（可有多条，见 模型列表 的 group_name）
content	是	方舟原生 content 数组（文本 / 图片 / asset://… 等）
duration / ratio 等	视模型	对齐方舟 Seedance 2.0 参数

素材引用使用 asset://<asset_id>，须先通过素材库入库；asset_id 为平台自有 Id，且须与任务所选模型同属一条渠道（同一分组名）。Portal 不提供创建任务入口。

请求示例

curl https://ai.youqi.tech/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer sk-YOUR_VIDEO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: demo-001" \
  -d '{
    "model": "seedance-2.0",
    "content": [
      { "type": "text", "text": "一只猫在窗边睡觉，电影感光线" }
    ],
    "duration": 5,
    "ratio": "16:9"
  }'

计费说明

提交时先按官方公式预扣钱包余额，再预占该视频 key 的额度；任务成功后按上游 total_tokens × 该分辨率档折后单价结算（多退少补，结算不乘安全系数），失败则双侧释放。素材库调用不计费。结果视频 URL 由上游返回，平台不做转存。

预扣估算：

tokens ≈ (输入视频秒 + 输出秒) × 宽 × 高 × fps / 1024
预扣 ≈ tokens / 1e6 × 该档单价 × 安全系数（默认 1.15）

• 未传 resolution / quality 时按官方默认 720p 选档；ratio 只影响预扣像素，不改价档。
• 请求分辨率（或宽高）对不上该模型已配置的定价行 → 400（该模型未配置此分辨率定价），不会回退到 720p 价。
• 含参考视频但解析不到 Duration 时，输入秒用该模型定价的固定秒数（默认 5），不用输出时长兜底。
• fps / frame_rate 未传时按 24。

创建成功后响应里的 id 以 yq_ 开头（平台任务 id，不是方舟 task_ / cgt-）。后续查询、取消都用这个 id。

若引用的素材处于「待重建」，任务会进入 pending_rebuild（最多等待 2 小时）；超时或重建失败则整单失败并释放预扣。

取消

仅 pending_rebuild（尚未提交方舟）可通过 POST /api/v3/contents/generations/tasks/{id}/cancel 或 Portal 任务页取消。已提交上游（running 等）不可取消。