跳转到主要内容
Vidu Q2是生数科技发布的新一代多模态大模型，在语义理解、情绪表达、运动幅度、专业运镜等方面都有了全面升级，在影视动漫、广告电商、短剧、泛娱乐、文旅等行业中有更大、更深入的应用空间。 指令遵循更强，表情理解更细腻，运动幅度更灵活，运镜更连贯。

​
模型参数

  • 模型ID：viduq2/viduq2-turbo/viduq2-pro
  • 模型价格：你可以在模型广场查看最新价格信息
  • 调用入口：https://geekai.co/api/v1/videos/generations
  • 模型参数：参考视频 API 手册
  • API认证：获取 API KEY
不支持视频公共 API 中的以下参数：
  • size
  • quality
  • fps
附：ViduQ2 官方 API 文档
aspect_ratio 参数支持以下取值：
  • 1:1
  • 16:9
  • 9:16
  • 4:3
  • 3:4
resolution 分辨率参数，可选：540p、720p、1080p duration 默认为 5s,可选值：1-10s 支持通过 extra_body 传递额外可选参数来设置：
  • style: 风格，可选值: general（通用风格）、anime（动漫风格，仅在动漫风格表现突出）
  • movement_amplitude: 运动幅度默认 auto, 可选值: auto、small、medium、large
  • bgm: 是否为生成的视频添加背景音乐。默认: false, 可选值 true 、false, 传 true 时系统将从预设 BGM 库中自动挑选合适的音乐并添加；不传或为 false 则不添加 BGM
  • voice_id: 音色id,用来决定视频中的声音音色
  • wm_url: 水印内容,此处为图片URL
  • wm_position: 水印位置，表示水印出现在图片的位置
  • off_peak: 错峰模式，默认: false,可选值: true: 错峰生成视频; false: 即时生成视频
  • payload: 透传参数,不做任何处理，仅数据传输
  • meta_data: 元数据标识,json格式字符串,透传字段
以上字段参数类型和官方参数完全一致

​
模型价格

vidu q2系列 的价格按照模型，能力，生成视频的分辨率、时长来计算，以下是价格速算表：
能力模型分辨率价格（元/秒）
文生视频viduq2540p0.3125
viduq2720p0.46875
viduq21080p0.625
参考生视频viduq2540p0.46875
viduq2720p0.78125
viduq21080p2.34375
viduq2-pro540p0.625
viduq2-pro720p0.9375
viduq2-pro1080p2.65625
图生视频viduq2-turbo540p0.1875
viduq2-turbo720p0.25
viduq2-turbo1080p1.09375
viduq2-pro540p0.25
viduq2-pro720p0.46875
viduq2-pro1080p1.71875
首尾帧生视频viduq2-turbo540p0.1875
viduq2-turbo720p0.25
viduq2-turbo1080p1.09375
viduq2-pro540p0.25
viduq2-pro720p0.46875
viduq2-pro1080p1.71875
使用极客智坊提供的低价代理渠道调用时，不同参数对应价格按照价格表x对应的折扣值即可：以文生视频高可用速度优先渠道为例，折扣值是 0.8，那么生成 5 秒 720p 有声标准视频价格是 0.46875 x 5 x 0.8 = 1.875 元，其他参数依次类推。

​
文生视频

通过文字描述来生成对应视频： 
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "viduq2",
    "prompt": "以超写实的时尚摄影风格呈现，采用浅蓝与淡琥珀色调，身着宇航服的航天员漫步雾中。背景由迷人的白金光线构成，营造出极简静物与令人震撼的全景画面。",
    "duration": 5,
    "aspect_ratio": "16:9"
}'
响应是一个 JSON 对象，包含生成视频的 URL： 
{
    "model": "viduq2",
    "task_id": "72bc4fd2-3c43-4571-b72f-db3aad3096fb",
    "task_status": "succeed",
    "video_result": [
        {
            "id": "038a74c4-762a-47c1-a8ba-e0c5d950ab9c",
            "url": "https://static.geekai.co/video/2026/03/05/152c1175b4379ccab9c48b12b8f5a4a4.mp4"
        }
    ]
}
下面的图生视频等响应结果同上，不在列举。

​
图生视频

curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "viduq2-turbo",
    "prompt": "宇航员挥手致意，镜头缓缓上移",
    "images": "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png",
    "duration": 5,
    "with_audio": true
}'
viduq2-turbo和viduq2-pro支持图生视频

​
首尾帧

curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "viduq2-turbo",
    "prompt": "镜头拉近那只鸟，它随即向右飞去。鸟儿飞行姿态流畅自然，在天空中翱翔，身后随之环绕着红色光效。",
    "image": "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/startend2video-1.jpeg",
    "image_tail": "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/startend2video-2.jpeg",
    "duration": 5
}'
viduq2-turbo和viduq2-pro支持首尾帧生视频

​
参考生视频

curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "viduq2-pro",
    "prompt": "圣诞老人和熊在湖边拥抱。",
    "image": [
        "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-1.png",
        "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-2.png",
        "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-3.png"
    ],
    "duration": 4,
    "aspect_ratio": "4:3"
}'
viduq2和viduq2-pro支持参考生视频， duration: viduq2-pro：默认5秒，可选：0-10（0秒为自动判断时长）

​
异步任务

由于视频生成通常比较耗时，建议通过极客智坊提供的异步任务模式生成视频。 视频 API 中的 async 参数用于控制是否异步生成视频，默认为 false，表示创建视频接口会同步等待视频生成完毕并返回。如果设置为 true，则会异步生成视频并返回任务ID，你可以使用该任务ID轮询视频生成状态。 创建视频生成任务 
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "viduq2",
    "prompt": "以超写实的时尚摄影风格呈现，采用浅蓝与淡琥珀色调，身着宇航服的航天员漫步雾中。背景由迷人的白金光线构成，营造出极简静物与令人震撼的全景画面。",
    "duration": 5,
    "aspect_ratio": "16:9",
    "async": true,
    "extra_body": {
        "bgm": true
    }
}'
响应中会包含任务ID： 
{
    "model": "viduq2",
    "task_id": "371a39ff-d1a6-4990-8c7b-3dcc7e437861",
    "task_status": "pending"
}
查询视频生成结果 你可以使用返回的任务 ID 来查询生成状态和获取视频结果： 
curl --location --request GET 'https://geekai.co/api/v1/videos/{task_id}' \
--header 'Authorization: Bearer $GEEKAI_API_KEY'
你可以根据视频生成任务状态 task_status 值判断视频是否已经生成完成，这个状态值包括四种情况：
  • pending：任务已创建，等待处理
  • running：任务正在处理
  • succeed：任务成功完成，可以获取结果
  • failed：任务失败，可能是由于内容违规或其他错误
如果任务还在运行中，返回结果如下： 
{
    "model": "viduq2",
    "task_id": "371a39ff-d1a6-4990-8c7b-3dcc7e437861",
    "task_status": "running"
}
轮询视频生成结果接口直到任务状态值为 succeed，你就可以获取到生成的视频 URL： 
{
  "model": "viduq2",
  "task_id": "371a39ff-d1a6-4990-8c7b-3dcc7e437861",
  "task_status": "succeed",
  "video_result": [
    {
      "id": "30751061-18f8-41d7-8aa1-fea6415a5a01",
      "url": "https://static.geekai.co/video/2026/03/05/45abad7a92d050bfce23fb5768eee698.mp4"
    }
  ]
}