七牛云 AI 大模型推理 API 支持文生视频（Text-to-Video）、图生视频（Image-to-Video）和视频 Remix 功能，兼容 OpenAI Videos API 接口格式，支持 OpenAI Sora 2 模型，方便您集成到各种业务和应用场景中。

接口说明

Token API 接入点

七牛云 AI 大模型推理 API 接入域名：

• 接入点: https://api.qnaigc.com/v1
• 适用模型：kling系列、sora等
• 使用前提：获取 API KEY(API 密钥)

支持接口列表

支持的模型

HTTP 调用示例

基础文生视频 (sora-2)

使用上一步获取的七牛云 API KEY 调用文生视频接口：

# 调用文生视频 API
export OPENAI_BASE_URL="https://api.qnaigc.com/v1"
export OPENAI_API_KEY="<七牛云 AI API KEY>"

curl "$OPENAI_BASE_URL/videos" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    -d '{
        "model": "sora-2",
        "prompt": "一只可爱的橘猫在阳光明媚的花园里追逐蝴蝶,照片风格,高清画质"
    }'

基础文生视频 (kling-video-o1)

使用 kling-video-o1 模型生成高分辨率 1080P 视频：

# 调用 kling-video-o1 文生视频 API
export OPENAI_BASE_URL="https://api.qnaigc.com/v1"
export OPENAI_API_KEY="<七牛云 AI API KEY>"

curl "$OPENAI_BASE_URL/videos" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    -d '{
        "model": "kling-video-o1",
        "prompt": "一只可爱的橘猫在阳光下奔跑，慢镜头，电影质感",
        "size": "1920x1080",
        "mode": "pro"
    }'

响应示例：

{
    "id": "qvideo-root-1764904843275618838",
    "object": "video",
    "model": "kling-video-o1",
    "mode": "pro",
    "status": "queued",
    "created_at": 1764904843,
    "updated_at": 1764904843,
    "seconds": "5",
    "size": "1920x1080"
}

图生视频 (sora-2)

使用 input_reference 参数提供参考图片 URL，基于图片内容和文本描述生成视频：

# 基于参考图片生成视频
export OPENAI_BASE_URL="https://api.qnaigc.com/v1"
export OPENAI_API_KEY="<七牛云 AI API KEY>"

curl "$OPENAI_BASE_URL/videos" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    -d '{
        "model": "sora-2",
        "prompt": "镜头缓慢推进，画面中的场景逐渐生动起来，光影流动，充满动感",
        "input_reference": "https://example.com/reference-image.jpg",
        "seconds": "4",
        "size": "1280x720"
    }'

图生视频说明：

• input_reference 参数需要提供公开可访问的图片 URL，仅支持图片 URL，不支持其他格式
• 图片尺寸必须与 size 参数一致（例如：size 为 1280x720，则图片也必须是 1280x720）
• 图片将作为视频生成的参考基础，结合 prompt 文本描述生成动态视频
• 建议：prompt 应描述希望在视频中呈现的动作、运动效果和变化，而非重复描述图片中已有的静态内容

图生视频 (kling-video-o1)

使用 kling-video-o1 模型基于参考图片生成视频：

# 基于参考图片生成视频
export OPENAI_BASE_URL="https://api.qnaigc.com/v1"
export OPENAI_API_KEY="<七牛云 API KEY>"

curl "$OPENAI_BASE_URL/videos" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    -d '{
        "model": "kling-video-o1",
        "prompt": "这个人在跑马拉松",
        "image_list": [
            {
                "image": "https://fastly.picsum.photos/id/173/1280/720.jpg?hmac=xH_ViV5QGlLeWARvoUE2frSLNcUXvAGKHaMs0Hy6c_0"
            }
        ],
        "size": "1920x1080",
        "mode": "pro"
    }'

图生视频说明：

• 使用 image_list 参数提供参考图片，参数需要提供公开可访问的图片 URL，仅支持图片 URL，不支持其他格式
• 图片将作为视频生成的视觉参考基础，结合 prompt 描述生成动态视频

