Skip to main content
Glama

二次元美图生成器

基于火山方舟 ARK doubao-seedream 与 Agnes Image 2.1 Flash 的二次元/CG 高质量图片生成工具,支持文生图、图生图、多图生图、组图生成(仅 ARK),内置 16 种风格预设,支持风格一致性管理,同时提供 Web UI 和 MCP 服务器两种使用方式。

特性

  • 双引擎支持 - 火山方舟 ARK (doubao-seedream) + Agnes Image 2.1 Flash

  • 文生图 - 文本提示词 -> 单张高质量二次元美图

  • 图生图 - 单张参考图 + 文本 -> 单张图片(保持姿势/构图,改变风格/内容)

  • 多图生图 - 2-14 张参考图 + 文本 -> 单张图片

  • 组图生成(ARK) - 生成一组内容关联的图片(sequential_image_generation: auto)

  • 宽高比控制(Agnes) - 1:1 / 3:4 / 4:3 / 16:9 / 9:16 / 2:3 / 3:2 / 21:9

  • 16 种风格预设 - CG厚涂、唯美水彩、赛博朋克、新海诚光影、古风国潮、暗黑哥特、概念艺术等

  • 风格一致性 - 通过风格配置文件确保多张图片风格统一

  • 智能提示词引擎 - 自动组合用户提示词 + 风格后缀 + 构图 + 光线 + 质量增强词

  • Web UI - 暗色主题,支持拖拽上传参考图、引擎切换、模式切换、组图展示

  • MCP 服务器 - 14 个工具,供 AI 智能体调用全部生成能力

  • REST API - 完整的 RESTful API

Related MCP server: jimeng_visual_generation

快速开始

1. 安装依赖

cd D:\projects\image_MCP
pip install -r requirements.txt

2. 配置 API Key

copy .env.example .env

编辑 .env 文件:

# Agent Plan API(文生图 + 图生图 + 组图,doubao-seedream-5.0-lite 全部支持)
AGENT_API_KEY=your_agent_api_key_here

# 标准 API(可选,图生图/组图时使用更强的 pro 模型)
ARK_API_KEY=your_standard_api_key_here

# Agnes Image(可选,文生图/图生图,支持宽高比)
AGNES_API_KEY=your_agnes_api_key_here

只需 AGENT_API_KEY 即可使用全部 ARK 功能:文生图、图生图、多图生图、组图生成(doubao-seedream-5.0-lite 全部支持)。配置 ARK_API_KEY 后,图生图/组图会自动切换到更强的 doubao-seedream-5-0-pro-260628 模型。Agnes 为可选的第二引擎。

3. 启动 Web 服务

python main.py

访问 http://127.0.0.1:8765

4. 启动 MCP 服务器

python mcp_server.py

MCP 配置

opencode

{
  "mcp": {
    "anime-image-mcp": {
      "type": "local",
      "command": ["python", "D:/projects/image_MCP/mcp_server.py"]
    }
  }
}

Claude Code

{
  "mcpServers": {
    "anime-image-mcp": {
      "command": "python",
      "args": ["D:/projects/image_MCP/mcp_server.py"]
    }
  }
}

MCP 工具列表

工具名

描述

generate_anime_image

生成单张图片(文生图/图生图/多图生图,支持 ark/agnes)

generate_sequence

生成一组内容关联的组图(仅 ARK)

generate_batch

批量生成多张独立图片

generate_with_profile

使用风格配置文件生成(保持风格一致性)

list_styles

列出所有风格预设

get_style_detail

获取风格预设详情

list_compositions

列出构图预设

list_lightings

列出光线预设

list_providers

列出可用生成引擎(ark/agnes)

list_ratios

列出宽高比预设(Agnes)

create_style_profile

创建风格配置文件

preview_prompt

预览完整提示词

get_history

获取生成历史

get_image_info

获取指定图片信息

生成引擎说明

引擎

模型

支持功能

尺寸

宽高比

ARK

doubao-seedream-5.0-lite / 5.0-pro

文生图、图生图、多图生图、组图生成、水印、格式选择

1K / 2K / 4K

Agnes

agnes-image-2.1-flash

文生图、图生图、高信息密度优化

1K / 2K / 3K / 4K

1:1 / 3:4 / 4:3 / 16:9 / 9:16 / 2:3 / 3:2 / 21:9

生成模式说明

模式

参考图

sequential_image_generation

输出

说明

文生图

disabled

单张

文本 -> 图片

单图生图

1张

disabled

单张

参考图+文本 -> 图片

多图生图

2-14张

disabled

单张

多参考图+文本 -> 图片

文生组图

auto

多张(≤15)

文本 -> 一组关联图片

单图生组图

1张

auto

多张(≤14)

参考图+文本 -> 一组关联图片

