Seedance 任务状态与结果

Seedance 生视频是异步任务。创建请求返回任务 ID，随后通过 Modelflare 轮询，直到任务完成或失败。

支持的模型

本页覆盖 seedance-2.5、seedance-2.5-nsfw、seedance-2.0 和 seedance-2.0-nsfw。

创建任务

完整请求字段请查看对应模型页：

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "content": [{"type": "text", "text": "一只猫走过洒满阳光的房间"}],
    "resolution": "720p",
    "duration": 5,
    "ratio": "16:9"
  }'

保存响应中的 id。兼容响应也可能使用 task_id。

轮询任务

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

公开响应会统一不同视频供应商的状态结构：

JSON

{
  "id": "TASK_ID",
  "object": "video",
  "model": "seedance-2.5",
  "status": "in_progress",
  "progress": 42,
  "created_at": 1786084139,
  "seconds": "5",
  "metadata": {
    "action": "omniGenerate",
    "resolution": "1080p",
    "ratio": "9:16",
    "output_format": "mp4",
    "generate_audio": true,
    "usage": {"completion_tokens": 120, "total_tokens": 140}
  }
}

当 status 为 queued 或 in_progress 时继续轮询；变为 completed 或 failed 后停止。

状态	含义	下一步
queued	等待执行	继续轮询
in_progress	正在处理	继续轮询
completed	视频已完成	下载内容
failed	任务失败	读取错误并修正请求

当服务端返回这些字段时，metadata 可能包含动作类型、分辨率、比例、输出格式、音频开关和 token 用量。它们都是可选字段；稳定契约仍然是 status 和内容下载接口。

下载结果

bash

curl --fail --location \
  https://modelflare.dev/v1/videos/TASK_ID/content \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --output seedance-result.mp4

内容接口返回视频流。结果地址可能过期，完成后应及时转存。

失败任务

创建接口可能在服务端完成校验前先返回任务 ID，因此任务之后可能变为 failed。排查时保留 request ID，不要把同一请求静默改成另一种模型族的 JSON 结构重试。