视频
POST /v1/videos 提交片段并返回 202 Accepted 与任务信封。视频是这套 API 里运行最久的东西——以分钟计，而不是秒——所以异步在这里不是不便，而是唯一可行的形状。
提交
curl https://hypit.video/v1/videos \
-H "Authorization: Bearer $HYPIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "bytedance/seedance-2",
"prompt": "a paper boat drifting down a rain gutter, camera tracking alongside",
"seconds": 5,
"resolution": "720p",
"aspect_ratio": "16:9"
}'{
"id": "job_2f81c0a4d3b57e9016ab24cf",
"status": "queued",
"kind": "video",
"model": "bytedance/seedance-2",
"progress": 0,
"created_at": 1787824589,
"dispatch_deadline_at": 1787825189
}请求体要点
| 字段 | 说明 |
|---|---|
| model | 必填，需支持 videos 端点 |
| prompt | 必填，画面描述 |
| seconds | 片段时长（字面量建议先用 hypit measure 估算台词） |
| resolution | 例如 480p / 720p / 1080p，影响倍率与积分 |
| aspect_ratio | 例如 16:9 / 9:16 |
| duration / 参考帧 | 部分模型支持首帧、参考视频等，取决于模型能力 |
生成前的成本检查
先读模型目录里该模型的 pricing.credits 与倍率表，再决定分辨率与时长——视频是积分消耗最大的模态。
FAQ
可以一次生成多段吗？
提交多个任务并行即可；注意并发与未完成任务数上限。
超时怎么办？
504 表示上游未及时响应，重试一次；持续失败就换模型或供应商。
能作为参考帧喂给别的步骤吗？
可以，生成结果可以作为下游媒体条目或参考。