JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 83
  • Score
    100M100P100Q88579F
  • License GPL-3.0

即梦/CapCut 图像与视频生成 CLI 与 MCP 工具

Package Exports

  • jimeng-cli
  • jimeng-cli/package.json

Readme

jimeng-cli

npm version

即梦/CapCut 图像与视频生成 CLI 工具。支持多区域（CN/US/HK/JP/SG），无需 VIP，普通账号即可使用。

安装

npm install -g jimeng-cli

快速开始

# 登录并添加 token 到池中（交互式，默认 CN 区）
jimeng login

# 登录指定区域
jimeng login --region us

# 生成图片
jimeng image generate --prompt "a red fox in snow"

# 生成视频
jimeng video generate --prompt "ocean wave at sunset" --wait

# 查看可用模型
jimeng models list --verbose

多区域

支持 5 个区域，各有不同的模型和端点：

区域 代码 端点 额外视频模型
中国大陆 cn jimeng.jianying.com seedance 2.0/2.0-fast, 3.x 全系列
美国 us dreamina.capcut.com seedance 2.0/2.0-fast
香港 hk dreamina.capcut.com veo3, veo3.1, sora2, seedance 2.0
日本 jp dreamina.capcut.com veo3, veo3.1, sora2, seedance 2.0
新加坡 sg dreamina.capcut.com veo3, veo3.1, sora2, seedance 2.0

Token 与区域绑定

每个 token 在池中绑定一个区域，API 请求自动路由到对应端点。生成时通过 --region 选择目标区域，系统从该区域的 token 中自动选取。

# 添加 US 区 token
jimeng token add --token <token> --region us

# 添加 JP 区 token
jimeng token add --token <token> --region jp

# 用 US 区 token 生成图片
jimeng image generate --prompt "..." --region us

# 用 JP 区生成 veo3 视频
jimeng video generate --prompt "..." --model jimeng-video-veo3 --region jp --wait

跨区域查询

# 查看所有区域 token 的模型列表
jimeng models list --all --verbose

# 查看特定区域的模型
jimeng models list --region hk --verbose

# 查询所有 token 的积分
jimeng token points --all

Token 管理

Token 池是核心机制，管理多个区域的 token 并自动轮换。

# 查看池状态
jimeng token pool

# 添加 token
jimeng token add --token <token> --region cn
jimeng token add --token-file tokens.txt --region us

# 验证 token 有效性
jimeng token check
jimeng token check --region us    # 只检查 US 区

# 查询积分
jimeng token points

# 领取每日免费积分
jimeng token receive

# 启用/禁用 token
jimeng token enable --token <token>
jimeng token disable --token <token>

# 移除 token
jimeng token remove --token <token>

# 手动健康检查
jimeng token pool-check

所有命令支持 --json 输出结构化 JSON。

Token 池配置

默认配置文件 configs/token-pool.json，可通过 TOKEN_POOL_FILE 环境变量覆盖。

{
  "updatedAt": 0,
  "tokens": [
    {
      "token": "your_token_here",
      "region": "us",
      "enabled": true
    }
  ]
}

环境变量：

变量 说明 默认值
TOKEN_POOL_ENABLED 启用/禁用 token 池 true
TOKEN_POOL_FILE 配置文件路径 configs/token-pool.json
TOKEN_POOL_HEALTHCHECK_INTERVAL_MS 健康检查间隔 300000 (5 min)
TOKEN_POOL_FETCH_CREDIT 检查时获取积分 true
TOKEN_POOL_AUTO_DISABLE 连续失败后自动禁用 true
TOKEN_POOL_AUTO_DISABLE_FAILURES 触发禁用的失败次数 2
TOKEN_POOL_STRATEGY 选 token 策略 random (round_robin)

模型

查看模型

# 列出模型 ID
jimeng models list

# 显示详细信息（能力、参数范围）
jimeng models list --verbose

# 查看指定区域
jimeng models list --region jp --verbose

# 查看所有 token 的模型（按 token/region 分组）
jimeng models list --all

# 刷新模型能力缓存
jimeng models refresh

可用模型

图像模型（CN 区全部可用，国际区部分可用）：

模型 CN US HK/JP/SG
jimeng-5.0 ✓ ✓ ✓
jimeng-4.6 ✓ ✓ ✓
jimeng-4.5 ✓ ✓ ✓
jimeng-4.1 ✓ ✓ ✓
jimeng-4.0 ✓ ✓ ✓
jimeng-3.1 ✓ - ✓
jimeng-3.0 ✓ ✓ ✓
nanobanana - ✓ ✓

