视频生成流程
视频 API 调用分三步:创建任务、查询状态、获取视频。三个请求使用同一个 API Key。模型参数见视频模型参数。
1. 创建任务
调用 POST /v1/videos,传入模型 ID、提示词和对应参数:
curl --request POST https://api.popgo.site/v1/videos \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"YOUR_MODEL","prompt":"A calm seaside landscape"}'
保存响应中的 id,后续查询和获取视频时使用。
创建请求超时时:
- 已收到
id:继续查询原任务,不要重复创建。 - 未收到
id:先不要重试。保留响应头X-Oneapi-Request-Id(如已收到)、请求时间和模型名,联系平台查询。当前无法通过请求编号自助找回任务。
2. 查询任务
调用 GET /v1/videos/{task_id}:
curl https://api.popgo.site/v1/videos/YOUR_TASK_ID \
-H "Authorization: Bearer YOUR_API_KEY"
queued 表示排队中,in_progress 表示生成中,completed 表示完成,failed 表示失败。失败时查看 error。
3. 获取视频
任务完成后,统一调用 GET /v1/videos/{task_id}/content 获取视频,使用同一个 PopGo API Key:
curl --fail --location \
https://api.popgo.site/v1/videos/YOUR_TASK_ID/content \
-H "Authorization: Bearer YOUR_API_KEY" \
--output video.mp4
只向 https://api.popgo.site 发送 PopGo API Key。响应中的 video_url 或 metadata.url 也可作为普通链接尝试播放或下载,但可能过期。不要向这些链接发送 PopGo API Key。 无法直接访问时,使用上面的内容接口。
视频编辑(仅限支持的模型)
视频编辑沿用上面的创建、查询和获取流程。时长统一使用 seconds,图片、视频和音频素材分别使用 reference_images、reference_videos、reference_audios;具体取值和素材要求以对应模型参数为准。