点击查看生成的视频

图生视频 (kling-v2-1)

使用 kling-v2-1 模型基于参考图片生成视频：

# 基于参考图片生成视频
curl --location --request POST 'https://api.qnaigc.com/v1/videos' \
--header 'Authorization: sk-xxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "kling-v2-1",
    "prompt": "人在奔跑",
    "input_reference":"https://fastly.picsum.photos/id/173/1280/720.jpg?hmac=xH_ViV5QGlLeWARvoUE2frSLNcUXvAGKHaMs0Hy6c_0",
    "size": "1280x720",
    "mode": "pro"
}'

说明：

• 使用 input_reference 参数提供参考图片 URL
• mode 参数指定生成模式，支持 pro 模式

图生视频 (kling-v2-5-turbo) - 指定尾帧

使用 kling-v2-5-turbo 模型生成视频，并指定尾帧图片：

# 指定尾帧图生视频
curl --location --request POST 'https://api.qnaigc.com/v1/videos' \
--header 'Authorization: sk-xxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "kling-v2-5-turbo",
    "prompt": "人在奔跑",
    "input_reference":"https://fastly.picsum.photos/id/173/1280/720.jpg?hmac=xH_ViV5QGlLeWARvoUE2frSLNcUXvAGKHaMs0Hy6c_0",
    "image_tail":"https://fastly.picsum.photos/id/1052/1280/720.jpg?hmac=YHUiEFGx-xjxQB6sKaQSG3AGUh9u5E7wv-PzHuOCx5A",
    "size": "1280x720",
    "mode": "pro"
}'

说明：

• input_reference 参数指定视频的首帧参考图片
• image_tail 参数指定视频的尾帧参考图片
• 系统会根据首尾帧图片和提示词生成连贯过渡的视频
• mode 参数指定生成模式，支持 pro 模式

有参考视频生成视频 (kling-video-o1)

使用 kling-video-o1 模型基于参考视频生成新视频：

# 基于参考视频生成新视频
export OPENAI_BASE_URL="https://api.qnaigc.com/v1"
export OPENAI_API_KEY="<七牛云 AI API KEY>"

curl "$OPENAI_BASE_URL/videos" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    -d '{
        "model": "kling-video-o1",
        "prompt": "画面中增加一个小狗",
        "video_list": [
            {
                "video_url": "https://aitoken-public.qnaigc.com/example/generate-video/the-little-dog-is-running-on-the-lawn..mp4",
                "refer_type": "feature",
                "keep_original_sound": "yes"
            }
        ],
        "size": "1920x1080",
        "mode": "pro"
    }'

点击查看生成的视频

有参考视频生成说明：

• video_list 参数用于提供参考视频列表
• video_url: 参考视频的公开可访问 URL
• refer_type: 参考类型，feature 为特征参考视频，base 为待编辑视频
• keep_original_sound: 是否保留原视频声音，yes 为保留，no 为不保留

多图首尾帧生视频 (kling-video-o1)

使用 kling-video-o1 模型的 image_list 参数，通过指定首帧和尾帧图片生成连贯视频：

# 基于首尾帧图片生成视频
export OPENAI_BASE_URL="https://api.qnaigc.com/v1"
export OPENAI_API_KEY="<七牛云 AI API KEY>"

curl "$OPENAI_BASE_URL/videos" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    -d '{
        "model": "kling-video-o1",
        "prompt": "视频连贯在一起",
        "image_list": [
            {
                "image": "https://fastly.picsum.photos/id/173/1280/720.jpg?hmac=xH_ViV5QGlLeWARvoUE2frSLNcUXvAGKHaMs0Hy6c_0",
                "type": "first_frame"
            },
            {
                "image": "https://fastly.picsum.photos/id/999/1280/720.jpg?hmac=YPLs2sdukTxfP4z7CI7wNIWwNXYksSjUi1yENuaT-RI",
                "type": "end_frame"
            }
        ],
        "size": "1920x1080",
        "mode": "pro"
    }'

