创建视频生成任务

创建视频生成任务

POST /v1/video/generations

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

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

请求头 (Headers)

参数名	类型	必选	描述	示例
Authorization	string	否	鉴权令牌	Bearer ********************

请求体 (Request Body)

Content-Type: application/json

字段	类型	必选	描述
model	string	否	模型/风格 ID
prompt	string	否	文本描述提示词
image	string	否	图片输入 (URL 或 Base64)
duration	number	否	视频时长（秒）
width	integer	否	视频宽度
height	integer	否	视频高度
fps	integer	否	视频帧率
seed	integer	否	随机种子
n	integer	否	生成视频数量
response_format	string	否	响应格式
user	string	否	用户标识
metadata	object	否	扩展参数 (如 negative_prompt, style, quality_level 等)

请求体示例

{
  "model": "kling-v1",
  "prompt": "宇航员站起身走了",
  "image": "https://example.com/image.jpg",
  "duration": 5,
  "width": 1280,
  "height": 720,
  "fps": 30,
  "seed": 20231234,
  "n": 1,
  "response_format": "url",
  "user": "user-1234",
  "metadata": {}
}

返回响应 (Responses)

200 - 成功创建视频生成任务

字段	类型	描述
task_id	string	任务 ID
status	string	任务状态

响应示例

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

400 - 请求参数错误

字段	类型	描述
error	object
error.message	string	错误信息
error.type	string	错误类型
error.param	string (nullable)	相关参数
error.code	string (nullable)	错误代码

响应示例

{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}