跳转到主要内容
POST
/
v1
/
video
/
generations
curl --request POST \
  --url https://api.getinfinityblue.com/v1/video/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kling-v2-5-turbo",
  "prompt": "宇航员在月球上漫步，地球在背景中缓缓升起，电影感镜头，4K 超清",
  "duration": 5,
  "width": 1280,
  "height": 720
}
'
{
  "task_id": "abcd1234efgh",
  "status": "queued"
}

​
可用模型

在 model 中传入视频生成模型 ID，例如：
模型 ID说明
kling-v2-5-turboKling 最新 Turbo 版，速度与质量平衡
kling-v2-1-masterKling 旗舰 Master 版，最高画质
veo_3_1Google Veo 3.1，顶级视频质量
veo_3_1-fastGoogle Veo 3.1 快速版，成本更低

​
调用流程

  1. POST /v1/video/generations — 提交任务，获取 task_id
  2. GET /v1/video/generations/{task_id} — 轮询，直到 status=completed
  3. 读取响应中的 url 字段下载视频文件

​
图生视频

设置 image 字段（URL 或 Base64）即可触发图生视频模式， 模型将把图片中的内容动态化。

​
扩展参数

对部分模型，metadata 中可传入 negative_prompt、style、quality_level 等模型特有参数；具体支持的字段因模型而异，请参阅对应模型文档。

授权

​
Authorization
string
header
必填

使用 Bearer Token 认证，格式：Authorization: Bearer sk-xxxxxx。 在 控制台 获取 API Key。

请求体

application/json

通用视频生成请求。

​
model
string
必填

模型 ID。支持 Kling、Veo 等多厂商视频模型。 例如 kling-v2-5-turbo、kling-v2-1-master、veo_3_1、veo_3_1-fast。

示例:

"kling-v2-5-turbo"

​
prompt
string
必填

文本描述提示词，描述视频内容、场景、镜头语言、风格等。

示例:

"宇航员在月球上漫步，地球在背景中缓缓升起，电影感镜头"

​
image
string

参考图片，URL 或 Base64 Data URI。设置后触发图生视频模式， 模型将把图片内容动态化。

示例:

"https://example.com/image.jpg"

​
duration
number

视频时长，单位秒。

示例:

5

​
width
integer

视频宽度（像素）。

示例:

1280

​
height
integer

视频高度（像素）。

示例:

720

​
fps
integer

视频帧率（fps）。

示例:

30

​
seed
integer

随机种子。传入相同的种子和参数时，生成结果更接近。

示例:

20231234

​
n
integer

生成视频数量。异步任务建议为 1。

示例:

1

​
response_format
string

响应格式，建议使用 url。

示例:

"url"

​
user
string

终端用户标识，用于业务侧审计和风控，不参与生成。

示例:

"user-1234"

​
metadata
object

扩展参数，可传入模型特有的参数，如 negative_prompt、style、 quality_level 等。具体支持的字段因模型而异。

响应

成功创建视频生成任务

通用视频生成任务提交响应。

​
task_id
string

任务 ID，用于后续轮询状态。

示例:

"abcd1234efgh"

​
status
string

初始任务状态，通常为 queued。

示例:

"queued"