OpenAI 兼容 API 手册

视频生成

统一的视频生成异步接口，覆盖 Sora、Veo、Seedance、Kling、Hailuo、Vidu、Wan 和 Grok Video。不同模型沿用各自的按任务或按秒计费方式，提交前返回费用预估。

POST /v1/videos/generations

Videos

curl https://api09.com/v1/videos/generations   -H "Authorization: Bearer sk-api09_xxx"   -H "Content-Type: application/json"   -d '{"model":"veo3.1-lite","prompt":"海豚跃出蓝色海面，电影镜头","duration":8,"aspect_ratio":"16:9","metadata":{"resolution":"720p"}}'

curl https://api09.com/v1/videos/generations/video_task_id   -H "Authorization: Bearer sk-api09_xxx"

请求字段

字段	类型	说明
model	string	必填；从 GET /v1/models 获取当前可用视频模型。
prompt	string	场景、主体、动作、镜头、风格与声音描述。
duration	integer	时长秒数；可用范围由模型决定，并参与按秒模型的费用预估。
aspect_ratio	string	常用 16:9、9:16、1:1；部分模型还支持 adaptive。
image_urls / reference_images	string[]	兼容参考图输入。
image_with_roles	object[]	显式声明 first_frame、last_frame 或 reference_image。
video_with_roles / audio_with_roles	object[]	支持参考视频或参考音频的模型可用。
resolution / mode	string	例如 480p、720p、1080p、4k，或 std / pro。
audio / generate_audio	boolean	控制是否生成同步音频；可能影响单价。
callback_url / trace_id	string	可选回调地址与业务追踪 ID。
metadata	object	模型专属参数，例如 generation_type、watermark、negative_prompt。

响应与计费

字段	类型	说明
id	string	视频任务 ID，可用于状态查询。
object	string	generation.task。
model	string	实际提交的模型名。
status	string	queued / in_progress / completed / failed。
progress	integer	任务进度 0-100。
creditsEstimate	number	按模型计费单位、时长、分辨率和音频选项计算的预估积分。
result.data[].url	string	完成后返回视频 URL；建议及时保存。

积分统一换算：1 USD = 200 积分。

生产检查

先调用 GET /v1/models 确认模型名

本地素材先上传换取 URL

按秒模型必须传正确 duration

网关会在渠道鉴权、模型缺失、限流或服务异常时自动尝试下一个同名模型渠道

上传视频查询视频任务