jimeng-cli

图像与视频生成 CLI 工具，聚合多个 AI 模型提供商。

• Jimeng/Dreamina: 即梦图像与视频生成（多区域 CN/US/HK/JP/SG）
• Ark 火山引擎: Seedance 视频 + Seedream 图像
• Cloudflare: Workers AI 图片生成
• OpenAI: GPT-Image / DALL-E 文生图 + 图编辑
• Groq: xAI 文生图
• Veo: Veo/Seedance 视频生成
• Sora: OpenAI Sora 2 视频生成 + 可复用角色
• Gemini: 文本聊天 + Nano Banana 图像 + Omni Flash 视频 + Lyria 音乐

安装

npm install -g @difyz/jimeng-cli

快速开始

# 查看版本
jimeng --version

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

# 设置默认区域（后续命令可省略 --region）
jimeng set region cn

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

# 生成图片
jimeng image generate -p "a red fox in snow" -o ./pic/fox.png

# 生成视频
jimeng video generate -p "ocean wave at sunset" -o ./pic/ocean.mp4 --wait

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

# 查看本地已知但上游未公开枚举的模型
jimeng models list --all-known --region cn --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 |

默认区域与比例

可以通过 set 命令设置一次默认区域和默认宽高比，之后生成、登录、模型查询和任务查询都可以省略 --region，生成命令也可以省略 --ratio。

jimeng set region cn
jimeng set ratio 16:9
jimeng get region
jimeng get ratio
jimeng config list

显式 --region / --ratio 优先级高于默认配置；未设置时区域回退到 cn，比例回退到 1:1。默认配置保存在 ~/.jimeng/config.json，也可以通过 JIMENG_CONFIG_FILE 指定路径。

默认提供商

项目整合了多个 AI 模型提供商。可以通过 set provider 命令设置文生图和视频生成的默认提供商，方便后续命令自动选择合适的后端。

# 查看当前默认提供商
jimeng get provider

# 查看指定类型的默认提供商
jimeng get provider image
jimeng get provider video

# 设置文生图默认提供商为 OpenAI
jimeng set provider image openai

# 设置视频生成默认提供商为 Ark（火山引擎）
jimeng set provider video ark

# 在 config list 中一并查看
jimeng config list

可用提供商：

| 任务类型 | 可选提供商 | |---------|-----------| | 文生图 | jimeng（即梦）、ark（火山引擎）、cloudflare、openai、grok | | 视频生成 | jimeng（即梦）、ark（火山引擎）、veo |

当前 providers 配置仅作记录用途，后续版本将支持按默认提供商自动路由请求。

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

# 查看某个区域的本地已知模型（含 manual/hidden models）
jimeng models list --region cn --all-known --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。

用户配置文件

用户偏好保存在 ~/.jimeng/config.json（可通过 JIMENG_CONFIG_FILE 环境变量覆盖路径）。

{
  "region": "cn",
  "ratio": "16:9",
  "providers": {
    "image": "openai",
    "video": "ark"
  },
  "updatedAt": 1783600812227
}

| 字段 | 说明 | 默认值 | |------|------|--------| | region | 默认区域（cn/us/hk/jp/sg） | cn | | ratio | 默认画面比例 | 1:1 | | providers.image | 文生图默认提供商 | 未设置 | | providers.video | 视频生成默认提供商 | 未设置 |

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

# 查看本地已知模型（包含上游未公开枚举的 manual models）
jimeng models list --all-known --region cn --verbose

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

jimeng models list 默认只显示上游配置实际返回的 discoverable models。
jimeng models list --all-known 会额外显示本地已知但上游未公开枚举的 manual models。后者可以被手动指定尝试调用，但并不代表当前 token 一定具备对应权益。

可用模型

图像模型（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-seedance-2.0-vip | manual | - | - | | jimeng-video-seedance-2.0-fast-vip | manual | - | - | | jimeng-video-veo3 | - | - | ✓ | | jimeng-video-veo3.1 | - | - | ✓ | | jimeng-video-sora2 | - | - | ✓ | | jimeng-video-3.5-pro | ✓ | ✓ | ✓ |

说明：

