---
title: "视频生成接口"
method: POST
path: "/videos/generations"
tags: ["Video"]
---

# 视频生成接口

`POST /videos/generations`

基于文本提示/图片生成视频的接口，支持多种视频生成模型和参数配置。

## Request body

- object
  - `model` string, required — 视频模型
  - `prompt` string, required — 文本提示
  - `negative_prompt` string — 反向提示词，用来描述不希望在视频中看到的内容，可以对视频进行限制，仅支持该字段模型生效
  - `image` union
    - string — 视频首帧图片URL
    - string[] — 参考图片URL（仅适用于旧模型，新模型采用images字段替代，具体以模型示例文档为准）
  - `image_tail` string — 用于视频尾帧的图片URL，仅支持该字段模型生效
  - `images` string[] — 参考图片URL
  - `video` union
    - string — 待编辑视频URL
    - string[] — 参考视频URL
  - `audio` union
    - string — 音频URL
    - string[] — 参考音频URL
  - `with_audio` boolean — 是否带音效，仅支持音效的模型生效
  - `size` string — 视频尺寸，尺寸越大价格可能越高，不同平台支持的尺寸参数不同，请参考[创建视频API](https://docs.geekai.co/cn/api/video/generations)设置
  - `resolution` string — 视频分辨率，不同平台支持的分辨率参数不同，请参考[创建视频API](https://docs.geekai.co/cn/api/video/generations)设置
  - `aspect_ratio` string — 视频宽高比，默认为16:9，仅支持该字段模型生效
  - `quality` string — 视频质量，仅支持该字段模型生效，智谱清言支持 speed、quality 两个配置，可灵 AI 和 Google Veo3 支持 std、pro 两个配置，默认 std，kling-v3 开始支持 4k
  - `duration` integer — 视频时长(秒)，默认5秒(海螺默认6s）
  - `fps` 24 | 30 | 60 — 视频帧率，仅支持该字段模型生效
  - `watermark` boolean — 是否添加AI生成水印，默认为false，仅支持该字段模型生效
  - `async` boolean — 是否异步生成，默认false，即同步等待视频生成成功后返回生成结果，如果异步需要通过调用视频获取接口获取生成结果，推荐使用异步
  - `extra_body` object — 额外参数配置项，以适配不同视频模型的多样化配置
    - `draft` boolean — 是否生成样片，仅支持该字段模型生效
    - `return_last_frame` boolean — 是否返回最后一帧图片，仅支持该字段模型生效
    - `movement_amplitude` string — 运动幅度，仅支持该字段模型生效
    - `camera_strength` string — 镜头运动强度，仅支持该字段模型生效
    - `image_list` object[] — 用于视频生成的图片列表，支持图片URL/Base64编码，仅支持该字段模型生效
      - `image_url` string — 图片URL/Base64编码数据
      - `type` string — 帧类型，first_frame：首帧，end_frame：尾帧
    - `video_list` object[] — 用于视频生成的视频列表，支持视频URL，仅支持该字段模型生效
      - `video_url` string — 参考视频URL
      - `refer_type` string — 参考类型：feature（特征参考视频）或 base（待编辑视频）
      - `keep_original_sound` string — 是否保留原始音频，yes 保留，no 不保留
    - `element_list` object[] — 参考主体列表，基于主体库中主体的 ID 配置，仅支持该字段模型生效
      - `element_id` unknown
    - `voice_list` object[] — 生成视频时所引用的音色的列表，仅支持该字段模型生效
      - `voice_id` string — 音色ID
    - `multi_shot` boolean — 是否开启多镜头模式，仅支持该字段模型生效
    - `shot_type` string — 分镜方式，仅支持该字段模型生效
    - `multi_prompt` object[] — 多镜头模式下的分镜提示词列表，仅支持该字段模型生效
      - `index` integer — 分镜索引，从0开始
      - `prompt` string — 分镜提示词
      - `duration` string — 分镜时长(秒)
    - `camera_control` object — 镜头控制，仅支持该字段模型生效
      - `type` string — 预定义的运镜类型
      - `config` object — 运镜类型的配置参数
        - `horizontal` unknown
        - `vertical` unknown
        - `pan` unknown
        - `tilt` unknown
        - `roll` unknown
        - `zoom` unknown
    - `static_mask` string — 静态笔刷，仅支持该字段模型生效
    - `dynamic_masks` object[] — 动态笔刷，仅支持该字段模型生效
      - `mask` string — 运动笔刷涂抹的 mask 图片
      - `trajectories` object[] — 运动笔刷的轨迹点列表
        - `x` number — 轨迹点的 x 坐标
        - `y` number — 轨迹点的 y 坐标
    - `real_person_mode` boolean — 是否开启真人模式
  - `retries` integer — 自动重试次数

## Response `200`

成功响应

- object
  - `model` string, required — 使用的视频模型
  - `task_id` string, uuid, required — 任务ID
  - `task_status` 'pending' | 'running' | 'succeed' | 'failed', required — 任务状态
  - `video_result` object — 视频生成结果(仅在同步模式且生成成功时返回)
    - `id` string — 视频ID
    - `url` string, uri — 视频URL
    - `cover_image_url` string, uri — 封面图片URL
    - `duration` number — 实际视频时长(秒)
    - `revised_prompt` string — 增强后的提示文本
  - `error` object — 错误信息(仅在生成失败时返回)
    - `code` string — 错误代码
    - `message` string — 错误描述

## Other responses

- `400` — 参数验证错误
- `401` — 未授权
- `413` — 提示文本过长或图片过大
- `500` — 标准错误响应

---

[API](https://skmtc.dev/geekai/apis/api.md) · [All operations](https://skmtc.dev/geekai/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/geekai/api/revisions/2bf0c8f70a39/schema)