Appearance
视频接口
视频生成与任务查询接口。
所有路径相对于当前 API 站点域名。认证方式参见 认证与访问地址。
视频接口按模型选择已配置的渠道。只有该渠道启用、模型已开通且具备对应任务适配器时，请求才能成功；不同厂商格式的接口不能保证互通。请以控制台可用模型与当前渠道配置为准。
创建视频
POST /v1/videos
OpenAI 兼容的视频生成接口。 参考文档: https://platform.openai.com/docs/api-reference/videos/create
分类： 视频生成/Sora兼容格式
请求体
请求类型：multipart/form-data
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 否 | 模型名称 |
prompt | string | 否 | 提示词 |
seconds | string | 否 | 生成秒数 |
input_reference | string | 否 | 参考图片文件 |
响应
| 状态码 | 说明 |
|---|---|
200 | 成功创建视频任务 |
400 | 请求参数错误 |
获取视频任务状态
GET /v1/videos/{task_id}
OpenAI 兼容的视频任务状态查询接口。 返回视频任务的详细状态信息。
分类： 视频生成/Sora兼容格式
路径与查询参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
task_id | path | string | 是 | 视频任务 ID |
响应
| 状态码 | 说明 |
|---|---|
200 | 成功获取视频任务状态 |
404 | 任务不存在 |
获取视频内容
GET /v1/videos/{task_id}/content
获取已完成视频任务的视频文件内容。 此接口会代理返回视频文件流。
分类： 视频生成/Sora兼容格式
路径与查询参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
task_id | path | string | 是 | 视频任务 ID |
响应
| 状态码 | 说明 |
|---|---|
200 | 成功获取视频内容 |
404 | 视频不存在或未完成 |
即梦视频生成
POST /jimeng/
即梦官方 API 格式的视频生成接口。 支持通过 Action 参数指定操作类型： - CVSync2AsyncSubmitTask: 提交视频生成任务 - CVSync2AsyncGetResult: 获取任务结果 需要在查询参数中指定 Action 和 Version。
分类： 视频生成/即梦格式
路径与查询参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
Action | query | CVSync2AsyncSubmitTask / CVSync2AsyncGetResult | 是 | API 操作类型 |
Version | query | string | 是 | API 版本 |
请求体
请求类型：application/json
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
req_key | string | 否 | 请求类型标识 |
prompt | string | 否 | 文本描述 |
binary_data_base64 | string[] | 否 | Base64 编码的图片数据 |
示例：
json
{
"req_key": "jimeng_video_generation",
"prompt": "一只猫在弹钢琴"
}响应
| 状态码 | 说明 |
|---|---|
200 | 成功处理请求 |
400 | 请求参数错误 |
创建视频生成任务
POST /v1/video/generations
提交视频生成任务，支持文生视频和图生视频。 返回任务 ID，可通过 GET 接口查询任务状态。
分类： 视频生成
请求体
请求类型：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 等) |
示例：
json
{
"model": "your-video-model",
"prompt": "宇航员在月球上漫步",
"duration": 5,
"width": 1280,
"height": 720
}响应
| 状态码 | 说明 |
|---|---|
200 | 成功创建视频生成任务 |
400 | 请求参数错误 |
获取视频生成任务状态
GET /v1/video/generations/{task_id}
查询视频生成任务的状态和结果。 任务状态： - queued: 排队中 - in_progress: 生成中 - completed: 已完成 - failed: 失败
分类： 视频生成
路径与查询参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
task_id | path | string | 是 | 任务 ID |
响应
| 状态码 | 说明 |
|---|---|
200 | 成功获取任务状态 |
404 | 任务不存在 |