创建视频（文生视频）

POST

/v1/videos

注意：视频时长按模型ID生效，例如：gemini-veo-3.1-generate-preview-6s选择这个模型，视频时长为6秒

模型ID：

gemini-veo-3.1-generate-preview-4s

gemini-veo-3.1-generate-preview-6s

gemini-veo-3.1-generate-preview-8s

gemini-veo-3.1-generate-preview-ref-4s

gemini-veo-3.1-generate-preview-ref-6s

gemini-veo-3.1-generate-preview-ref-8s

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

{
    "model": "gemini-veo-3.1-generate-preview-ref-8s",
    "prompt": "一座由硬纸板和瓶盖搭建的微型城市，在夜晚焕发出生机。一列硬纸板火车缓缓驶过，小灯点缀其间，照亮前路。",
    "size": "1280x720"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.aiide.com/v1/videos' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "gemini-veo-3.1-generate-preview-ref-8s",
    "prompt": "一座由硬纸板和瓶盖搭建的微型城市，在夜晚焕发出生机。一列硬纸板火车缓缓驶过，小灯点缀其间，照亮前路。",
    "size": "1280x720"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "id": "task_ZEUnSG0WKI0OxxcSeZOLAW9xnOmwhzK7",
    "task_id": "task_ZEUnSG0WKI0OxxcSeZOLAW9xnOmwhzK7",
    "object": "video",
    "model": "gemini-veo-3.1-generate-preview-ref-8s",
    "status": "queued",
    "progress": 0,
    "created_at": 1778838398,
    "size": "1280x720"
}

🟠429限流

🟠400请求有误

修改于 2026-05-28 02:05:32

获取视频生成任务状态

创建视频（参考图-图生视频）