点击查看生成的视频

多图首尾帧生视频说明：

• image_list 参数用于提供多张参考图片
• type 字段指定图片类型：first_frame（首帧）或 end_frame（尾帧）
• 首帧和尾帧将引导视频从指定的开始图片过渡到结束图片，中间内容由 AI 补充生成
• 所有图片需要公开可访问
• 此功能仅支持 kling-video-o1 模型

指定视频时长和分辨率

# 生成指定时长和分辨率的视频
export OPENAI_BASE_URL="https://api.qnaigc.com/v1"
export OPENAI_API_KEY="<七牛云 AI API KEY>"

curl "$OPENAI_BASE_URL/videos" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    -d '{
        "model": "sora-2",
        "prompt": "未来科技城市的天际线,霓虹灯光闪烁,赛博朋克风格,夜景",
        "seconds": "4",
        "size": "1280x720"
    }'

视频 Remix（基于已生成视频重新生成）

使用 Remix 功能，可以基于已生成的视频使用新的提示词重新生成视频，保持原视频的时长和分辨率：

# 对已生成的视频进行 Remix
export OPENAI_BASE_URL="https://api.qnaigc.com/v1"
export OPENAI_API_KEY="<七牛云 AI API KEY>"
export VIDEO_ID="qvideo-user123-1234567890123456789"

curl "$OPENAI_BASE_URL/videos/$VIDEO_ID/remix" \
    -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    -d '{
        "prompt": "将场景改为夜晚，增加霓虹灯效果，赛博朋克风格"
    }'

Remix 功能说明：

• 必须使用已完成的视频任务 ID（状态为 completed）
• 仅需提供新的 prompt 参数，其他参数（模型、时长、分辨率）继承原视频
• Remix 任务将创建一个新的视频任务，拥有独立的任务 ID
• 新任务的时长和分辨率与原视频保持一致
• 可以通过查询接口跟踪 Remix 任务的进度

响应示例：

{
  "id": "qvideo-user123-1234567890123456790",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "created_at": 1234567900,
  "updated_at": 1234567900
}

查询视频生成状态

# 查询视频任务状态
export OPENAI_BASE_URL="https://api.qnaigc.com/v1"
export OPENAI_API_KEY="<七牛云 AI API KEY>"
export VIDEO_ID="qvideo-user123-1234567890123456789"

curl "$OPENAI_BASE_URL/videos/$VIDEO_ID" \
    -H "Authorization: Bearer $OPENAI_API_KEY"

响应示例 (处理中):

{
  "id": "qvideo-user123-1234567890123456789",
  "object": "video",
  "model": "sora-2",
  "status": "in_progress",
  "created_at": 1234567890,
  "updated_at": 1234567895
}

响应示例 (已完成):

{
  "id": "qvideo-user123-1234567890123456789",
  "object": "video",
  "model": "sora-2",
  "status": "completed",
  "created_at": 1234567890,
  "updated_at": 1234567920,
  "completed_at": 1234567920,
  "expires_at": 1234654320,
  "seconds": "4",
  "size": "1280x720",
  "task_result": {
    "videos": [
      {
        "id": "qvideo-user123-1234567890123456789-1",
        "url": "https://kodo.qiniu.com/videos/generated-video.mp4",
        "duration": "4"
      }
    ]
  }
}

请求参数说明

创建视频接口 (POST /videos)

Header 参数

Body 参数 (JSON)

参数详细说明

model

• 必填参数
• 指定使用的视频生成模型
• 例如：sora-2（OpenAI Sora 2）

prompt

• 必填参数
• 视频生成的文本描述提示词
• 字符数限制：不超过 2500 个字符
• 建议：提示词越详细、具体，生成的视频质量越好
• 建议包含：场景描述、动作、风格、光线、氛围等细节
• 示例："一只橘色的猫坐在窗台上,温暖的阳光洒在它身上,它慢慢转头看向镜头,电影风格,高清画质"

