视频接口¶
本节列出该能力下当前已实现的接口。
创建视频¶
POST /v1/videos
OpenAI 兼容的视频生成接口。
参考文档: https://platform.openai.com/docs/api-reference/videos/create
鉴权¶
- Bearer Token (
Authorization: Bearer <token>)
请求体¶
- Content-Type:
multipart/form-data
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | no | 模型名称 |
| prompt | string | no | 提示词 |
| seconds | string | no | 生成秒数 |
| input_reference | string | no | 参考图片文件 |
返回¶
| 状态码 | 说明 | Schema |
|---|---|---|
| 200 | 成功创建视频任务 | object |
| 400 | 请求参数错误 | ErrorResponse |
获取视频任务状态¶
GET /v1/videos/{task_id}
OpenAI 兼容的视频任务状态查询接口。
返回视频任务的详细状态信息。
鉴权¶
- Bearer Token (
Authorization: Bearer <token>)
参数¶
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| task_id | path | string | yes | 视频任务 ID |
返回¶
| 状态码 | 说明 | Schema |
|---|---|---|
| 200 | 成功获取视频任务状态 | object |
| 404 | 任务不存在 | ErrorResponse |
获取视频内容¶
GET /v1/videos/{task_id}/content
获取已完成视频任务的视频文件内容。
此接口会代理返回视频文件流。
鉴权¶
- Bearer Token (
Authorization: Bearer <token>)
参数¶
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| task_id | path | string | yes | 视频任务 ID |
返回¶
| 状态码 | 说明 | Schema |
|---|---|---|
| 200 | 成功获取视频内容 | string |
| 404 | 视频不存在或未完成 | ErrorResponse |
Kling 文生视频¶
POST /kling/v1/videos/text2video
使用 Kling 模型从文本描述生成视频。
支持的模型：kling-v1, kling-v1-5 等
鉴权¶
- Bearer Token (
Authorization: Bearer <token>)
请求体¶
- Content-Type:
application/json - Schema:
VideoRequest
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | no | 模型/风格 ID |
| prompt | string | no | 文本描述提示词 |
| image | string | no | 图片输入 (URL 或 Base64) |
| duration | number | no | 视频时长（秒） |
| width | integer | no | 视频宽度 |
| height | integer | no | 视频高度 |
| fps | integer | no | 视频帧率 |
| seed | integer | no | 随机种子 |
| n | integer | no | 生成视频数量 |
| response_format | string | no | 响应格式 |
| user | string | no | 用户标识 |
| metadata | object | no | 扩展参数 (如 negative_prompt, style, quality_level 等) |
返回¶
| 状态码 | 说明 | Schema |
|---|---|---|
| 200 | 成功创建视频生成任务 | VideoResponse |
| 400 | 请求参数错误 | ErrorResponse |
获取 Kling 文生视频任务状态¶
GET /kling/v1/videos/text2video/{task_id}
查询 Kling 文生视频任务的状态和结果。
鉴权¶
- Bearer Token (
Authorization: Bearer <token>)
参数¶
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| task_id | path | string | yes | 任务 ID |
返回¶
| 状态码 | 说明 | Schema |
|---|---|---|
| 200 | 成功获取任务状态 | VideoTaskResponse |
| 404 | 任务不存在 | ErrorResponse |
Kling 图生视频¶
POST /kling/v1/videos/image2video
使用 Kling 模型从图片生成视频。
支持通过 image 参数传入图片 URL 或 Base64 编码的图片数据。
鉴权¶
- Bearer Token (
Authorization: Bearer <token>)
请求体¶
- Content-Type:
application/json - Schema:
VideoRequest
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | no | 模型/风格 ID |
| prompt | string | no | 文本描述提示词 |
| image | string | no | 图片输入 (URL 或 Base64) |
| duration | number | no | 视频时长（秒） |
| width | integer | no | 视频宽度 |
| height | integer | no | 视频高度 |
| fps | integer | no | 视频帧率 |
| seed | integer | no | 随机种子 |
| n | integer | no | 生成视频数量 |
| response_format | string | no | 响应格式 |
| user | string | no | 用户标识 |
| metadata | object | no | 扩展参数 (如 negative_prompt, style, quality_level 等) |
返回¶
| 状态码 | 说明 | Schema |
|---|---|---|
| 200 | 成功创建视频生成任务 | VideoResponse |
| 400 | 请求参数错误 | ErrorResponse |
获取 Kling 图生视频任务状态¶
GET /kling/v1/videos/image2video/{task_id}
查询 Kling 图生视频任务的状态和结果。
鉴权¶
- Bearer Token (
Authorization: Bearer <token>)
参数¶
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| task_id | path | string | yes | 任务 ID |
返回¶
| 状态码 | 说明 | Schema |
|---|---|---|
| 200 | 成功获取任务状态 | VideoTaskResponse |
| 404 | 任务不存在 | ErrorResponse |
即梦视频生成¶
POST /jimeng/
即梦官方 API 格式的视频生成接口。
支持通过 Action 参数指定操作类型：
- CVSync2AsyncSubmitTask: 提交视频生成任务
- CVSync2AsyncGetResult: 获取任务结果
需要在查询参数中指定 Action 和 Version。
鉴权¶
- Bearer Token (
Authorization: Bearer <token>)
参数¶
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| Action | query | string | yes | API 操作类型 |
| Version | query | string | yes | API 版本 |
请求体¶
- Content-Type:
application/json
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| req_key | string | no | 请求类型标识 |
| prompt | string | no | 文本描述 |
| binary_data_base64 | array[string] | no | Base64 编码的图片数据 |
返回¶
| 状态码 | 说明 | Schema |
|---|---|---|
| 200 | 成功处理请求 | object |
| 400 | 请求参数错误 | ErrorResponse |
创建视频生成任务¶
POST /v1/video/generations
提交视频生成任务，支持文生视频和图生视频。
返回任务 ID，可通过 GET 接口查询任务状态。
鉴权¶
- Bearer Token (
Authorization: Bearer <token>)
请求体¶
- Content-Type:
application/json - Schema:
VideoRequest
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | no | 模型/风格 ID |
| prompt | string | no | 文本描述提示词 |
| image | string | no | 图片输入 (URL 或 Base64) |
| duration | number | no | 视频时长（秒） |
| width | integer | no | 视频宽度 |
| height | integer | no | 视频高度 |
| fps | integer | no | 视频帧率 |
| seed | integer | no | 随机种子 |
| n | integer | no | 生成视频数量 |
| response_format | string | no | 响应格式 |
| user | string | no | 用户标识 |
| metadata | object | no | 扩展参数 (如 negative_prompt, style, quality_level 等) |
返回¶
| 状态码 | 说明 | Schema |
|---|---|---|
| 200 | 成功创建视频生成任务 | VideoResponse |
| 400 | 请求参数错误 | ErrorResponse |
获取视频生成任务状态¶
GET /v1/video/generations/{task_id}
查询视频生成任务的状态和结果。
任务状态：
- queued: 排队中
- in_progress: 生成中
- completed: 已完成
- failed: 失败
鉴权¶
- Bearer Token (
Authorization: Bearer <token>)
参数¶
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| task_id | path | string | yes | 任务 ID |
返回¶
| 状态码 | 说明 | Schema |
|---|---|---|
| 200 | 成功获取任务状态 | VideoTaskResponse |
| 404 | 任务不存在 | ErrorResponse |