Jimeng CLI API Wrapper

本项目致力于将火山即梦底层的 CLI 命令工具，转化为符合 OpenAI / 标准规范的 API 接口，从而可以无缝接入到现有的任何工作流中（包含对 seedance2.0、VIP 调用的支持）。

⚠️ 免责与版权声明 (必读)

1. 协议说明：本项目核心封装代码（包含路由、控制台面板等）基于 MIT 协议 开源。
2. 官方组件隔离：本项目不包含任何火山即梦或字节跳动官方的闭源 CLI 可执行文件或商业资产。
3. 自行部署 CLI：拉取本项目代码后，你需要自行前往官方或授权渠道下载 jimeng-cli 二进制程序，并放置在项目指定的 bin/ 目录下（具体视你的操作系统而定）。因使用官方 CLI 造成的任何封号、数据问题或法律纠纷，本项目概不负责。

🚀 快速开始指引 (保姆级教程)

要想让这个 API 跑起来，底层依赖 「官方即梦 CLI」。

⚠️ CLI 版本要求：请使用 dreamina.exe / dreamina v1.4.2 或以上版本。
新版 CLI 将 submit_id 从旧版 16 位 hex 升级为 UUID 格式，本项目 v2.0.0 起完整适配新格式。
旧版 CLI 与当前轮询逻辑不兼容，会导致任务状态永远无法更新。
下载地址：👉 官方即梦 CLI 下载文档

由于大家用的电脑和系统不一样，下面分为 Windows 快速部署 和 Linux 服务器部署。

💻 Windows 一键快速部署 (适合小白)

批处理文件说明：

• start.bat：一键运行脚本。它会检测并自动安装 Node.js、自动从官方拉取最新版的即梦 CLI（dreamina.exe） 并放入 bin 目录、初始化数据库，并直接启动 API 服务。小白用户只需双击这个文件就可以把服务跑起来！
• pack.bat：一键打包发布脚本。如果你想把这个项目发给别人运行，双击此脚本，它会过滤掉所有源码，自动编译压缩出一个 jimeng-deploy.zip。别人解压后跑刚才的 start.bat 就能立刻使用，避免还要配置复杂的开发环境。

快速体验步骤：

1. 获取代码：下载本项目代码压缩包并解压，或者使用 git clone。
2. 一键运行：双击项目根目录下的 start.bat 文件。脚本会帮你搞定所有前置所需环境。
3. 访问面板：启动成功后，浏览器打开 http://localhost:3000 即可看到控制台面板。
4. 后台登录：默认的管理员初始密码为 admin。请登录后第一时间去后台改掉！

---

🐧 Linux 服务器部署 (适合极客与生产环境)

如果你想把它部署在云服务器（Ubuntu / CentOS）上：

1. 安装环境：请确保服务器已安装 Node.js (v18+) 和 npm。
2. 下载即梦 CLI：登录服务器终端，在本项目根目录执行官方提供的安装脚本：

   curl -fsSL https://jimeng.jianying.com/cli | bash

3. 启动项目：

   # 安装依赖
   npm install
   
   # 复制并配置环境变量
   cp .env.example .env
   
   # 初始化数据库表结构
   npx prisma db push
   
   # 运行（推荐使用 pm2 守护进程）
   npm run build
   npm run start

⚠️ 重要使用限制与个人声明 (必读)

【即梦官方限制说明】

1. 必须拥有即梦 VIP 账号：受限于即梦 CLI 的官方业务策略，用户首先必须要拥有自己的即梦账号，并且该账号必须拥有 VIP 会员资格才能调度底层高级模型（如 seedance2.0 等）。
2. 限免时间说明：当前 API 体验期限制在 2026年5月1日之前，后续是否能够继续使用 API 能力，取决于即梦官方 CLI 工具是否继续对外开放服务。

【开发者声明】

1. 本代码库的开发初衷仅为了解决个人工作流无法接入即梦API的痛点，用作个人学习、研究与工作自动化流转之用。
2. 请勿违法使用，由于任何人非法滥用、商用牟利、或违背即梦官方服务条款进行调用等行为造成的一切严重后果与财产损失，均与本仓库作者无关。如果您不同意此声明，请立即删除本代码。

� 后台管理与操作指南

系统跑起来后，你需要进入管理后台绑定即梦 VIP 账号 和 生成 API 令牌。 后台控制台主要功能：

• 内部账号池：绑定与管理即梦 VIP 账号，支持 OAuth Device Flow 授权、一键检测状态与余额。
• API 令牌分发：生成、停用、删除 API Key，可绑定指定账号或走公共账号池。
• 任务管理：查看所有生成任务的实时状态（PENDING / PROCESSING / SUCCESS / FAILED），支持按状态筛选、查看 submit_id / logid 等调试信息，管理员可手动强制失败或重试任务。
• 管理员安全：修改后台登录密码。 我们准备了非常详细的图文保姆级操作手册： 👉 点击查阅《即梦Cli_api - 后台管理使用手册》

---

�📚 目录结构简解

• src/: 后端 API 的核心路由与控制器。
• frontend/: 如果本项目带有配套的可视化前端界面，源码在此目录。
• data/: (不可提交至 GitHub) 用于保存本地数据库文件及用户账号。
• bin/: (不可提交至 GitHub) 用于存放您自己的官方即梦 CLI 程序。
• docs/: 存放详尽的开发与接入文档，例如《API集成文档.md》与《即梦CLI体验指南》。

🔄 更新日志 (Changelog)

v2.0.0 (2026-04-24)

• 🔧 [核心] 适配即梦 CLI v1.4.2：新版 CLI 将 submit_id 从 16 位 hex 升级为 UUID 格式，本版本完整适配，旧格式作 fallback 兼容。
• 🔧 logid 持久化：任务提交时同步提取并保存 CLI 返回的 logid，便于问题追踪。
• 🗄️ 数据库新增 jimengLogId 字段，升级包含自动迁移脚本。
• 🆕 管理后台「任务管理」分页：查看/筛选所有任务，支持强制失败、重试、详情弹窗（submit_id / logid 可复制）。
• 🆕 24h 超时自动失败：PROCESSING 超过 24 小时的任务在下次轮询时自动标记 FAILED。

v1.0.1 (2026-04-20)

• 🐛 Bug修复：修复了 OpenAI 格式生视频接口中，当仅上传图片（无音视频附件）并指定 seedance2.0 等多模态模型时，因附件类型判定错误导致路由掉入普通多帧/单图模式（默认 3.0 fast）的问题。现在只要指定了多模态模型，将强制且正确地自动路由至多模态通道，极大提升了 API 的模型兼容性与调度准确度。

🤝 技术交流与反馈

欢迎加入我们的技术交流 QQ 群，讨论 API 接入、工作流搭建等技术问题：

• 技术讨论 QQ 群：691588657

📄 License

基于 MIT License 开源发布。 作者：XiaoYue 43854695@qq.com