🎨 免费的AI图像和视频生成API服务 - 基于即梦AI（国内站）和dreamina（国际站）的逆向工程实现，提供与OpenAI API兼容的接口格式

• 🎨 AI图像生成: 支持多种模型和分辨率（默认2K，支持4K）
• 🖼️ 图生图合成: 支持多图混合、风格转换、内容合成
• 🎬 AI视频生成: 支持文本到视频生成
• 🌐 国际站支持: 新增对即梦国际站（dreamina）文生图API的支持，可能不稳定，有问题提issue
• 💬 聊天接口: OpenAI生图格式兼容的API
• 🔄 智能轮询: 自适应轮询机制，优化生成效率
• 🛡️ 统一异常处理: 完善的错误处理和重试机制
• 📊 详细日志: 结构化日志记录，便于调试
• 🐳 Docker支持: 容器化部署，开箱即用

• 此项目属于研究交流学习性质，不接受任何资金捐助和金钱交易！
• 仅限自用和个人研究，避免对官方造成服务压力，否则轻者可能封号，重者可能触犯法律！
• 仅限自用和个人研究，避免对官方造成服务压力，否则轻者可能封号，重者可能触犯法律！
• 仅限自用和个人研究，避免对官方造成服务压力，否则轻者可能封号，重者可能触犯法律！

现在通过ratio和resolution两个参数来共同控制图像尺寸，这提供了更高的灵活性。程序内resolution默认设置为2k。

curl -X POST http://localhost:5100/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_SESSION_ID" \
  -d '{
    "model": "jimeng-4.0",
    "prompt": "美丽的少女，胶片感",
    "ratio": "4:3",
    "resolution": "2k"
  }'

支持的resolution: 1k, 2k, 4k

支持的ratio: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9

• 国内站 (即梦)和国际站 (dreamina)获取sessionid的方法相同，见下图。

注意: 国内站和国际站api接口相同，但国际站的sessionid需要手动添加us-，比如Bearer us-xxxxx，才能访问国际站，否则默认国内站。

• Node.js 18+
• npm 或 yarn
• Docker (可选)

docker run -d \
  --name jimeng-api \
  -p 5100:5100 \
  --restart unless-stopped \
  iptag/jimeng:latest

# 克隆项目
git clone <repository-url>
cd jimeng-api

# 安装依赖
npm install

# 编译文件
npm run build

# 启动服务
npm run dev

# 使用docker-compose（推荐）
docker-compose up -d

# 或者手动构建和运行
docker build -t jimeng-api .

docker run -d \
  --name jimeng-api \
  -p 5100:5100 \
  --restart unless-stopped \
  jimeng-api

# 重新构建并启动
docker-compose up -d --build

# 查看服务日志
docker logs jimeng-api

# 停止服务
docker-compose down

# 进入容器调试
docker exec -it jimeng-api sh

• ✅ 多阶段构建：优化镜像大小（167MB）
• ✅ 非root用户：增强安全性（jimeng用户）
• ✅ 健康检查：自动监控服务状态
• ✅ 统一端口：容器内外均使用5100端口
• ✅ 日志管理：结构化日志输出

name: jimeng-api
route: src/api/routes/index.ts
port: 5100

requestLog: true
debug: false

除了支持国内版的即梦AI，项目现已集成对国际站 dreamina 的支持。

• 如何使用: 使用从国际站获取的 sessionid ，并且需要手动添加us-，比如Bearer us-xxxxx，才能访问国际站，否则默认国内站。

POST /v1/images/generations

请求参数:

• model (string): 使用的模型名称
• prompt (string): 图像描述文本
• ratio (string, 可选): 图像比例，默认为 "1:1"。支持的比例: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9。
• resolution (string, 可选): 分辨率级别，默认为 "2k"。支持的分辨率: 1k, 2k, 4k。
• negative_prompt (string, 可选): 负面提示词
• sample_strength (number, 可选): 采样强度 (0.0-1.0)
• response_format (string, 可选): 响应格式 ("url" 或 "b64_json")

# 默认参数（ratio: "1:1", resolution: "2k"）
curl -X POST http://localhost:5100/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_SESSION_ID" \
  -d '{
    "model": "jimeng-4.0",
    "prompt": "一只可爱的小猫咪"
  }'

