video-v1 视频模型 API

本文说明如何通过异步任务接口调用 video-v1 生成视频。接口支持文生视频、图生视频、任务状态轮询与 MP4 下载。

接口概览

项目	值
Base URL	https://api.opennave.top/v1
创建任务	POST /videos
查询任务	GET /videos/{task_id}
下载视频	GET /videos/{task_id}/content
认证	Authorization: Bearer YOUR_API_KEY
支持时长	5、10、15 秒

密钥安全

不要在浏览器前端直接使用真实 API Key。生产环境应由后端服务发起请求。

调用流程

1. 通过 POST /v1/videos 创建任务，并保存响应中的 id 或 task_id。
2. 每隔一段时间请求 GET /v1/videos/{task_id}。
3. 状态为 completed 时，从 GET /v1/videos/{task_id}/content 下载 MP4。
4. 状态为 failed、error 或 cancelled 时读取错误信息并停止重试。

queued、running、processing 均表示任务仍在生成。刚创建后若暂时找不到任务，请等待 15 至 30 秒再查询，不要立刻重复创建。

文生视频

文生视频使用 JSON 请求。duration 只能是 5、10、15，同时传递 seconds 时两个值应保持一致。

{
  "model": "video-v1",
  "prompt": "时长 15 秒，4K 60fps，电影级动态运镜，城市黄昏街头场景，地面积水镜面反光，车流动态光轨，霓虹灯光持续闪烁。",
  "duration": 15,
  "seconds": "15",
  "size": "3840x2160"
}

curl -X POST "https://api.opennave.top/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json; charset=utf-8" \
  -H "Accept: application/json" \
  --data-binary @payload.json

字段	类型	说明
model	string	固定填写 video-v1。
prompt	string	视频描述，使用 UTF-8 JSON 提交。
duration	number	推荐使用 5、10 或 15。
seconds	string	上游兼容字段，和 duration 保持一致。
size	string	输出尺寸，例如 3840x2160。

图生视频

图生视频同样使用 POST /v1/videos，但请求类型为 multipart/form-data。参考图通过 file 字段上传。

请求兼容性

multipart 图生请求只传 seconds，不要传 duration，否则上游可能因类型不匹配拒绝请求。

curl -X POST "https://api.opennave.top/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=video-v1" \
  -F "prompt=以参考图为首帧，生成10秒写实自然风格宠物视频。保持主体一致，动作自然流畅，无畸变。" \
  -F "seconds=10" \
  -F "aspect_ratio=16:9" \
  -F "size=1920x1080" \
  -F "file=@reference.png;type=image/png"

字段	类型	说明
model	表单字段	固定填写 video-v1。
prompt	表单字段	描述要保持的主体、动作和镜头。
file	文件	参考图，已验证 PNG。
seconds	表单字段	5、10 或 15。
aspect_ratio	表单字段	例如 16:9。
size	表单字段	例如 1920x1080，应与比例一致。

外部入口当前不提供 /v1/media/upload 和 /v1/media/generate；图生视频应使用上述 /v1/videos multipart 请求。

轮询与下载

curl "https://api.opennave.top/v1/videos/task_xxx" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

curl "https://api.opennave.top/v1/videos/task_xxx/content" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --output video-v1-output.mp4

中文编码与计费

中文提示词需以 UTF-8 JSON 提交，并在请求头使用 Content-Type: application/json; charset=utf-8。Windows PowerShell 建议先将 JSON 写为 UTF-8 文件，再使用 curl.exe --data-binary @payload.json 提交。

当前 video-v1 按每次创建任务固定计费。业务端应在提交前检查余额、生成业务订单号或幂等键，并在任务完成或失败前阻止同一订单重复创建。

查看 Seedance 2.0 视频 API