跳转到主要内容
相比上一版本，可灵视频 3.0 音画同步升级，主体一致性增强，支持多镜头叙事。 在可灵视频 O1 和可灵视频 2.6 的基础之上，可灵 3.0 系列模型基于深度融合的统一模型训练框架，实现了更原生的多模态输入和输出，将音画同步能力和主体一致性控制能力融合，并且突破了时长限制。 在支持更长视频生成（15s）的同时，可灵 3.0 系列模型支持原生直出音画，并实现了高度灵活的分镜控制能力与更精准的语义响应精度，为 AI 影像内容注入生命力，整体画面真实感显著提升，人物演绎更具表演张力。 可灵视频 3.0 模型能力对比概览

​
模型参数

  • 模型ID：kling-video-v3
  • 模型价格：你可以在模型广场查看最新价格信息
  • 调用入口：https://geekai.co/api/v1/videos/generations
  • 模型参数：参考视频 API 手册
  • API认证：获取 API KEY
不支持视频公共 API 中的以下参数：
  • size
  • fps
附：可灵视频 3.0 官方 API 文档
aspect_ratio 参数支持以下取值：
  • 1:1
  • 16:9
  • 9:16
支持通过 quality 参数替代官方的 mode 参数来控制生成视频的分辨率，quality 的取值范围是 std（对应 720p）、 pro（对应 1080p）和 4k（v3开始支持），默认值是 std，不同质量的视频生成时间和成本不同。 支持通过 with_audio 参数替代官方的 sound 参数来控制是否生成带有音频的视频，with_audio 的取值范围是 true 和 false，默认值是 false，生成带有音频的视频会增加生成时间和成本。 支持通过 watermark 参数替代官方的 watermark_info 参数来控制生成视频是否带有水印，watermark 的取值范围是 true 和 false，默认值是 false。 可灵视频 3.0 的 duration 参数支持生成 3-15s 的视频，默认值是 5s，生成更长时长的视频会增加生成时间和成本。 支持通过 extra_body 传递额外参数来设置视频分镜、参考主体和音色等信息：
  • multi_shot： 控制是否开启分镜，取值范围是 true 和 false，默认值是 false，开启多镜头模式后，可以通过 shot_type 参数来指定分镜类型。
  • shot_type： 指定分镜类型，取值范围是 customize 和 intelligence，分别代表自定义分镜和智能分镜， 当 multi_shot 为 true 时本参数必填。
  • multi_prompt： 描述每个分镜的信息，如提示词、时长等，当 multi_shot 为 true 且 shot_type 为 customize 时，本参数必填。
  • element_list： 参考主体列表，基于主体库中主体的 ID 配置，最多支持3个。
  • voice_list： 生成视频时所引用的音色的列表，基于定制音色ID进行设置，最多支持2个，element_list 与 voice_list 互斥，不能共存。
  • camera_control: 控制相机运动的条款（如不指定，模型将根据输入的文本/图片智能匹配）。
  • static_mask: 静态笔刷涂抹区域（用户通过运动笔刷涂抹的 mask 图片）。
  • dynamic_masks: 动态笔刷配置列表。
以上字段参数类型和官方参数完全一致： 可灵视频 3.0 分镜参数说明

​
模型价格

可灵视频 3.0 的价格按照生成视频的质量、时长和是否带有音频来计算，以下是价格表：
模型质量声音价格（单位：元/秒）
可灵视频3.0标准（std）无声0.6
可灵视频3.0标准（std）有声0.9
可灵视频3.0高品质（pro）无声0.8
可灵视频3.0高品质（pro）有声1.2
可灵视频3.0超高清（4k）无声3.0
可灵视频3.0超高清（4k）有声3.0
使用极客智坊提供的低价代理渠道调用时，不同参数对应价格按照价格表x对应的折扣值即可：以高可用速度优先渠道为例，折扣值是 0.8，那么生成 5 秒无声标准视频价格是 0.6 x 5 x 0.8 = 2.4 元，其他参数依次类推。

​
文生视频