• manual 表示该模型在本地映射表中已知，但默认不会出现在上游 discoverable model 列表里。
• 这类模型需要通过 jimeng models list --all-known 查看。
• jimeng-video-seedance-2.0-vip 和 jimeng-video-seedance-2.0-fast-vip 当前只在 cn 区作为 manual model 暴露。
• 即使模型名可见，实际生成仍取决于当前 token 是否具备对应权益，例如 vip。

图像生成

# 文生图
jimeng image generate -p "a cat sitting on a windowsill" -o ./pic/cat.png

# 指定模型和比例
jimeng image generate -p "..." -m jimeng-5.0 --ratio 16:9 -o ./pic/result.png

# 指定区域
jimeng image generate -p "..." -r us

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

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

# 图生图编辑（1-10 张图）
jimeng image edit -p "blend into poster" --image photo1.jpg --image photo2.jpg -o ./pic/poster.png

# 图片放大
jimeng image upscale --image photo.jpg --resolution 4k -o ./pic/photo-4k.png

-o, --output <path> 用于指定输出文件路径。图片生成通常返回多张图，因此 -o ./pic/cat.png 会保存为 ./pic/cat-01.png, ./pic/cat-02.png 等；单个输出则直接使用指定路径。

通用选项：

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

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

视频生成

# 文生视频
jimeng video generate -p "ocean wave at sunset" -o ./pic/ocean.mp4 --wait

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

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

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

# 指定区域和模型
jimeng video generate -p "..." -m jimeng-video-veo3 -r jp --wait

# 手动尝试 CN VIP model（需要 token 具备对应权益）
jimeng video generate -p "..." -m jimeng-video-seedance-2.0-vip -r cn --wait

# 指定时长和比例
jimeng video generate -p "..." --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 | 宽高比 | jimeng set ratio 或 1:1 | | --duration | 时长（秒） | 5 | | --resolution | 分辨率 | 720p | | --region | 区域 | jimeng set region 或 cn | | --token | 指定 token | 自动选取 | | --wait / --no-wait | 等待完成 | --wait | | --json | JSON 输出 | - | | -o, --output | 输出文件路径 | 自动生成 |

任务查询

# 查询任务状态
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

Ark API（火山引擎 Seedance / Seedream）

当前项目同时集成了火山引擎 Ark API 的视频与图像生成能力，通过独立的 ark 子命令和对应的 MCP 工具对外暴露。与即梦（Dreamina）API 使用不同的认证方式——只需一个 API Key。

配置

# 设置 API Key（建议写入 shell 配置文件）
export ARK_API_KEY="your_api_key_here"

# 或每次命令指定
jimeng ark generate -p "..." --api-key "your_api_key_here"

获取 API Key：访问 火山引擎方舟平台 API Key 管理。

可用模型

视频生成（Seedance 2.0 系列）：

| 模型 | Model ID | 分辨率 | 说明 | |------|---------|--------|------| | Seedance 2.0 | doubao-seedance-2-0-260128 | 480p~4K | 最高品质 | | Seedance 2.0 Fast | doubao-seedance-2-0-fast-260128 | 480p~720p | 速度优先 | | Seedance 2.0 Mini | doubao-seedance-2-0-mini-260615 | 480p~720p | 低成本（默认） |

图像生成（Seedream 系列）：

| 模型 | Model ID | 分辨率 | 说明 | |------|---------|--------|------| | Seedream 5.0 Pro | doubao-seedream-5-0-pro-260628 | 1K~2K | 高精度，图文/多图 | | Seedream 5.0 Lite | doubao-seedream-5-0-260128 | 2K~4K | 默认，支持组图 | | Seedream 4.5 | doubao-seedream-4-5-251128 | 2K~4K | 稳定版 | | Seedream 4.0 | doubao-seedream-4-0-250828 | 1K~4K | 经典版 |

视频生成 — jimeng ark generate

多模态参考 / 文生视频 / 图生视频。支持文本 + 图片(0~9) + 视频(0~3) + 音频(0~3) 任意组合输入。

# 文生视频
jimeng ark generate -p "海边日落" --duration 5 --ratio 16:9

# 多模态参考（图片 + 视频 + 音频）
jimeng ark generate -p "全程使用视频1的第一视角构图" \
  --image-url https://...pic1.jpg \
  --image-url https://...pic2.jpg \
  --video-url https://...video.mp4 \
  --audio-url https://...audio.mp3 \
  --ratio 16:9 --duration 11 --generate-audio

# 图生视频-首帧
jimeng ark generate -p "镜头推近" --image-url https://...start.jpg