多图生组图

2-14张

auto

多张(≤15-参考图数)

多参考图+文本 -> 一组关联图片

风格预设

ID

名称

分类

cg_thick_paint

CG厚涂

CG数字绘画

watercolor_dream

唯美水彩

艺术质感

cyberpunk_neon

赛博朋克

场景氛围

fantasy_epic

幻想史诗CG

CG数字绘画

anime_fresh

日系清新

动漫风格

dark_gothic

暗黑哥特

特殊风格

oil_classical

古典油画

艺术质感

shinkai_style

新海诚光影

动漫风格

concept_art

概念艺术

CG数字绘画

chinese_guochao

古风国潮

特殊风格

cel_shading

赛璐璐动画

动漫风格

pastel_soft

粉彩柔光

艺术质感

dark_fantasy

暗黑幻想

CG数字绘画

chibi_cute

Q版萌系

动漫风格

ukiyo_modern

浮世绘现代

艺术质感

studio_portrait

影棚肖像

CG数字绘画

REST API

方法

路径

说明

GET

/api/styles

获取风格预设列表

GET

/api/styles/{id}

获取风格详情

GET

/api/compositions

获取构图预设

GET

/api/lightings

获取光线预设

POST

/api/generate

生成单张图片(支持参考图)

POST

/api/generate/sequence

生成组图

POST

/api/generate/batch

批量生成

POST

/api/generate/profile

使用风格配置文件生成

POST

/api/profile/create

创建风格配置文件

POST

/api/preview-prompt

预览完整提示词

POST

/api/upload

上传参考图片

GET

/api/history

获取历史记录

GET

/api/history/{id}

获取指定记录

DELETE

/api/history/{id}

删除指定记录

DELETE

/api/history

清空历史

GET

/api/images/{filename}

获取图片文件

GET

/api/uploads/{filename}

获取上传的参考图

API 文档:http://127.0.0.1:8765/docs

项目结构

image_MCP/
├── main.py              # FastAPI Web 服务入口
├── mcp_server.py        # MCP 服务器入口
├── config.py            # 配置管理(双 API 支持)
├── prompt_styles.py     # 提示词引擎(16种风格预设)
├── image_generator.py   # 核心生成器(文生图/图生图/组图)
├── requirements.txt
├── .env.example
├── static/              # Web UI
│   ├── index.html
│   ├── style.css
│   └── app.js
├── output/              # 生成图片存储
│   └── uploads/         # 上传的参考图
└── data/
    └── history.json

使用示例

Python - 图生图

from image_generator import get_generator

gen = get_generator()
result = gen.generate(
    user_prompt="保持姿势不变,将服装材质改为透明清水",
    style_id="cg_thick_paint",
    reference_images="https://example.com/ref.png",
)
print(f"图片已保存: {result.local_path}")

Python - 组图生成

from image_generator import get_generator

gen = get_generator()
results = gen.generate_sequence(
    user_prompt="生成3张女孩在游乐园的图片,涵盖早晨、中午、晚上",
    style_id="anime_fresh",
    max_images=3,
    reference_images=["https://example.com/ref1.png", "https://example.com/ref2.png"],
)
for r in results:
    print(f"图片 {r.sequence_index + 1}/{r.sequence_total}: {r.local_path}")

Python - Agnes 引擎

from image_generator import get_generator
from prompt_styles import PROVIDER_AGNES

gen = get_generator()

# 文生图(16:9 宽屏)
result = gen.generate(
    user_prompt="日出时分薄雾峡谷上方的发光浮空城市,电影级写实风格,广角构图",
    provider=PROVIDER_AGNES,
    size="2K",
    ratio="16:9",
)
print(f"图片已保存: {result.local_path}")

# 图生图(构图保留)
result = gen.generate(
    user_prompt="将场景改为赛博朋克夜景,保留原始构图",
    provider=PROVIDER_AGNES,
    reference_images="https://example.com/input.png",
    size="2K",
    ratio="3:4",
)
print(f"图片已保存: {result.local_path}")

cURL - 组图生成

curl -X POST http://127.0.0.1:8765/api/generate/sequence \
  -H "Content-Type: application/json" \
  -d '{"user_prompt": "生成3张猫咪在不同场景的图片", "max_images": 3, "style_id": "pastel_soft"}'

技术栈

  • 后端: Python + FastAPI + Uvicorn

  • AI 模型: 火山方舟 ARK doubao-seedream + Agnes Image 2.1 Flash

  • MCP: 纯 Python 实现 JSON-RPC 2.0 (无需 mcp 包)

  • 前端: 原生 HTML/CSS/JS

环境要求

  • Python 3.10+

  • 至少配置以下 API Key 之一:

Related MCP Connectors

Related MCP Servers