视频模型：

模型 CN US HK/JP/SG
jimeng-video-seedance-2.0 ✓ ✓ ✓
jimeng-video-seedance-2.0-fast ✓ ✓ ✓
jimeng-video-veo3 - - ✓
jimeng-video-veo3.1 - - ✓
jimeng-video-sora2 - - ✓
jimeng-video-3.5-pro ✓ ✓ ✓

图像生成

# 文生图
jimeng image generate --prompt "a cat sitting on a windowsill"

# 指定模型和比例
jimeng image generate --prompt "..." --model jimeng-5.0 --ratio 16:9

# 指定区域
jimeng image generate --prompt "..." --region us

# 不等待，直接返回 task ID
jimeng image generate --prompt "..." --no-wait

# 高分辨率
jimeng image generate --prompt "..." --resolution 4k

# 图生图编辑（1-10 张图）
jimeng image edit --prompt "blend into poster" --image photo1.jpg --image photo2.jpg

# 图片放大
jimeng image upscale --image photo.jpg --resolution 4k

# 下载到指定目录
jimeng image generate --prompt "..." --output-dir ./output

通用选项：

选项 说明 默认值
--model 模型 jimeng-4.5
--ratio 宽高比 1:1
--resolution 分辨率 2k
--negative-prompt 负面提示词 -
--region 区域 cn
--token 指定 token 自动选取
--wait / --no-wait 等待完成 --wait
--json JSON 输出 -

支持的比例：1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9

视频生成

# 文生视频
jimeng video generate --prompt "ocean wave at sunset" --wait

# 图生视频
jimeng video generate --prompt "..." --mode image_to_video --image-file photo.jpg --wait

# 首尾帧
jimeng video generate --prompt "..." --mode first_last_frames --image-file start.jpg --image-file end.jpg --wait

# omni_reference 模式（1-9 图 + 0-3 视频）
jimeng video generate --prompt "..." --mode omni_reference --image-file ref1.jpg --video-file ref1.mp4 --wait

# 指定区域和模型
jimeng video generate --prompt "..." --model jimeng-video-veo3 --region jp --wait

# 指定时长和比例
jimeng video generate --prompt "..." --duration 10 --ratio 16:9 --wait

视频模式：

模式 说明 图片输入 视频输入
text_to_video 文生视频 0 0
image_to_video 图生视频 1 0
first_last_frames 首尾帧 1-2 0
omni_reference 多参考 1-9 0-3

通用选项：

选项 说明 默认值
--model 模型 按模式自动选择
--mode 生成模式 text_to_video
--ratio 宽高比 1:1
--duration 时长（秒） 5
--resolution 分辨率 720p
--region 区域 cn
--token 指定 token 自动选取
--wait / --no-wait 等待完成 --wait
--json JSON 输出 -

任务查询

# 查询任务状态
jimeng task get --task-id <id>
jimeng task get --task-id <id> --type video --json

# 等待任务完成
jimeng task wait --task-id <id>
jimeng task wait --task-id <id> --wait-timeout-seconds 120

# 查看历史任务
jimeng task list
jimeng task list --type video --count 50 --json

MCP Server

jimeng-mcp 通过 stdio 启动，供 Claude Desktop / Codex 等 MCP Client 接入。

npm run build
node dist/mcp/index.js

Claude Desktop 配置示例：

{
  "mcpServers": {
    "jimeng": {
      "command": "node",
      "args": ["/path/to/jimeng-cli/dist/mcp/index.js"],
      "env": {
        "JIMENG_API_TOKEN": "your_token"
      }
    }
  }
}

环境变量：

变量 说明 默认值
JIMENG_API_TOKEN 默认 API token -
MCP_HTTP_TIMEOUT_MS HTTP 超时 120000
MCP_ENABLE_ADVANCED_TOOLS 启用高级工具 true
MCP_REQUIRE_RUN_CONFIRM 运行前确认 true

其他环境变量

变量 说明
JIMENG_CLI_VERBOSE_LOGS 启用详细日志 (true/false)

开发

npm install
npm run build
npm run dev          # 开发模式
npm run type-check   # 类型检查
npm run cli:smoke    # CLI 冒烟测试
npm run mcp:dev      # MCP 开发模式
npm run mcp:smoke    # MCP 冒烟测试

许可证

GPL-3.0