# 图生视频-首尾帧
jimeng ark generate -p "转场" --image-url https://...first.jpg --image-url https://...last.jpg

# 异步提交（不等待）
jimeng ark generate -p "一只猫" --no-wait

可选参数：

| 参数 | 说明 | 默认值 | |------|------|--------| | --model | 模型 ID | doubao-seedance-2-0-mini-260615 | | --ratio | 画面比例 | 16:9 | | --duration | 视频时长（秒），4~15 | 5 | | --resolution | 分辨率：480p/720p/1080p/4K | 720p | | --generate-audio / --no-audio | 是否生成背景音频 | 开启 | | --watermark | 是否添加水印 | 不添加 | | --return-last-frame | 返回尾帧 PNG | 不返回 | | --seed | 随机种子 | - | | --camera-fixed | 固定镜头 | 不固定 | | --service-tier | standard / flex（离线推理） | standard | | --callback-url | 任务回调 URL | - |

视频编辑 — jimeng ark edit

基于参考图片和文本指令编辑视频（替换主体、增删元素等）。

# 替换视频中的元素
jimeng ark edit -p "将视频1中的香水替换成图片1中的面霜" \
  --video-url https://...video.mp4 \
  --image-url https://...product.jpg

# 增/删元素
jimeng ark edit -p "在台面上添加炸鸡和披萨" \
  --video-url https://...video.mp4

视频延长 — jimeng ark extend

向前/向后延长视频，或将多个视频片段串联。

# 向后延长
jimeng ark extend -p "生成视频1之后的内容" \
  --video-url https://...video.mp4

# 多个视频拼接
jimeng ark extend -p "接视频2" \
  --video-url https://...part1.mp4 \
  --video-url https://...part2.mp4

图像生成 — jimeng ark image

OpenAI 兼容的文生图 / 图文生图 / 多图融合 / 组图生成。使用 Seedream 系列模型。

# 文生图
jimeng ark image -p "一只猫在阳光下"

# 单参考图编辑
jimeng ark image -p "将服装材质改为透明清水" \
  --image-url https://...photo.jpg

# 多图融合（换装/融合风格）
jimeng ark image -p "将图1的服装换为图2的服装" \
  --image-url https://...model.png \
  --image-url https://...cloth.png

# 组图生成（4 张电影分镜）
jimeng ark image -p "4张科幻片分镜..." \
  --sequential-image-generation auto \
  --max-images 4

# 指定型号和参数
jimeng ark image -p "产品图" \
  --model doubao-seedream-5-0-pro-260628 \
  --size 4K --output-format png --json

可选参数：

| 参数 | 说明 | 默认值 | |------|------|--------| | --model | 模型 ID | doubao-seedream-5-0-260128 | | --size | 图片尺寸：1K/2K/3K/4K | 2K | | --output-format | 输出格式：png/jpeg | png | | --watermark | 添加水印 | 不添加 | | --sequential-image-generation | 组图模式：disabled/auto | disabled | | --max-images | 组图最大图片数 | - |

MCP 工具

当通过 MCP Server 使用时，以下工具可用（需要在环境变量中设置 ARK_API_KEY 或在工具参数中传入 api_key）：

| 工具名 | 说明 | |--------|------| | ark_generate | 多模态视频生成 | | ark_edit | 视频编辑 | | ark_extend | 视频延长 | | ark_image | 文生图 / 图文生图 / 多图融合 / 组图 |

MCP Server 环境变量：

| 变量 | 说明 | |------|------| | ARK_API_KEY | Ark API Key，工具调用时可省略 api_key 参数 | | JIMENG_API_TOKEN | 即梦 API Token | | MCP_REQUIRE_RUN_CONFIRM | 运行前确认 | true |

Cloudflare Workers AI 图片生成 — jimeng cloudflare image

通过 Cloudflare Workers AI 调用 openai/gpt-image-2 模型生成图片。

# 配置（建议写入 shell 配置文件）
export CLOUDFLARE_ACCOUNT_ID="your_account_id"
export CLOUDFLARE_API_TOKEN="your_api_token"

# 文生图
jimeng cloudflare image -p "a cat astronaut on the moon"

# 指定尺寸快捷方式
jimeng cloudflare image -p "Chinese tea poster" --size landscape -o poster.png

