跳到主要内容

视频异步任务

视频生成不会在一个同步 JSON 请求中完成。请使用 视频生成 API 中的任务接口，并根据目标模型的协议提交请求。

推荐流程​

查询 /v1/models
  ↓
POST /v1/video/generations 或 POST /v1/videos
  ↓
保存 task_id
  ↓
GET /v1/video/generations/{task_id} 或 GET /v1/videos/{task_id}
  ↓
成功后读取结果，必要时 GET /v1/videos/{task_id}/content

请求示例​

curl https://api.openfde.work/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-5-260628",
    "prompt": "一座漂浮在云海上的未来城市",
    "duration": 5
  }'

字段是否支持由目标模型决定。平台不会把 async: true 当作所有视频模型都必须传入的字段；异步性由视频路由本身决定。

轮询建议​

  • 短任务间隔 5–10 秒。
  • 长任务使用指数退避，避免频繁请求。
  • 遇到 failed 保存错误对象和任务 ID。
  • 任务完成后及时下载结果 URL；URL 的有效期由渠道决定。

参考环境模型列表中未确认 sora_video2 等旧名称可用，请使用 /v1/models 返回的模型 ID。