AI 大模型推理 > API 文档 > 视频生成 (video)

视频生成 (video)

最近更新时间: 2025-10-23 15:24:13

Base URL: https://openai.qiniu.com
Base URL（备）: https://api.qnaigc.com

Authentication

HTTP Authentication, scheme: bearer

POST 视频生成

POST /v1/videos/generations

Body 请求参数

{
  "instances": [
    {
      "prompt": "根据图片内容生成有趣的视频",
      "image": {
        "bytesBase64Encoded": "",
        "uri": "http://example.com/example.jpeg",
        "mimeType": "image/jpeg"
      }
    }
  ],
  "parameters": {
    "generateAudio": true,
    "durationSeconds": 8,
    "sampleCount": 1
  },
  "model": "veo-3.0-fast-generate-preview"
}

请求参数

名称	位置	类型	必选	说明
Authorization	header	string	是	none
Content-Type	header	string	是	none
body	body	object	否	none
» instances	body	[object]	是	none
»» prompt	body	string	否	文本转视频功能必需的参数，可以是对输入图片的内容提示以及将图片转换为视频的提示。
»» image	body	object	否	输入图片信息，用于指导视频生成
»»» bytesBase64Encoded	body	string	否	图片文件的字节 Base64 编码字符串（该字段和 `uri` 字段二者填其一）
»»» uri	body	string	否	图片文件的可以公开访问的 URL 地址（该字段和 `bytesBase64Encoded` 字段二者填其一）
»»» mimeType	body	string	是	图片的 MIME 类型，目前支持 image/jpeg、image/png 两种类型，请与真实的图片数据描述相符。
» parameters	body	object	是	视频生成的指导参数
»» generateAudio	body	boolean	否	是否生成音频（生成的音频内容合成在结果视频中），其中 veo-2.0-generate-001 模型不支持该参数
»» durationSeconds	body	integer	是	生成的视频文件的时长，目前仅支持 8S，该字段可以填写 `8`
»» sampleCount	body	integer	是	输出视频数量，支持的范围是 1~4
»» resolution	body	string	否	所生成视频的分辨率，目前仅 Veo 3 模型支持。可接受的值为 `720p`（默认值）或 `1080p`
»» aspectRatio	body	string	是	指定所生成视频的宽高比
»» seed	body	integer	是	请求的数字，以使生成的视频具有确定性。在请求中添加种子编号而不更改其他参数会导致模型生成相同的视频；支持的范围为 0 ~ 4294967295
»» negativePrompt	body	string	是	一个文本字符串，用于描述您不希望模型生成的内容
»» personGeneration	body	string	是	用于控制是否允许人物或人脸生成的安全设置
» model	body	string	是	指定生成模型

部分参数详细说明

aspectRatio: 指定所生成视频的宽高比，接受的值如下：

16:9（默认值）
9:16（其中 veo-3.0-generate-preview 暂不）

negativePrompt: 一个文本字符串，用于描述您不希望模型生成的内容；例如：

偏灰暗镜头
人物、动物
多辆汽车、风

personGeneration: 用于控制是否允许人物或人脸生成的安全设置；支持如下选项：

allow_adult（默认值）：仅允许生成成年人
dont_allow：禁止在图片中包含人物/人脸

model: 目前支持的模型如下：

veo-2.0-generate-001
veo-3.0-generate-001
veo-3.0-fast-generate-001
veo-3.0-generate-preview
veo-3.0-fast-generate-preview
veo-3.1-generate-preview
veo-3.1-fast-generate-preview

返回示例

200 Response

{
  "id": "videos-1756376552064908294-1383010573"
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» id	string	true	none		视频生成的任务ID，可用于后续查询视频生成任务的结果。

GET 查询视频生成结果

GET /v1/videos/generations/{id}