即梦视频生成 API 文档

📖 概述

即梦视频生成是一款功能强大的AI视频生成服务，通过标准的 OpenAI Chat Completions 接口调用。支持文生视频、图生视频、首尾帧视频三种模式，音频同步生成，无水印，功能超级强大！

核心特性：

🎬 文生视频 - 通过文字描述生成高质量视频

🖼️ 图生视频 - 让静态图片动起来

�️ 首尾帧视频 - 提供首帧和尾帧图片，AI自动补全中间过渡

🔊 音频同步生成 - 视频自带音效

📐 自定义尺寸 - 在提示词中输入比例如 16:9 即可

💎 无水印输出

支持的模型：

模型名称	视频时长	说明
`jimeng-video-3.5-pro`	5秒	默认模型，适合短视频
`jimeng-video-3.5-pro-10s`	10秒	中等时长视频
`jimeng-video-3.5-pro-12s`	12秒	长视频，适合复杂场景

基础信息：

基础URL：https://api.sora2.pub

请求格式：JSON

响应格式：JSON

字符编码：UTF-8

🔑 认证方式

所有API请求都需要在HTTP请求头中携带认证信息：

示例：

📋 聊天补全接口（Chat Completions）

接口地址： POST /v1/chat/completions

功能说明： 通过对话方式生成AI视频

请求参数

参数名	类型	必填	说明
model	string	是	模型名称，可选 `jimeng-video-3.5-pro`、`jimeng-video-3.5-pro-10s`、`jimeng-video-3.5-pro-12s`
messages	array	是	消息列表，包含文本提示和可选的图片
stream	boolean	否	是否流式返回，默认 false

messages 结构

{
  "role": "user",
  "content": [
    {
      "type": "text",
      "text": "视频描述文本"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "图片URL（可选，用于图生视频或首尾帧）"
      }
    }
  ]
}

自定义视频尺寸

在提示词文本中直接输入比例即可设置视频尺寸：

比例	说明
`16:9`	横屏视频（推荐）
`9:16`	竖屏视频（手机端）
`1:1`	方形视频
`4:3`	传统比例
`3:4`	竖向传统比例

示例： "一只小猫在奔跑 16:9" 将生成16:9比例的视频

🎬 使用示例

1. 文生视频

根据文字描述直接生成视频，无需任何图片输入。

请求示例：

响应示例：

{
  "id": "e78b538a-e2a4-4ecc-a40f-16c0e6a207ca",
  "object": "chat.completion",
  "created": 1767255596,
  "model": "jimeng-video-3.5-pro",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "<video controls=\"controls\">\n    https://example.com/video.mp4\n</video>\n\n[Download Video](https://example.com/video.mp4)\n\n"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 1,
    "completion_tokens": 1,
    "total_tokens": 2
  }
}

2. 图生视频

提供一张图片，AI会让图片中的内容动起来。

请求示例：

响应示例：

{
  "id": "e3b220bd-d5a7-4b80-a648-4707413e444a",
  "object": "chat.completion",
  "created": 1767254365,
  "model": "jimeng-video-3.5-pro",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "<video controls=\"controls\">\n    https://example.com/video.mp4\n</video>\n\n[Download Video](https://example.com/video.mp4)\n\n"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 1,
    "completion_tokens": 1,
    "total_tokens": 2
  }
}

3. 首尾帧视频

提供两张图片作为视频的第一帧和最后一帧，AI会自动生成平滑的过渡动画。

请求示例：

响应示例：

{
  "id": "c3791e86-adad-4d2b-9516-f2c474fb4a8f",
  "object": "chat.completion",
  "created": 1767254711,
  "model": "jimeng-video-3.5-pro",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "<video controls=\"controls\">\n    https://example.com/video.mp4\n</video>\n\n[Download Video](https://example.com/video.mp4)\n\n"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 1,
    "completion_tokens": 1,
    "total_tokens": 2
  }
}

4. 流式响应（Stream）

支持流式返回，实时获取生成进度。流式模式会通过 reasoning_content 字段返回生成进度，最终视频在 content 字段中返回。

请求示例：

流式响应格式（Server-Sent Events）：

1️⃣ 开始生成提示：

