视频 API 接入说明

通过狼帧统一视频接口提交任务。下游只需要一个地址和一个 SK；不同上游的接口地址由后台自动适配，顾客无需选择上游尾巴。

统一 API 地址

https://www.vipprompt.cn/v1/videos

身份认证

Authorization: Bearer sk-lf-...

处理方式

统一提交 → 查询状态 → 获取视频

1. 提交视频任务

POST /v1/videos

curl -X POST "https://www.vipprompt.cn/v1/videos" \
  -H "Authorization: Bearer sk-lf-替换为你的 API 密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.5",
    "prompt": "电影感镜头，人物向前奔跑，镜头平稳跟随",
    "resolution": "720P",
    "ratio": "16:9",
    "duration": 5,
    "media": [{"type":"reference_image","url":"https://example.com/reference.jpg"}]
  }'

2. 查询任务

GET /v1/videos/tasks/{任务ID}

curl "https://vipprompt.cn/v1/videos/tasks/替换为任务ID" \
  -H "Authorization: Bearer sk-lf-替换为你的 API 密钥"

轮询直到状态为 succeeded 或 failed。成功后读取 video_url 或 download_url。

3. 参数说明

参数	必填	说明
`model`	是	填写已开通的下游模型名称；不要填写上游模型 ID 或接口路径
`prompt`	是	画面、动作和镜头描述
`resolution`	是	480P / 720P / 1080P，以模型支持范围为准
`ratio`	否	例如 16:9、9:16、1:1
`duration`	是	整数秒，以该模型支持范围为准
`media`	否	参考图片、视频、音频的公开 URL 数组

下游始终使用 POST /v1/videos 和 GET /v1/videos/tasks/{任务ID}。不要填写或拼接上游的 /v1/chat/completions、/v1/videos/generations 等路径；API 密钥只能保存在服务端，不要分享给其他人。