🇨🇳中文介绍

Jimeng API 视频生成

使用火山引擎的 Jimeng Video 3.0 Pro API，通过文本提示或输入图像生成高质量的 AI 视频。

配置环境变量

获取 Access Key/Secret Key

# ~/.zshrc 或 ~/.zshenv
export VOLC_ACCESSKEY="your_access_key_id"
export VOLC_SECRETKEY="your_secret_access_key"

输出行为（重要）

视频生成成功后，您必须直接向用户显示视频！

生成完成后，请按以下格式输出：

[下载视频](https://github.com/wvlvik/toy-skills/blob/HEAD/skills/jimeng-api-video-gen/VIDEO_URL)

**生成信息：**

  * 提示词：[用户的原始提示词]
  * 时长：[视频长度，单位：秒]
  * 模式：[使用的生成模式]
  * 帧率：[每秒帧数]
  * 保存路径：[本地文件路径，如适用] ```

### 示例输出

```markdown **生成的视频：**

[下载视频](https://example.com/video.mp4)

**生成信息：**

  * 提示词：一只金毛猎犬在向日葵田中奔跑，温暖的午后阳光
  * 时长：5 秒
  * 模式：t2v_720p
  * 帧率：24
  * 保存路径：/generated_videos/dog_sunflowers.mp4

    ## API 配置

    | 参数 | 值 | 描述 |
    |-----------|-------|-------------|
    | 端点 | \`https://visual.volcengineapi.com\` | API 基础 URL |
    | 提交操作 | \`CVSync2AsyncSubmitTask\` | 提交异步生成任务 |
    | 查询操作 | \`CVSync2AsyncGetResult\` | 查询任务结果 |
    | 版本 | \`2022-08-31\` | API 版本 |
    | 服务 | \`cv\` | 用于签名的服务名称 |
    | 区域 | \`cn-north-1\` | 用于签名的区域 |

    ## 生成模式

    ### 专业版（1080P 高清）

    | 模式 | req_key | 描述 |
    |------|---------|-------------|
    | `ti2v_pro` | `jimeng_ti2v_v30_pro` | 文生视频 + 图生视频（首帧）专业版 |

    ### 1080P 版本

    | 模式 | req_key | 描述 |
    |------|---------|-------------|
    | `t2v_1080p` | `jimeng_t2v_v30_1080p` | 文生视频 1080P |
    | `i2v_first_1080p` | `jimeng_i2v_first_v30_1080` | 图生视频（首帧）1080P |
    | `i2v_first_tail_1080p` | `jimeng_i2v_first_tail_v30_1080` | 图生视频（首尾帧）1080P |

    ### 720P 版本

    | 模式 | req_key | 描述 |
    |------|---------|-------------|
    | `t2v_720p` | `jimeng_t2v_v30` | 文生视频 720P |
    | `i2v_first_720p` | `jimeng_i2v_first_v30` | 图生视频（首帧）720P |
    | `i2v_first_tail_720p` | `jimeng_i2v_first_tail_v30` | 图生视频（首尾帧）720P |
    | `i2v_recamera_720p` | `jimeng_i2v_recamera_v30` | 图生视频（摄像机运动）720P |

    ## 命令行选项

    \`\`\`
    scripts/generate_video.py PROMPT [OPTIONS]

    Arguments:
      PROMPT              用于视频生成的文本提示词（必需）

    Options:
      --mode MODE         生成模式（默认：t2v_720p）
                          专业版：ti2v_pro
                          1080P：t2v_1080p, i2v_first_1080p, i2v_first_tail_1080p
                          720P：t2v_720p, i2v_first_720p, i2v_first_tail_720p, i2v_recamera_720p
      --duration SECS     视频时长：4, 5, 6, 8, 10（默认：5）
      --fps FPS           每秒帧数：24, 25, 30（默认：24）
      --image URL         用于图生视频（首帧）的输入图像 URL
      --tail-image URL    用于首尾帧模式的尾帧图像 URL
      --seed INT          用于可重现性的随机种子
      --output PATH       将视频下载到文件
      --json              输出原始 JSON 响应

    Environment Variables:
      VOLC_ACCESSKEY           Access Key ID（必需）
      VOLC_SECRETKEY           Secret Access Key（必需）
      JIMENG_VIDEO_API_URL     API 端点（默认：https://visual.volcengineapi.com）
      JIMENG_VIDEO_API_TIMEOUT 请求超时秒数（默认：300）
      JIMENG_VIDEO_POLL_INTERVAL 轮询间隔秒数（默认：5）
      JIMENG_VIDEO_MAX_POLL_ATTEMPTS 最大轮询尝试次数（默认：120）
    \`\`\`

    ## 视频规格

    ### 时长选项

    | 时长 | 使用场景 |
    |----------|----------|
    | 4s | 快速剪辑，社交媒体 |
    | 5s | 默认，通用目的 |
    | 6s | 短场景 |
    | 8s | 中等长度内容 |
    | 10s | 较长叙事 |

    ### 帧率选项

    | 帧率 | 使用场景 |
    |-----|----------|
    | 24 | 电影感外观（默认） |
    | 25 | PAL 视频标准 |
    | 30 | 流畅运动，NTSC 标准 |

    ## 认证

    此技能使用火山引擎 IAM v4 签名认证（HMAC-SHA256）。签名过程：

    1. 使用头部构建规范请求：\`content-type;host;x-content-sha256;x-date\`
    2. 计算规范请求的 SHA256 哈希值
    3. 派生签名密钥：secret_key → date → region → service → "request"
    4. 使用派生密钥对字符串进行签名
    5. 将 \`Authorization\` 头部添加到请求中

    参考：[HTTP请求示例](https://www.volcengine.com/docs/6444/1390583)

    ## 错误代码

    | 代码 | 消息 | 描述 |
    |------|---------|-------------|
    | 10000 | Success | 请求成功 |
    | 50411 | Pre Img Risk Not Pass | 输入图像内容检查未通过 |
    | 50511 | Post Video Risk Not Pass | 输出视频内容检查未通过 |
    | 50412 | Text Risk Not Pass | 输入文本内容检查未通过 |
    | 50429 | Request Has Reached API Limit | 超过速率限制，稍后重试 |
    | 50500 | Internal Error | 服务器错误 |
    | timeout | Request timeout | 增加 JIMENG_VIDEO_API_TIMEOUT |

    ## 输入/输出限制

    **输入图像（用于图生视频）：**
    - 格式：仅限 JPEG、PNG
    - 最大尺寸：每张图像 15MB
    - 最大分辨率：4096×4096

    **输出：**
    - 格式：MP4
    - URL 有效期：24 小时
    - 生成时间：2-10 分钟，取决于时长和模式

    ## 参考文档

    - [Jimeng Video 3.0 Pro API 文档](https://www.volcengine.com/docs/85621/1777001)
    - [Jimeng Video 3.0 720P API](https://www.volcengine.com/docs/85621/1792710)
    - [Jimeng Video 3.0 1080P API](https://www.volcengine.com/docs/85621/1792711)
    - [HTTP 请求示例](https://www.volcengine.com/docs/6444/1390583)
    - [火山引擎控制台](https://console.volcengine.com)
    - [API 密钥管理](https://console.volcengine.com/iam/key_manage/)

每周安装数

156

仓库

[wvlvik/toy-skills](https://github.com/wvlvik/toy-skills "wvlvik/toy-skills")

首次出现

2026年2月20日

安全审计

[Gen Agent Trust HubPass](/wvlvik/toy-skills/jimeng-api-video-gen/security/agent-trust-hub)[SocketPass](/wvlvik/toy-skills/jimeng-api-video-gen/security/socket)[SnykWarn](/wvlvik/toy-skills/jimeng-api-video-gen/security/snyk)

安装于

opencode155

kimi-cli153

gemini-cli153

github-copilot153

amp153

codex153