​
国产视频模型

国产视频模型提供统一的 OpenAI 兼容接口,支持文生视频、图生视频、首尾帧生视频、动作控制、数字人、对口型等多种生成模式。

​
快速开始

视频生成

POST /v1/videos,提交国产视频任务,支持多种生成场景。

任务查询

GET /v1/videos/{task_id},查询任务状态与结果。

​
模型家族

​
热门模型

模型系列代表模型特色能力
即梦jimeng-video-3.0文生、图生、首尾帧生视频
Viduviduq3-pro音视频直出、背景音乐、错峰模式
KlingKling-3.0-Omni动作控制、数字人、对口型、模板特效

​
完整模型列表

基础模型：
  • Vidu-*、Kling-*、GV-*、OS-*
  • Hunyuan-*、Mingmou-*、Hailuo-*
  • SV-*、JV-*、jimeng-video-*
组合计费模型：
  • vidu-q2-pro-reference-1080p-offpeak
  • kling-3.0-omni-1080p-ref-audio
  • kling-2.6-motion-pro-1080p
  • kling-avatar-720p
  • sv-1.5-pro-1080p-audio

​
接入方式

国产视频模型统一使用以下接口：
操作接口说明
创建任务POST /v1/videos提交视频生成任务
查询状态GET /v1/videos/{task_id}查询任务进度与状态
获取内容GET /v1/videos/{task_id}/content获取视频下载地址
注意：不同模型系列可能提供多套接入方式。
  • Vidu：官方格式 (/vidu/ent/v2/*)、OpenAI 格式 (/v1/videos)、统一视频 (/v1/video/create)
  • 即梦：OpenAI 格式 (/v1/videos)、统一视频 (/v1/video/create)、豆包渠道
  • Kling：OpenAI 格式 (/v1/videos)
本页面主要介绍 OpenAI 兼容接口的通用规范，各模型特有接口请参阅下方模型文档。

​
请求参数

​
图片输入说明

不同接入方式使用不同的图片字段：
接入方式字段名格式说明
OpenAI 格式 (multipart)input_referencefile文件上传
OpenAI 格式 (JSON)imagestring图片 URL
统一视频imagesarray图片 URL 数组

​
基础字段

字段类型必填说明
modelstring✅模型名称,支持基础模型或组合计费模型
promptstring✅提示词,生成视频的文本描述
secondsstring❌视频时长,例如 5、10、15
sizestring❌快速尺寸输入,例如 720x1280
imagestring❌参考图片 URL(图生视频场景)
imagesarray❌参考图片数组(首尾帧场景)
input_referencefile❌参考文件(OpenAI 格式上传)
metadataobject❌扩展参数,建议放上游原生配置

​
metadata 扩展参数

场景类型：
场景值说明
动作控制motion_control精确控制视频动作
数字人生成avatar_i2v生成数字人视频
对口型lip_sync音画同步对口型
模板特效template_effect应用模板特效
输出配置 (metadata.output_config)：
字段类型说明
resolutionstring分辨率:720P、1080P
aspect_ratiostring画幅比例:16:9、9:16、1:1
durationinteger时长(秒)
audio_generationstring音频生成:Enabled、Disabled
其他常用字段：
  • motion_level：运动等级(std/pro)
  • offpeak：是否错峰计费
  • last_frame_url：首尾帧中的尾帧
  • video_url：参考视频 URL
  • file_infos：原生 FileInfos 透传
  • ext_info：原生 ExtInfo 字符串透传

​
参数优先级

​
时长参数

  1. 顶层 seconds
  2. 顶层 duration
  3. metadata.seconds / metadata.duration / metadata.video_duration
  4. 默认 5

​
分辨率参数

  1. metadata.output_config.resolution
  2. 顶层 size
  3. 模型默认值

​
场景示例

​
文生视频

{
  "model": "Kling-3.0-Omni",
  "prompt": "赛博朋克城市夜景,镜头慢慢推进",
  "seconds": "5",
  "metadata": {
    "output_config": {
      "resolution": "720P",
      "aspect_ratio": "16:9"
    }
  }
}

​
图生视频

{
  "model": "viduq3-pro",
  "prompt": "让人物向前走并微笑",
  "image": "https://example.com/character.png",
  "seconds": "5",
  "metadata": {
    "output_config": {
      "resolution": "1080P",
      "aspect_ratio": "9:16"
    }
  }
}

​
首尾帧生视频

{
  "model": "Kling-3.0-Omni",
  "prompt": "死寂系统空间中,角色被蓝色面板照亮",
  "seconds": "15",
  "size": "720x1280",
  "metadata": {
    "output_config": {
      "duration": 15,
      "resolution": "720P",
      "aspect_ratio": "9:16",
      "audio_generation": "Enabled"
    },
    "last_frame_url": "https://example.com/last-frame.png"
  }
}

​
动作控制

{
  "model": "Kling-3.0-Omni",
  "prompt": "人物挥手打招呼",
  "image": "https://example.com/character.png",
  "seconds": "5",
  "metadata": {
    "scene_type": "motion_control",
    "motion_level": "pro",
    "output_config": {
      "resolution": "1080P",
      "aspect_ratio": "16:9"
    }
  }
}

​
模型文档

目前优先提供以下主流模型的详细文档：

即梦视频

jimeng-video-3.0、jimeng-video-2.0 的生成与查询文档。

Vidu 视频

viduq3-pro、viduq2、viduq1 系列的三套接入方式。

Kling 视频

Kling-3.0-Omni、Kling-2.6、Kling-2.5 的多种生成模式。
其他模型（GV-*、OS-*、Hunyuan-*、Mingmou-*、Hailuo-*、SV-*、JV-*）的详细文档正在整理中，您可以参考国产视频模型生成了解通用的参数规范和使用方法。

​
鉴权

渠道密钥格式：
  • SubAppId|SecretId|SecretKey
  • SubAppId|SecretId|SecretKey|Region

​
相关页面