创建视频

POST/v1/videos

创建视频

OpenAI 兼容的视频生成接口。

参考文档: https://platform.openai.com/docs/api-reference/videos/create

请求体 multipart/form-data

modelstring

模型/风格 ID

示例: kling-v1

promptstring

文本描述提示词

示例: 宇航员站起身走了

imagestring

图片输入 (URL 或 Base64)

示例: https://example.com/image.jpg

durationnumber

视频时长（秒）

示例: 5

widthinteger

视频宽度

示例: 1280

heightinteger

视频高度

示例: 720

fpsinteger

视频帧率

示例: 30

seedinteger

随机种子

示例: 20231234

ninteger

生成视频数量

示例: 1

response_formatstring

响应格式

示例: url

userstring

用户标识

示例: user-1234

metadataobject

扩展参数 (如 negative_prompt, style, quality_level 等)

响应

200 成功创建视频任务

idstring必填

视频 ID

objectstring必填

对象类型

modelstring必填

使用的模型

statusstring必填

任务状态

progressinteger必填

进度百分比

created_atinteger必填

创建时间戳

secondsstring必填

视频时长

completed_atinteger

完成时间戳

expires_atinteger

过期时间戳

sizestring

视频尺寸

errorobject

OpenAI 视频错误信息

messagestring

错误信息

codestring

错误码

metadataobject

额外元数据

400 请求参数错误

errorobject

messagestring

错误信息

typestring

错误类型

paramstring可空