curl https://sub.vcnovb.cn/v1/videos/TASK_ID \
-H "Authorization: Bearer $VC_API_KEY"
curl --fail https://sub.vcnovb.cn/v1/videos/TASK_ID/content \
-H "Authorization: Bearer $VC_API_KEY" \
--output video.mp4
图像与视频 API
视频查询与下载
通过创建任务的同一把 API Key 查询视频状态，并在完成后保存视频。
GET
https://sub.vcnovb.cn
/
v1
/
videos
/
{id}
curl https://sub.vcnovb.cn/v1/videos/TASK_ID \
-H "Authorization: Bearer $VC_API_KEY"
curl --fail https://sub.vcnovb.cn/v1/videos/TASK_ID/content \
-H "Authorization: Bearer $VC_API_KEY" \
--output video.mp4
curl https://sub.vcnovb.cn/v1/videos/TASK_ID \
-H "Authorization: Bearer $VC_API_KEY"
curl --fail https://sub.vcnovb.cn/v1/videos/TASK_ID/content \
-H "Authorization: Bearer $VC_API_KEY" \
--output video.mp4
查询流程
- 保存创建响应中的 ID。不同模型可能放在
id、request_id或嵌套任务字段中，按实际响应读取。 - 使用同一 Key 和原分组查询，间隔数秒，长任务适当退避。
- 排队或处理中继续等待；确认完成后读取结果地址或调用内容接口。
- 明确失败时记录错误，核对任务日志及退款状态。
内容接口
支持内容下载的任务可调用GET /v1/videos/{id}/content，请求头需携带创建任务的 API Key。
如果任务返回可直接访问的结果链接，请及时下载。只向可信的 VC API 地址发送你的 Key，不要把鉴权头转发到任意结果 URL。