input_reference

• 可选参数，用于图生视频功能
• 必须提供公开可访问的图片 URL
• 仅支持图片 URL，不支持 Base64 编码或其他格式
• 图片将作为视频生成的视觉参考基础，结合 prompt 描述生成动态视频
• 重要：图片尺寸必须与 size 参数一致，例如：如果 size 为 1280x720（横屏），图片尺寸也必须是 1280x720
• 注意：图片必须可以通过 HTTP/HTTPS 公开访问
• 对于 kling-v2-5-turbo 模型，此参数表示视频的首帧参考图片

image_tail

• 指定视频的尾帧参考图片 URL
• 必须提供公开可访问的图片 URL
• 图片尺寸必须与 size 参数一致，与 input_reference 相同
• 当同时提供 input_reference 和 image_tail 时，系统会根据首尾帧图片和 prompt 生成连贯过渡的视频

image_list

• 必填参数（当使用图像列表功能时）
• 图片列表，最多支持 4 张图片
• 参数格式为 JSON 数组，每个元素包含 image 字段
• 参数示例：

  "image_list": [
    {
      "image": "image_url_or_base64"
    },
    {
      "image": "image_url_or_base64"
    }
  ]
  

• 支持两种图片输入方式：
  • 图片 URL：提供公开可访问的图片 URL（确保可访问）
  • Base64 编码：直接提供 Base64 编码的图片数据（不需要 data:image/png;base64, 前缀）
• Base64 编码注意事项：
  • 请直接提供 Base64 编码后的字符串部分
  • 不要在 Base64 编码字符串前添加任何前缀（如 data:image/png;base64,）
  • 若提交的所有图像数据都采用 Base64 编码，请确保全部采用 Base64 格式
• 图片格式支持：
  • 支持的格式：.jpg、.jpeg、.png
  • 文件大小：不能超过 10MB
  • 图片尺寸：宽高不小于 300px
  • 图片宽高比：介于 1:2.5 ~ 2.5:1 之间
• API 处理说明：
  • API 端无裁剪逻辑，请直接上传已选主体后的图片
  • 最多支持 4 张图片，超出数量会被忽略

video_list

• 可选参数，仅支持 kling-video-o1 模型使用
• 参考视频列表，通过 URL 方式获取
• 参考视频可作为特征参考视频，也可作为待编辑视频（默认为待编辑视频）
• 通过 refer_type 参数区分参考视频类型：
  • feature：特征参考视频，用于指导视频风格和内容
  • base：待编辑视频，基于此视频进行编辑和生成
• 当参考视频为待编辑视频时，不能定义视频首尾帧
• 通过 keep_original_sound 参数选择是否保留视频原声：
  • yes：保留原视频声音
  • no：不保留原视频声音
  • 当前参数对特征参考视频（feature）也生效
• 格式要求：
  • 视频格式：仅支持 MP4 和 MOV
  • 视频时长：≥3 秒且 ≤10 秒
  • 视频尺寸：宽高均需介于 720px（含）和 2160px（含）之间
  • 视频帧率：24fps～60fps，生成视频时会输出为 24fps
  • 视频大小：单个视频不超过 200MB
• 数量限制：至多仅支持上传 1 段视频
• 参数示例：

  "video_list": [
    {
      "video_url": "https://example.com/reference-video.mp4",
      "refer_type": "base",
      "keep_original_sound": "yes"
    }
  ]
  

seconds

• 可选参数
• 控制生成视频的时长（单位：秒）
• 不同时长会影响生成成本和时间
• sora-2 模型可选值：4、8、12
• kling 系列模型可选值：5、10

size

• 可选参数
• 指定生成视频的分辨率，格式为 宽x高
• sora-2 模型支持的分辨率：
  • 横屏：1280x720
  • 竖屏：720x1280