data: {"id":"9875a6ae-7225-4aed-8a99-9ee67bab18f0","model":"jimeng-video-3.5-pro","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"role":"assistant","reasoning_content":"🎬 视频生成中，请稍候...\n这可能需要1-5分钟，请耐心等待\n"},"finish_reason":null}]}

2️⃣ 排队状态：

data: {"id":"05adc2ca-9882-466a-85bc-3e1e5e4f90cc","model":"jimeng-video-3.5-pro","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"reasoning_content":"🔄 排队中：第 1/1位，优先级: 5\n"},"finish_reason":null}]}

3️⃣ 生成进度轮询：

data: {"id":"1d79e766-3539-440e-961e-f7c3b2d60e32","model":"jimeng-video-3.5-pro","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"reasoning_content":"⏳ 视频生成中... (轮询 1/60)\n"},"finish_reason":null}]}

data: {"id":"c4588fbd-9d0a-486f-afb2-561a4b037b04","model":"jimeng-video-3.5-pro","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"reasoning_content":"⏳ 视频生成中... (轮询 2/60)\n"},"finish_reason":null}]}

4️⃣ 排队结束，开始生成：

data: {"id":"9cea08ea-d3cf-4c20-8b93-92e4f93ce332","model":"jimeng-video-3.5-pro","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"reasoning_content":"🔄 排队结束，开始生成视频...\n"},"finish_reason":null}]}

5️⃣ 视频生成完成，返回结果：

data: {"id":"070c1e94-0ee7-4bea-a2d8-5fef87906ab7","model":"jimeng-video-3.5-pro","object":"chat.completion.chunk","choices":[{"index":1,"delta":{"role":"assistant","content":"\n\n✅ 视频生成完成！\n\n<video controls=\"controls\">\n    https://example.com/video.mp4\n</video>\n\n[Download Video](https://example.com/video.mp4)\n\n"},"finish_reason":null}]}

6️⃣ 结束信号：

data: {"id":"d11f4d54-3bb3-4529-ab7c-76ba20768240","model":"jimeng-video-3.5-pro","object":"chat.completion.chunk","choices":[{"index":2,"delta":{},"finish_reason":"stop"}]}

data: [DONE]

流式响应字段说明：

字段	说明
`reasoning_content`	进度信息（排队状态、生成进度等）
`content`	最终视频结果（包含视频标签和下载链接）
`finish_reason`	完成原因，`stop` 表示正常完成

📊 响应格式说明

响应内容结构

视频生成成功后，content 字段包含以下格式：

您可以从响应中提取视频URL进行播放或下载。

解析示例（Python）

📊 响应状态码

状态码	说明
200	请求成功
400	请求参数错误
401	认证失败，Token无效
403	权限不足
429	请求过于频繁，触发限流
500	服务器内部错误
502	上游服务错误
503	服务暂时不可用

⚠️ 错误响应格式

{
  "error": {
    "message": "错误描述信息",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

💡 使用建议

模型选择：

jimeng-video-3.5-pro：默认5秒，适合快速预览和短视频场景

jimeng-video-3.5-pro-10s：10秒视频，适合中等复杂场景

jimeng-video-3.5-pro-12s：12秒视频，适合复杂故事和长镜头

提示词技巧：

详细描述场景、动作、光线、风格等细节

在提示词末尾添加比例如 16:9 来指定视频尺寸

可以参考电影风格、艺术流派来引导生成效果

图生视频最佳实践：

使用高清晰度的图片

图片内容应该有明确的主体

提示词中描述希望的动作和变化

首尾帧视频技巧：

首帧和尾帧应该有一定的关联性

描述从首帧到尾帧的过渡方式（如镜头移动、主体动作等）

两帧之间的变化不宜太大，便于AI生成平滑过渡

Token管理：妥善保管API Token，不要在客户端代码中硬编码

错误处理：建议实现重试机制，处理临时性错误

流式响应：使用 stream: true 可以实时获取生成进度，提升用户体验

即梦视频生成3.5-pro

即梦视频生成 API 文档#

📖 概述#

🔑 认证方式#

📋 聊天补全接口（Chat Completions）#

请求参数#

messages 结构#

自定义视频尺寸#

🎬 使用示例#

1. 文生视频#

2. 图生视频#

3. 首尾帧视频#

4. 流式响应（Stream）#

📊 响应格式说明#

响应内容结构#

解析示例（Python）#

📊 响应状态码#

⚠️ 错误响应格式#

💡 使用建议#

即梦视频生成 API 文档

📖 概述

🔑 认证方式

📋 聊天补全接口（Chat Completions）

请求参数

messages 结构

自定义视频尺寸

🎬 使用示例

1. 文生视频

2. 图生视频

3. 首尾帧视频

4. 流式响应（Stream）

📊 响应格式说明

响应内容结构

解析示例（Python）

📊 响应状态码

⚠️ 错误响应格式

💡 使用建议