视频生成

视频生成是异步任务。先创建任务，再轮询状态；只有 completed 后才下载内容。

端点

操作	方法与路径
创建	POST /v1/video/generations
查询	GET /v1/video/generations/{task_id}
下载	GET /v1/videos/{task_id}/content

创建请求至少包含 model 和 prompt。duration、seconds、image(s)、size 与 metadata 是否可用取决于所选模型；不要假设不同视频模型共享参数。

curl https://api.nexinfer.com/v1/video/generations \
  -H "Authorization: Bearer $NEXINFER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "A calm ocean at sunrise",
    "duration": 4,
    "metadata": {"resolution": "720P"}
  }'

返回中的 id 是 NexInfer 公开任务 ID。状态可能为 queued、in_progress、completed 或 failed。轮询应有间隔和总超时；失败任务不要自动无限重试。

网络中断与结算

• 已拿到任务 ID 后，客户端断线不会取消异步任务；恢复后继续轮询同一个 ID。
• 创建连接在返回 ID 前中断时，任务结果属于未知状态。保留请求 ID，先查用量或联系支持，不要直接重复提交同一个付费任务。
• 成功任务按模型供应商返回的 total_tokens 结算；任务最终进入 failed 或平台任务超时后，退回预扣额度。
• 客户端本地轮询超时或临时网络异常不等于模型任务失败，也不会单独触发退款；应在业务超时范围内继续查询。

视频输入必须在 metadata.content 中明确标记 role: "reference_video"：

{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "自然延续这个视频",
  "duration": 4,
  "metadata": {
    "resolution": "720P",
    "content": [{
      "type": "video_url",
      "role": "reference_video",
      "video_url": {"url": "https://example.com/input.mp4"}
    }]
  }
}

当前验证边界

无视频输入 480P/720P/1080P/4K 和有视频输入 720P/1080P/4K 已生成有效 MP4，六档 Token 计费与火山账单一致。测试请求 duration=4 时实际视频约 5 秒；图片/音频混合参考、视频编辑与延长尚未验证。