# 高清大图
jimeng cloudflare image -p "4K cityscape" --size 4k --quality high --json

尺寸快捷方式：

| 名称 | 分辨率 | 说明 | |------|--------|------| | 1k | 1024×1024 | 默认方形 | | 2k | 2048×2048 | 高清方形 | | 4k | 3840×2160 | 超高清宽屏 | | portrait | 1024×1536 | 竖屏 | | landscape | 1536×1024 | 横屏 | | square | 1024×1024 | 方形 | | wide | 2048×1152 | 宽屏 | | tall | 2160×3840 | 超长竖屏 |

MCP 工具：cloudflare_image

MCP Server 环境变量补充：

| 变量 | 说明 | |------|------| | CLOUDFLARE_ACCOUNT_ID | Cloudflare 账户 ID，工具调用时可省略 account_id 参数 | | CLOUDFLARE_API_TOKEN | Cloudflare API Token，工具调用时可省略 api_token 参数 |

OmniRoute 共享配置

OpenAI、Grok、Veo 三个提供商统一走 OmniRoute 透明代理，共享以下配置：

| 变量 | 说明 | 默认值 | |------|------|--------| | OMNIROUTE_BASE_URL | 代理地址 | http://43.160.253.168:20128 | | OMNIROUTE_API_KEY | API Key（必填） | - |

OpenAI (GPT-Image / DALL-E) — jimeng openai image

通过 OmniRoute 代理调用 OpenAI GPT-Image 系列和 DALL-E 的文生图接口。

# 配置（建议写入 shell 配置文件）
export OMNIROUTE_API_KEY="your_api_key"

# 文生图
jimeng openai image -p "a cat"

# 指定模型和参数
jimeng openai image -p "landscape" --model gpt-image-2 --size 1792x1024 --quality high

# 使用 DALL-E 3
jimeng openai image -p "poster design" --model dall-e-3 --quality hd --size 1792x1024

# JSON 输出
jimeng openai image -p "product photo" --json

可用模型：

| 模型 | 说明 | 默认返回 | |------|------|---------| | gpt-image-1.5 | GPT 原生图像模型（默认） | b64_json | | gpt-image-2 | GPT 图像 v2 | b64_json | | gpt-image-1-mini | 低配版 | b64_json | | dall-e-3 | DALL-E 3 | URL | | dall-e-2 | DALL-E 2 | URL |

CLI 参数：

| 参数 | 说明 | 默认值 | |------|------|--------| | --model | 模型 ID | gpt-image-1.5 | | --size | 图片尺寸 | 1024x1024 | | --quality | 质量：auto/low/medium/high（DALL-E 3 为 standard/hd） | high | | --output-format | 输出格式：png/jpeg/webp | png | | -n | 生成数量 | 1 | | --api-key | API Key，默认从 OMNIROUTE_API_KEY 读取 | - | | --base-url | Base URL，默认 OMNIROUTE_BASE_URL | - |

MCP 工具：openai_image

Grok (xAI) — jimeng grok image

通过 OmniRoute 代理调用 xAI Grok 模型的文生图接口，使用 OpenAI 兼容的 /v1/images/generations。

# 文生图
jimeng grok image -p "a futuristic city"

# 指定模型
jimeng grok image -p "cyberpunk character" --model xai/grok-2-image --json

CLI 参数：

| 参数 | 说明 | 默认值 | |------|------|--------| | --model | 模型 ID | xai/grok-2-image | | --size | 图片尺寸 | 1024x1024 | | --output-format | 输出格式：png/jpeg/webp | png | | -n | 生成数量 | 1 | | --api-key | API Key，默认从 OMNIROUTE_API_KEY 读取 | - | | --base-url | Base URL，默认 OMNIROUTE_BASE_URL | - |

MCP 工具：grok_image

Veo / Seedance — jimeng veo video

通过 OmniRoute 代理调用 Google Veo 或 Seedance 视频生成模型，底层走 /v1/chat/completions 对话补全接口。

# 文生视频
jimeng veo video -p "a cat playing in the garden" --duration 5

# 指定模型和时长
jimeng veo video -p "ocean wave at sunset" --model veo-free/seedance --duration 10

# 图生视频
jimeng veo video -p "camera slowly pushes in" --image-url https://example.com/photo.jpg

可用模型：

