视频（Video）

生成视频
查询视频
OpenAI 视频 sora视频
Veo视频接口

生成视频

调用视频生成接口生成视频，支持多种视频生成服务：

可灵AI (Kling): API文档
即梦 (Jimeng): API文档

API 端点

POST /v1/video/generations

请求头

参数	类型	必填	描述
Authorization	string	是	用户认证令牌 (Bearer: sk-xxxx)
Content-Type	string	是	application/json

请求参数

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

请求示例

可灵AI 示例

curl https://$Burncloud_API_BaseUrl/v1/video/generations \
  --request POST \
  --header 'Authorization: ' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "kling-v1",
  "prompt": "一个穿着宇航服的宇航员在月球上行走, 高品质, 电影级",
  "size": "1920x1080",
  "image": "https://h2.inkwai.com/bs2/upload-ylab-stunt/se/ai_portal_queue_mmu_image_upscale_aiweb/3214b798-e1b4-4b00-b7af-72b5b0417420_raw_image_0.jpg",
  "duration": 5,
  "metadata": {
    "seed": 20231234,
    "negative_prompt": "模糊",
    "image_tail": "https://h1.inkwai.com/bs2/upload-ylab-stunt/1fa0ac67d8ce6cd55b50d68b967b3a59.png"
  }
}'

即梦AI 示例

curl https://$Burncloud_API_BaseUrl/v1/video/generations \
  --request POST \
  --header 'Authorization: ' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "jimeng_vgfm_t2v_l20",
  "prompt": "一个穿着宇航服的宇航员在月球上行走",
  "image": "https://h2.inkwai.com/bs2/upload-ylab-stunt/se/ai_portal_queue_mmu_image_upscale_aiweb/3214b798-e1b4-4b00-b7af-72b5b0417420_raw_image_0.jpg",
  "metadata": {
    "req_key": "jimeng_vgfm_i2v_l20",
    "image_urls": [
      "https://h2.inkwai.com/bs2/upload-ylab-stunt/se/ai_portal_queue_mmu_image_upscale_aiweb/3214b798-e1b4-4b00-b7af-72b5b0417420_raw_image_0.jpg"
    ],
    "aspect_ratio": "16:9"
  }
}'

Vidu 渠道示例

curl https://$Burncloud_API_BaseUrl/v1/video/generations \
  --request POST \
  --header 'Authorization: ' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "viduq1",
  "prompt": "一个穿着宇航服的宇航员在月球上行走, 高品质, 电影级",
  "size": "1920x1080",
  "image": "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png",
  "duration": 5,
  "metadata": {
    "duration": 5,
    "seed": 0,
    "resolution": "1080p",
    "movement_amplitude": "auto",
    "bgm": false,
    "payload": "",
    "callback_url": "https://your-callback-url.com/webhook"
  }
}'

响应格式

错误响应

400 - 请求参数错误

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

401 - 未授权

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

403 - 无权限

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

500 - 服务器内部错误

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

查询视频

根据任务ID查询视频生成任务的状态和结果

API 端点

GET /v1/video/generations/{task_id}

路径参数

参数	类型	必填	描述
task_id	string	是	任务ID

请求示例

curl 'https://$Burncloud_API_BaseUrl/v1/video/generations/{task_id}'

响应格式

200 - 成功响应

{
  "error": null,
  "format": "mp4",
  "metadata": {
    "duration": 5,
    "fps": 30,
    "height": 512,
    "seed": 20231234,
    "width": 512
  },
  "status": "succeeded",
  "task_id": "abcd1234efgh",
  "url": "string"
}

响应字段说明

字段	类型	描述
task_id	string	任务ID
status	string	任务状态（processing: 处理中, succeeded: 成功, failed: 失败）
format	string	视频格式
url	string	视频资源URL（成功时）
metadata	object	结果元数据
error	object	错误信息（成功时为null）

错误响应

400 - 请求参数错误

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

401 - 未授权

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

403 - 无权限

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

500 - 服务器内部错误

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

OpenAI 视频 sora视频

OpenAI 视频格式 API 文档

概述

调用OpenAI视频生成接口生成视频，支持 Sora 等模型，也支持使用 OpenAI 视频格式调用可灵，即梦和 vidu。

生成视频

API 端点

POST /v1/videos

请求头

参数	类型	必填	描述
Authorization	string	是	用户认证令牌 (Bearer: sk-xxxx)
Content-Type	string	是	multipart/form-data

请求参数

参数	类型	必填	描述
prompt	string	是	描述要生成视频的文本提示词
model	string	否	视频生成模型，默认为 sora-2
seconds	string	否	视频时长（秒），默认为 4 秒
size	string	否	输出分辨率，格式为宽度x高度，默认为 720x1280
input_reference	file	否	可选图片参考，用于指导生成

请求示例

curl https://ai.burncloud.com/v1/videos \
  -H "Authorization: Bearer sk-xxxx" \
  -F "model=sora-2" \
  -F "prompt=A calico cat playing a piano on stage" \
  -F "size=1280x720" \
  -F "seconds=8"

响应格式

200 - 成功响应

{
  "id": "video_123",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1712697600,
  "size": "1024x1808",
  "seconds": "8",
  "quality": "standard"
}

响应字段说明

字段	类型	描述
id	string	视频任务ID
object	string	对象类型，固定为 "video"
model	string	使用的模型名称
status	string	任务状态（queued: 排队中, processing: 处理中, completed: 完成, failed: 失败）
progress	integer	处理进度（0-100）
created_at	integer	创建时间戳
size	string	视频分辨率
seconds	string	视频时长（秒）
quality	string	视频质量

