视频生成
视频生成是异步任务，不会立刻返回最终成片
视频任务是异步流程。创建任务后，后续查询、列表和取消都会回到原始渠道。任务在终态时会完成最终结算：成功按最终结果修正，失败或取消则退款。
和文本、图片不同，视频生成通常需要先创建任务，再轮询状态，最后获取结果。因此第一次接入时，重点不是立即拿到视频，而是先确认任务流程跑通。
请求特点
先创建任务，再查询结果
最常见用途
文生视频、创意短片、广告素材、镜头动画生成
推荐首测方式
先创建一个短时长任务，确认能拿到 task_id 和状态变化
第一次测试时建议按这个流程走
01
创建任务
先提交 prompt、时长、比例等参数，拿到 task_id。
02
记录任务 ID
后续查询、列表和取消，都会依赖这个任务 ID。
03
查询任务状态
轮询任务详情或任务列表，确认是否还在处理中。
04
获取最终结果
任务进入成功终态后，再读取返回的视频结果或输出地址。
POST
/v1/videos/generations创建任务
GET
/v1/videos/generations查询任务列表
GET
/v1/videos/generations/:task_id查询任务详情
DELETE
/v1/videos/generations/:task_id取消任务
创建视频任务示例
bashcurl https://api.wei.run/v1/videos/generations \
-H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.0",
"prompt": "A slow cinematic pan through a rainy neon alley",
"duration": 5,
"ratio": "16:9"
}'使用时请注意
- 视频接口通常不是同步返回最终内容，所以拿到 task_id 才算真正开始。
- 第一次测试建议把时长设短一些，便于更快验证整个创建 -> 查询 -> 完成流程。
- 如果任务失败或被取消，平台会按任务最终状态完成结算或退款。