创建视频生成任务¶

提交视频生成任务，支持文生视频和图生视频。

返回任务 ID，可通过 GET 接口查询任务状态。

OpenAPI 摘要¶

创建视频生成任务¶

项目	值
方法	`POST`
路径	`/v1/video/generations`
Operation ID	`createvideogeneration`
标签	视频（Videos）

提交视频生成任务，支持文生视频和图生视频。

返回任务 ID，可通过 GET 接口查询任务状态。

认证¶

名称	类型	方案	说明
`BearerAuth`	http	bearer	使用 Bearer Token 认证。格式: `Authorization: Bearer sk-xxxxxx`

请求体¶

必填: 是

application/json¶

字段	类型	必填	说明
model	string	否	模型/风格 ID 示例: `kling-v1`
prompt	string	否	文本描述提示词示例: `宇航员站起身走了`
image	string	否	图片输入 (URL 或 Base64) 示例: `https://example.com/image.jpg`
duration	number	否	视频时长（秒）示例: `5`
width	integer	否	视频宽度示例: `1280`
height	integer	否	视频高度示例: `720`
fps	integer	否	视频帧率示例: `30`
seed	integer	否	随机种子示例: `20231234`
n	integer	否	生成视频数量示例: `1`
response_format	string	否	响应格式示例: `url`
user	string	否	用户标识示例: `user-1234`
metadata	object	否	扩展参数 (如 negative_prompt, style, quality_level 等)

调用案例¶

curl -X POST "https://你的newapi服务器地址/v1/video/generations" \
  -H "Authorization: Bearer $NEWAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-4o",
  "prompt": "A cute baby sea otter wearing a beret.",
  "image": "https://example.com/image.png",
  "duration": 5,
  "width": 1280,
  "height": 720
}'

成功响应示例¶

{
  "task_id": "task_123456",
  "status": "queued"
}

响应¶

HTTP 200¶

成功创建视频生成任务

application/json¶

字段	类型	必填	说明
task_id	string	否	任务 ID 示例: `abcd1234efgh`
status	string	否	任务状态示例: `queued`

HTTP 400¶

请求参数错误

application/json¶

字段	类型	必填	说明
error	object	否
error.message	string	否	错误信息
error.type	string	否	错误类型
error.param	string \| null	否	相关参数
error.code	string \| null	否	错误代码

OpenAPI 源文件¶

openapi/generated/ai-model/视频（Videos）/post-v1-video-generations-createvideogeneration-383844576.json