# 使用4K分辨率的示例
curl -X POST http://localhost:5100/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_SESSION_ID" \
  -d '{
    "model": "jimeng-4.0",
    "prompt": "壮丽的山水风景，超高分辨率",
    "ratio": "16:9",
    "resolution": "4k"
  }'

支持的模型:

• jimeng-4.0
• jimeng-3.1
• jimeng-3.0
• jimeng-2.1
• jimeng-xl-pro

支持的比例及对应分辨率 ：

POST /v1/images/compositions

功能说明: 基于输入的一张或多张图片，结合文本提示词生成新的图片。支持图片混合、风格转换、内容合成等多种创作模式。

请求参数:

• model (string): 使用的模型名称
• prompt (string): 图像描述文本，用于指导生成方向
• images (array): 输入图片数组
• ratio (string, 可选): 图像比例，默认为 "1:1"。支持的比例: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9。
• resolution (string, 可选): 分辨率级别，默认为 "2k"。支持的分辨率: 1k, 2k, 4k。
• negative_prompt (string, 可选): 负面提示词
• sample_strength (number, 可选): 采样强度 (0.0-1.0)
• response_format (string, 可选): 响应格式 ("url" 或 "b64_json")

使用限制:

• 输入图片数量: 1-10张
• 支持的图片格式: JPG, PNG, WebP等常见格式
• 图片大小限制: 建议单张图片不超过10MB
• 生成时间: 通常30秒-5分钟，复杂合成可能需要更长时间

使用示例:

# 单图风格转换 (2K分辨率)
curl -X POST http://localhost:5100/v1/images/compositions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_SESSION_ID" \
  -d '{
    "model": "jimeng-4.0",
    "prompt": "将这张照片转换为油画风格，色彩鲜艳，笔触明显",
    "images": ["https://example.com/photo.jpg"],
    "ratio": "1:1",
    "resolution": "2k",
    "sample_strength": 0.7
  }'

# 多图混合合成 (4K分辨率)
curl -X POST http://localhost:5100/v1/images/compositions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_SESSION_ID" \
  -d '{
    "model": "jimeng-4.0",
    "prompt": "将这些图片融合成一幅梦幻的超现实主义作品",
    "images": [
      "https://example.com/landscape.jpg",
      "https://example.com/portrait.jpg"
    ],
    "ratio": "4:3",
    "resolution": "4k",
    "negative_prompt": "模糊，低质量，变形"
  }'

成功响应 (response_format: "url"):

{
  "created": 1703123456,
  "data": [
    {
      "url": "https://p3-sign.toutiaoimg.com/tos-cn-i-tb4s082cfz/abc123.webp"
    }
  ],
  "input_images": 2,
  "composition_type": "multi_image_synthesis"
}

成功响应 (response_format: "b64_json"):

{
  "created": 1703123456,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."
    }
  ],
  "input_images": 2,
  "composition_type": "multi_image_synthesis"
}

错误响应:

{
  "error": {
    "message": "图片上传失败: 网络连接超时",
    "type": "image_upload_error",
    "code": "UPLOAD_TIMEOUT"
  }
}

Q: 图片上传失败怎么办？ A: 检查图片URL是否可访问，确保图片格式正确，文件大小不超过10MB。

Q: 生成时间过长怎么办？ A: 复杂的多图合成需要更长时间，建议耐心等待。如果超过10分钟仍未完成，可以重新提交请求。

Q: 如何提高合成质量？ A:

• 使用高质量的输入图片
• 编写详细准确的提示词
• 适当调整 sample_strength 参数
• 避免使用过多冲突的图片风格

Q: 支持哪些图片格式？ A: 支持 JPG、PNG、WebP、GIF 等常见格式，推荐使用 JPG 或 PNG。

Q: 可以使用本地图片吗？ A: 需要先将本地图片上传到可访问的网络地址，然后使用该URL。

POST /v1/chat/completions

curl -X POST http://localhost:5100/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_SESSION_ID" \
  -d '{
    "model": "jimeng-video-3.0",
    "messages": [
      {
        "role": "user",
        "content": "生成一个海浪拍打海岸的视频"
      }
    ],
    "stream": true
  }'

支持的视频模型:

• jimeng-video-3.0-pro - 专业版
• jimeng-video-3.0 - 标准版
• jimeng-video-2.0-pro - 专业版v2
• jimeng-video-2.0 - 标准版v2

POST /v1/chat/completions

curl -X POST http://localhost:5100/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_SESSION_ID" \
  -d '{
    "model": "jimeng-4.0",
    "messages": [
      {
        "role": "user",
        "content": "画一幅山水画"
      }
    ]
  }'

{
  "created": 1759058768,
  "data": [
    {
      "url": "https://example.com/image1.jpg"
    },
    {
      "url": "https://example.com/image2.jpg"
    }
  ]
}

{
  "id": "chatcmpl-123",
  "object": "chat.completion",
  "created": 1759058768,
  "model": "jimeng-4.0",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "![image](https://example.com/generated-image.jpg)"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 20,
    "total_tokens": 30
  }
}

data: {"id":"chatcmpl-123","object":"chat.completion.chunk","created":1759058768,"model":"jimeng-4.0","choices":[{"index":0,"delta":{"role":"assistant","content":"🎨 图像生成中，请稍候..."},"finish_reason":null}]}

data: {"id":"chatcmpl-123","object":"chat.completion.chunk","created":1759058768,"model":"jimeng-4.0","choices":[{"index":1,"delta":{"role":"assistant","content":"![image](https://example.com/image.jpg)"},"finish_reason":"stop"}]}

data: [DONE]

jimeng-api/
├── src/
│   ├── api/
│   │   ├── controllers/          # 控制器层
│   │   │   ├── core.ts          # 核心功能（网络请求、文件处理）
│   │   │   ├── images.ts        # 图像生成逻辑
│   │   │   ├── videos.ts        # 视频生成逻辑
│   │   │   └── chat.ts          # 聊天接口逻辑
│   │   ├── routes/              # 路由定义
│   │   └── consts/              # 常量定义
│   │       ├── exceptions.ts    # 异常定义
│   │       └── common.ts        # 通用常量
│   ├── lib/                     # 核心库
│   │   ├── server.ts           # 服务器核心
│   │   ├── error-handler.ts    # 统一错误处理
│   │   ├── smart-poller.ts     # 智能轮询器
│   │   ├── aws-signature.ts    # AWS签名
│   │   └── exceptions/         # 异常类
│   ├── daemon.ts               # 守护进程
│   └── index.ts               # 入口文件
├── configs/                    # 配置文件
├── Dockerfile                 # Docker配置
└── package.json              # 项目配置

• 基于状态码自适应调整轮询间隔
• 多重退出条件，避免无效等待
• 详细的进度跟踪和日志记录

• 分类错误处理（网络错误、API错误、超时等）
• 自动重试机制
• 用户友好的错误提示

• 自动修复常见JSON格式问题
• 支持尾随逗号、单引号等非标准格式
• 详细的解析错误日志

export const POLLING_CONFIG = {
  MAX_POLL_COUNT: 900,    // 最大轮询次数 (15分钟)
  POLL_INTERVAL: 1000,    // 基础轮询间隔 (1秒)
  STABLE_ROUNDS: 5,       // 稳定轮次
  TIMEOUT_SECONDS: 900    // 超时时间 (15分钟)
};

export const RETRY_CONFIG = {
  MAX_RETRY_COUNT: 3,     // 最大重试次数
  RETRY_DELAY: 5000       // 重试延迟 (5秒)
};

1. JSON解析错误

   • 检查请求体格式是否正确
   • 系统会自动修复常见格式问题

2. Sessionid失效

   • 重新获取对应站点的Sessionid
   • 检查Sessionid格式是否正确

3. 生成超时

   • 图像生成：通常1-3分钟
   • 视频生成：通常3-15分钟
   • 系统会自动处理超时情况

4. 积分不足

   • 前往即梦/dreamina官网查看积分余额
   • 系统会提供详细的积分状态信息

本项目基于以下开源项目的贡献和启发：

• jimeng-free-api-all - 感谢该项目为即梦API逆向工程提供的重要参考和技术基础，本项目在其基础上进行了功能完善和架构优化

GPL v3 License - 详见 LICENSE 文件

本项目仅供学习和研究使用，请遵守相关服务条款和法律法规。使用本项目所产生的任何后果由使用者自行承担。