• kling 模型可选值：1920x1080、1080x1920、1280x720、720x1280、1080x1080、720x720
• kling 模型该字段仅能控制视频的宽高比例（横屏/竖屏/正方形），视频分辨率品质由 mode 字段控制
• 作用：主要用于判断横竖屏方向
  • 宽 > 高：横屏
  • 宽 < 高：竖屏
  • 宽 = 高：正方形

mode

• 可选参数
• 指定生成视频的模式，默认值为 std
• 支持的模式：
  • std：标准模式（标准），基础模式，性价比高
  • pro：专家模式（高品质），高表现模式，生成视频质量更佳
• 不同模型版本对视频模式的支持范围不同，详见可灵官方文档
• kling-video-o1 模型目前仅支持 pro 模式

查询视频状态接口 (GET /videos/:id)

Path 参数

Header 参数

视频 Remix 接口 (POST /videos/:id/remix)

Path 参数

Header 参数

Body 参数 (JSON)

参数详细说明

id

• 必填参数
• 必须是已完成的视频任务 ID（状态为 completed）
• 视频任务必须属于当前用户
• 如果原视频任务不存在或未完成，接口将返回错误

prompt

• 必填参数
• 新的视频生成提示词，用于重新生成视频
• 字符数限制：不超过 2500 个字符
• 建议：描述希望在新视频中呈现的变化、风格或效果
• 新视频将继承原视频的模型、时长和分辨率设置

响应格式

创建视频响应

{
  "id": "qvideo-user123-1234567890123456789",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "created_at": 1234567890,
  "updated_at": 1234567890
}

查询状态响应

处理中状态

{
  "id": "qvideo-user123-1234567890123456789",
  "object": "video",
  "model": "sora-2",
  "status": "in_progress",
  "created_at": 1234567890,
  "updated_at": 1234567895
}

成功完成状态

{
  "id": "qvideo-user123-1234567890123456789",
  "object": "video",
  "model": "sora-2",
  "status": "completed",
  "created_at": 1234567890,
  "updated_at": 1234567920,
  "completed_at": 1234567920,
  "expires_at": 1234654320,
  "seconds": "4",
  "size": "1280x720",
  "task_result": {
    "videos": [
      {
        "id": "qvideo-user123-1234567890123456789-1",
        "url": "https://kodo.qiniu.com/videos/generated-video.mp4",
        "duration": "4"
      }
    ]
  }
}

失败状态

{
  "id": "qvideo-user123-1234567890123456789",
  "object": "video",
  "model": "sora-2",
  "status": "failed",
  "created_at": 1234567890,
  "updated_at": 1234567920,
  "error": {
      "code": "moderation_blocked",
      "message": "Your request was blocked by our moderation system."
  }
}

响应参数说明

任务状态说明

如何使用返回的视频？

响应中的 task_result.videos[].url 字段包含视频下载 URL，可通过以下方式使用：

1. 在 HTML 中直接播放

<video controls>
  <source src="https://kodo.qiniu.com/videos/generated-video.mp4" type="video/mp4">
  您的浏览器不支持视频播放。
</video>

2. 使用命令行工具下载视频

# 使用 curl 下载视频
curl -o generated-video.mp4 "https://kodo.qiniu.com/videos/generated-video.mp4"

# 使用 wget 下载视频
wget -O generated-video.mp4 "https://kodo.qiniu.com/videos/generated-video.mp4"

常见问题

Q: 如何将生成的视频保存到七牛云对象存储？

A: 生成的视频已经自动保存在七牛云对象存储 (Kodo) 中，返回的 URL 即为 Kodo 存储地址，但有效期仅有 7 天。如需转存到您自己的存储空间，推荐使用七牛对象存储的【SDK 中心】进行操作。更多对象存储信息欢迎参考对象存储的【产品使用文档】。

Q: 视频生成需要多长时间？

A: 视频生成时间取决于视频时长和当前队列情况。通常情况下：

sora-2 模型：

• 4 秒视频：2-5 分钟
• 8 秒视频：5-10 分钟
• 12 秒视频：10-15 分钟

kling 系列模型：

