任务与输出

视频生成通常走异步任务：提交请求后先返回任务 ID，生成完成后再获取视频内容。

任务状态

不同兼容入口可能返回不同字段名，但业务侧应统一保存：task_id、model、status、progress、created_at、completed_at、error。

/v1/videos/{task_id} 返回 OpenAI video object 风格；/v1/video/generations/{task_id} 返回 Tapapi 任务兼容风格。两者状态含义可以统一到业务状态机，但响应字段不要混用。

示例：

curl https://tapapi.ai/v1/videos/task_xxx \
  -H "Authorization: Bearer $TAPAPI_API_KEY"

可能返回：

{
  "id": "task_xxx",
  "object": "video",
  "model": "your-video-model",
  "status": "in_progress",
  "progress": 42,
  "seconds": "5"
}

任务完成后，可以通过内容路径获取视频流：

curl https://tapapi.ai/v1/videos/task_xxx/content \
  -H "Authorization: Bearer $TAPAPI_API_KEY" \
  -o output.mp4

业务侧建议立刻把视频转存到自己的对象存储，并记录：

task_id | model | status | output_url | saved_url | quota | created_at | completed_at | request_id

视频生成成功后，如果你的下载、转存或 CDN 上传失败，通常不等于模型生成失败。对账时要区分“模型任务失败”和“业务保存失败”。

视频任务可能先预扣，再按最终结果结算：

最终以控制台用量记录、任务日志和模型计费规则为准。

提交视频问题时请带上：