| 模型 | 说明 | |------|------| | veo-free/veo | Google Veo（默认） | | veo-free/seedance | Seedance 视频 | | veoaifree-web/veo | Veo 网页版 | | veoaifree-web/seedance | Seedance 网页版 | | gemini/veo-3.1-generate-preview | Veo 3.1 预览 | | gemini/veo-3.1-fast-generate-preview | Veo 3.1 Fast 预览 | | gemini/veo-3.1-lite-generate-preview | Veo 3.1 Lite 预览 |

CLI 参数：

| 参数 | 说明 | 默认值 | |------|------|--------| | --model | 模型 ID | veo-free/veo | | --duration | 视频时长（秒），4~15 | 5 | | --resolution | 分辨率 | 720p | | --image-url | 参考图片 URL（图生视频） | - | | -n | 生成数量 | 1 | | --api-key | API Key，默认从 OMNIROUTE_API_KEY 读取 | - | | --base-url | Base URL，默认 OMNIROUTE_BASE_URL | - |

MCP 工具：veo_video

Hermes Agent / Skills

如果通过 hermes-agent 使用 CLI，请加载项目内的 skill 文档：

skills/jimeng-cli/SKILL.md

该 skill 只走 jimeng 命令行，不依赖 MCP；它包含生成前 token 预检、模型/区域选择、JSON 输出解析，以及 [登录失效]: check login error 这类登录失效问题的恢复流程。

MCP Server

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

npm run build
node dist/mcp/index.js

可用 MCP 工具：

| 工具名 | 说明 | 认证方式 | |--------|------|---------| | generate_image | 即梦文生图 | JIMENG_API_TOKEN | | upscale_image | 即梦图片放大 | JIMENG_API_TOKEN | | edit_image | 即梦图生图编辑 | JIMENG_API_TOKEN | | generate_video_flf | 即梦视频生成（首尾帧） | JIMENG_API_TOKEN | | generate_video_omni | 即梦多模态视频生成 | JIMENG_API_TOKEN | | ark_generate | Ark 视频生成 | ARK_API_KEY | | ark_edit | Ark 视频编辑 | ARK_API_KEY | | ark_extend | Ark 视频延长 | ARK_API_KEY | | ark_image | Ark 文生图 / 图文生图 | ARK_API_KEY | | cloudflare_image | Cloudflare Workers AI 图片 | CLOUDFLARE_API_TOKEN | | openai_image | OpenAI GPT-Image / DALL-E | OMNIROUTE_API_KEY | | grok_image | Grok / xAI 图片 | OMNIROUTE_API_KEY | | veo_video | Veo / Seedance 视频 | OMNIROUTE_API_KEY | | sora_video | OpenAI Sora 视频生成 | OPENAI_API_KEY | | get_task | 查询任务状态 | JIMENG_API_TOKEN | | wait_task | 等待任务完成 | JIMENG_API_TOKEN | | list_tasks | 历史任务列表 | JIMENG_API_TOKEN | | list_models | 可用模型列表 | JIMENG_API_TOKEN | | health_check | 健康检查 | - |

Claude Desktop 配置示例：

{
  "mcpServers": {
    "jimeng": {
      "command": "node",
      "args": ["/path/to/jimeng-cli/dist/mcp/index.js"],
      "env": {
        "JIMENG_API_TOKEN": "your_token",
        "ARK_API_KEY": "your_ark_key",
        "CLOUDFLARE_ACCOUNT_ID": "your_cf_account",
        "CLOUDFLARE_API_TOKEN": "your_cf_token",
        "OMNIROUTE_API_KEY": "your_omniroute_key",
        "OPENAI_API_KEY": "your_openai_key"
      }
    }
  }
}

环境变量：

| 变量 | 说明 | 默认值 | |------|------|--------| | JIMENG_API_TOKEN | 即梦 API token | - | | ARK_API_KEY | Ark API Key | - | | CLOUDFLARE_ACCOUNT_ID | Cloudflare 账户 ID | - | | CLOUDFLARE_API_TOKEN | Cloudflare API Token | - | | OMNIROUTE_API_KEY | OmniRoute 代理 API Key（OpenAI/Grok/Veo） | - | | OMNIROUTE_BASE_URL | OmniRoute 代理地址 | http://43.160.253.168:20128 | | OPENAI_API_KEY | OpenAI API Key（Sora 视频） | - | | 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