• 5 秒视频：2-5 分钟
• 10 秒视频：5-10 分钟

建议使用轮询方式查询任务状态。

Q: 生成的视频会保存多久？

A: 生成的视频会在 7 天后过期，建议在视频生成后及时下载或转存到您自己的存储空间。

Q: 如何提高视频生成质量？

A:

• 详细的提示词：描述越详细，生成效果越好
• 包含关键要素：场景、动作、风格、光线、氛围等
• 使用具体的风格描述：如"电影风格"、"高清画质"等

Q: 支持哪些视频格式和分辨率？

A:

• 输出格式：MP4
• 分辨率：可通过 size 参数指定
  • sora-2：支持 1280x720（横屏）、720x1280（竖屏）
  • kling-video-o1：支持 1920x1080（横屏）、1080x1920（竖屏）、1080x1080（正方形）
• 视频时长：sora-2 支持 4、8、12 秒；kling 系列支持 5、10 秒

Q: kling-video-o1 模型的输出视频分辨率是多少？

A: kling-video-o1 模型目前仅支持 pro 模式，输出的所有视频都是 1080P (1920x1080)。

Q: 如何控制生成成本？

A:

• 选择合适的时长：视频时长直接影响成本
• 批量生成：提前规划好需求，避免重复生成

Q: Remix 功能的使用场景是什么？

A: Remix 功能适用于以下场景：

• 快速迭代：对已生成的视频进行风格调整或场景变化
• 内容变体：基于同一视频生成不同风格的版本（如将白天场景改为夜晚）
• 参数保持：当需要生成与原视频相同时长和分辨率的新内容时

Q: Remix 与直接创建新视频有什么区别？

A:

• Remix：基于原视频重新生成，自动继承原视频的模型、时长和分辨率，只需提供新的 prompt
• 创建新视频：完全独立的视频生成任务，需要提供所有参数（model、prompt、seconds、size 等）
• 建议：如果需要保持相同参数生成相似内容，使用 Remix 更方便；如果需要完全不同的视频，使用创建接口

Q: Remix 任务失败的常见原因？

A:

• 原视频未完成：原视频任务状态必须为 completed
• 视频不存在或无权限：原视频 ID 不存在或不属于当前用户
• prompt 为空：Remix 请求必须提供 prompt 参数

Q: 为什么我的视频生成任务返回了 moderation_blocked 错误？

A: moderation_blocked 表示您的请求被内容审核系统拦截。这通常发生在以下情况：

• 提示词包含敏感内容：您的 prompt 可能包含暴力、色情、政治敏感、违法违规等不当内容
• 参考图片违规：使用图生视频功能时，提供的参考图片 (input_reference) 可能包含违规内容
• 违反使用政策：请求内容违反了 AI 模型的使用政策和社区准则

解决方法：

• 检查并修改您的提示词，移除任何可能违规的内容描述
• 如使用图生视频功能，确保参考图片内容合规
• 使用更加中性、正面的描述方式
• 避免描述暴力、仇恨、成人内容等敏感主题

错误响应示例：

{
    "id": "qvideo-xxxxx-xxxxxxxxxxxx",
    "object": "video",
    "model": "sora-2",
    "status": "failed",
    "created_at": 1762416033,
    "updated_at": 1762416060,
    "completed_at": 1762416060,
    "error": {
        "code": "moderation_blocked",
        "message": "Your request was blocked by our moderation system."
    },
    "seconds": "12",
    "size": "1280x720"
}

Q: kling 模型的具体能力和参数有什么区别？

A: 不同的 kling 模型有不同的功能特性和参数支持：

• kling-video-o1：支持最高 1080P 分辨率，支持多种参考模式（图片列表、视频参考、首尾帧），功能最全面

更多详细的模型能力对比和参数说明，可参考 可灵官方文档。

参考文档

• AI 大模型推理产品介绍
• AI 大模型推理模型广场
• 实时推理请求 API 接入说明
• 文生图 API 接入说明