查询视频

根据任务ID查询视频生成任务的状态和结果

API 端点

GET /v1/videos/{video_id}

路径参数

参数	类型	必填	描述
video_id	string	是	视频任务ID

请求示例

curl 'https://ai.burncloud.com/v1/videos/video_123' \
  -H "Authorization: Bearer sk-xxxx"

响应格式

200 - 成功响应

{
  "id": "video_123",
  "object": "video",
  "model": "sora-2",
  "status": "completed",
  "progress": 100,
  "created_at": 1712697600,
  "size": "1024x1808",
  "seconds": "8",
  "quality": "standard",
  "url": "https://example.com/video.mp4"
}

响应字段说明

字段	类型	描述
id	string	视频任务ID
object	string	对象类型，固定为 "video"
model	string	使用的模型名称
status	string	任务状态（queued: 排队中, processing: 处理中, completed: 完成, failed: 失败）
progress	integer	处理进度（0-100）
created_at	integer	创建时间戳
size	string	视频分辨率
seconds	string	视频时长（秒）
quality	string	视频质量
url	string	视频下载链接（完成时）

获取视频任务状态

根据任务ID获取视频生成任务的详细信息

API 端点

GET /v1/videos/{video_id}

路径参数

参数	类型	必填	描述
video_id	string	是	要获取的视频任务标识符

请求示例

curl 'https://ai.burncloud.com/v1/videos/video_123' \
  -H "Authorization: Bearer sk-xxxx"

响应格式

200 - 成功响应

{
  "id": "video_123",
  "object": "video",
  "model": "sora-2",
  "status": "completed",
  "progress": 100,
  "created_at": 1712697600,
  "completed_at": 1712698000,
  "expires_at": 1712784400,
  "size": "1024x1808",
  "seconds": "8",
  "quality": "standard",
  "remixed_from_video_id": null,
  "error": null
}

响应字段说明

字段	类型	描述
id	string	视频任务的唯一标识符
object	string	对象类型，固定为 "video"
model	string	生成视频的模型名称
status	string	视频任务的当前生命周期状态
progress	integer	生成任务的近似完成百分比
created_at	integer	任务创建时的Unix时间戳（秒）
completed_at	integer	任务完成时的Unix时间戳（秒），如果已完成
expires_at	integer	可下载资源过期时的Unix时间戳（秒），如果已设置
size	string	生成视频的分辨率
seconds	string	生成视频片段的时长（秒）
quality	string	视频质量
remixed_from_video_id	string	如果此视频是混音，则为源视频的标识符
error	object	如果生成失败，则包含错误信息的对象

获取视频内容

下载已完成的视频内容

API 端点

GET /v1/videos/{video_id}/content

路径参数

参数	类型	必填	描述
video_id	string	是	要下载的视频标识符

查询参数

参数	类型	必填	描述
variant	string	否	要返回的可下载资源类型，默认为MP4视频

请求示例

curl 'https://ai.burncloud.com/v1/videos/video_123/content' \
  -H "Authorization: Bearer sk-xxxx" \
  -o "video.mp4"

响应格式

200 - 成功响应

直接返回视频文件流，Content-Type为 video/mp4

响应头说明

字段	类型	描述
Content-Type	string	视频文件类型，通常为 video/mp4
Content-Length	string	视频文件大小（字节）
Content-Disposition	string	文件下载信息

错误响应

400 - 请求参数错误

{
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error",
    "code": "invalid_parameter"
  }
}

401 - 未授权

{
  "error": {
    "message": "Invalid API key",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

403 - 无权限

{
  "error": {
    "message": "Insufficient permissions",
    "type": "permission_error",
    "code": "insufficient_permissions"
  }
}

429 - 请求频率限制

{
  "error": {
    "message": "Rate limit exceeded",
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded"
  }
}

500 - 服务器内部错误

{
  "error": {
    "message": "Internal server error",
    "type": "server_error",
    "code": "internal_error"
  }
}

Veo视频接口

curl --location 'https://csp.burncloud.com/v1/videos' \
--header 'Content-Type: application/json' \
--header 'Authorization: ••••••' \
--data '{
  "model": "veo-3",
  "prompt": "一只猫在钓鱼,周围有蝴蝶在飞",
  "size": "1280x720",
  "seconds": "8"
}'

视频（Video）

生成视频

API 端点

请求头

请求参数

请求示例

可灵AI 示例

即梦AI 示例

Vidu 渠道示例

响应格式

错误响应

400 - 请求参数错误

401 - 未授权

403 - 无权限

500 - 服务器内部错误

查询视频

API 端点

路径参数

请求示例

响应格式

200 - 成功响应

响应字段说明

错误响应

400 - 请求参数错误

401 - 未授权

403 - 无权限

500 - 服务器内部错误

OpenAI 视频 sora视频

OpenAI 视频格式 API 文档

目录

概述

生成视频

API 端点

请求头

请求参数

请求示例

响应格式

200 - 成功响应

响应字段说明

查询视频

API 端点

路径参数

请求示例

响应格式

200 - 成功响应

响应字段说明

获取视频任务状态

API 端点

路径参数

请求示例

响应格式

200 - 成功响应

响应字段说明

获取视频内容

API 端点

路径参数

查询参数

请求示例

响应格式

200 - 成功响应

响应头说明

错误响应

400 - 请求参数错误

401 - 未授权

403 - 无权限

429 - 请求频率限制

500 - 服务器内部错误

Veo视频接口

Veo视频接口