通过文字描述来生成对应视频： 
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model":"kling-video-v3",
    "prompt":"广角跟踪镜头：一辆影青色的双门轿跑在沙漠公路上行驶，热浪扭曲清晰可见，头顶烈日高悬"
}'
响应是一个 JSON 对象，包含生成视频的 URL： 
{
    "model": "kling-video-v3",
    "task_id": "2047e9ae-e369-42b9-8b1b-8a030dedd86c",
    "task_status": "succeed",
    "video_result": [
        {
            "id": "6fe5f026-d171-4d5d-9113-e95f65dc5aa7",
            "url": "https://static.geekai.co/video/2026/02/27/e31df3d32e0242211dc20ff5b7f66289.mp4"
        }
    ]
}

​
图生视频

首帧 通过 image 传入单图即可实现基于首帧生成视频： 
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "kling-video-v3",
    "prompt": "无人机以极快速度穿越复杂障碍或自然奇观，带来沉浸式飞行体验",
    "image": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_i2v.png",
    "async": true
}'
首尾帧 通过 image + image_tail 传入首尾两张图即可实现基于首尾帧生成视频： 
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "kling-video-v3",
    "prompt": "图中女孩对着镜头说\"茄子\"，360度环绕运镜",
    "image": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_first_frame.jpeg",
    "image_tail": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_last_frame.jpeg",
    "async": true
}'
图片要求：
  • 支持 JPG、PNG、WEBP 格式，单张图片大小不超过 10MB；
  • 支持 URL 和 Base64 两种方式传入图片，URL 方式需要保证图片可以被公网访问；
  • 图片宽高尺寸不小于 300px，图片宽高比介于 1:2.5 ~ 2.5:1 之间；
  • image 参数与 image_tail 参数至少二选一，二者不能同时为空。

​
视频分镜

可灵视频 3.0 支持通过 extra_body 参数来控制分镜能力，以下是一个多镜头图生视频示例： 
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model":"kling-video-v3",
    "prompt":"她转身一笑，然后缓缓走出画面",
    "image":"https://static.geekai.co/storage/2025/11/14/woman_skyline_original_720p.jpeg",
    "duration": 8,
    "extra_body": {
        "multi_shot": true,
        "shot_type": "customize",
        "multi_prompt": [
            {
                "index": 1,
                "prompt": "第一镜头：她转身一笑",
                "duration": "3"
            },
            {
                "index": 2,
                "prompt": "第二镜头：她缓缓走出画面",
                "duration": "5"
            }
        ]
    },
    "async": true
}'

​
异步任务

由于视频生成通常比较耗时，建议通过极客智坊提供的异步任务模式生成视频。 视频 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":"kling-video-v3",
    "prompt":"她转身一笑，然后缓缓走出画面",
    "image":"https://static.geekai.co/storage/2025/11/14/woman_skyline_original_720p.jpeg",
    "duration": 15,
    "quality": "pro",
    "with_audio": true,
    "async": true
}'
响应中会包含任务ID： 
{
    "model": "kling-video-v3",
    "task_id": "77e3772b-4e92-4fce-a24c-63907585689d",
    "task_status": "pending"
}
查询视频生成结果 你可以使用返回的任务 ID 来查询生成状态和获取视频结果： 
curl --location --request GET 'https://geekai.co/api/v1/videos/77e3772b-4e92-4fce-a24c-63907585689d' \
--header 'Authorization: Bearer $GEEKAI_API_KEY'
你可以根据视频生成任务状态 task_status 值判断视频是否已经生成完成，这个状态值包括四种情况：
  • pending：任务已创建，等待处理
  • running：任务正在处理
  • succeed：任务成功完成，可以获取结果
  • failed：任务失败，可能是由于内容违规或其他错误
如果任务还在运行中，返回结果如下： 
{
    "model": "kling-video-v3",
    "task_id": "77e3772b-4e92-4fce-a24c-63907585689d",
    "task_status": "running"
}
轮询视频生成结果接口直到任务状态值为 succeed，你就可以获取到生成的视频 URL： 
{
    "model": "kling-video-v3",
    "task_id": "77e3772b-4e92-4fce-a24c-63907585689d",
    "task_status": "succeed",
    "video_result": [
        {
            "url": "https://static.geekai.co/video/2025/10/14/6c6b8c475899a1c82bcd59a84e78ab46.mp4"
        }
    ]
}