---
title: LongCat-Image
canonical_url: "https://www.modelscope.cn/studios/wwwzhouhui/LongCat-Image"
md_url: "https://www.modelscope.cn/studios/wwwzhouhui/LongCat-Image.md"
repository: wwwzhouhui/LongCat-Image
chinese_name: "美团 LongCat-Image文生图和图生图"
last_updated: 2025-12-14
sdk_type: gradio
sdk_version: 5.49.1
downloads: 0
stars: 12
---

# LongCat-Image

> LongCat-Image - wwwzhouhui 在 ModelScope 创建的在线 Demo。基于美团 LongCat-Image 的 AI 驱动文生图和图生图工具。

wwwzhouhui/LongCat-Image 是 ModelScope 魔搭社区上的在线可交互 Demo（创空间），基于 gradio 5.49.1 构建，中文名为「美团 LongCat-Image文生图和图生图」。

- **Repository**: wwwzhouhui/LongCat-Image
- **SDK**: gradio
- **SDK version**: 5.49.1
- **Downloads**: 0
- **Stars**: 12
- **Last updated**: 2025-12-14

Source: https://www.modelscope.cn/studios/wwwzhouhui/LongCat-Image

---

<img src="../../scnet/LongCat-Image/longcat.png" width="160" height="160" style="vertical-align: middle;" alt="LongCat Logo"/>

基于美团 LongCat-Image 的 AI 驱动文生图和图生图工具。

[![Python](https://mypicture-1258720957.cos.ap-nanjing.myqcloud.com/Obsidian/Python-3.8%2B-blue.svg)](https://www.python.org/downloads/)
[![Gradio](https://img.shields.io/badge/Gradio-4.0+-green.svg)](https://gradio.app/)
[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

## ✨ 功能特性

### 文生图 (Text-to-Image)

- 基于 LongCat-Image 模型
- 支持中英文提示词
- 支持负向提示词过滤
- 支持多种艺术风格
- 支持多张图片生成
- 自动保存到本地

### 图生图 (Image-to-Image)

- 基于 LongCat-Image-Edit 模型
- 上传图片进行修改和增强
- 支持多种修改提示
- 支持多种艺术风格
- **连续修改功能**：可将生成结果复制到输入区继续修改
- 自动保存到本地

### 支持的艺术风格

| 风格代码    | 风格名称 | 说明             |
| ----------- | -------- | ---------------- |
| no-style    | 原图     | 不限制风格       |
| 3d-cute     | 3D可爱   | 3D可爱风格       |
| ghibli      | 吉卜力   | 吉卜力动漫风格   |
| anime       | 动漫     | 动漫风格         |
| pixel-art   | 像素风   | 像素艺术风格     |
| disney      | 迪士尼   | 迪士尼动画风格   |
| pixar       | 皮克斯   | 皮克斯3D动画风格 |
| realistic   | 写实     | 写实风格         |
| chibi-emoji | 表情包   | 表情包风格       |
| instax      | 拍立得   | 拍立得照片风格   |

## 🚀 快速开始

### 环境要求

- Python 3.8+
- 有效的 LongCat API Token

### 安装依赖

```bash
pip install gradio requests openai python-dotenv pillow requests-toolbelt
```

### 配置 API Token

1. 复制环境变量示例文件：

```bash
cp .env.example .env
```

2. 编辑 `.env` 文件，填入你的 API Token：

```bash
LONGCAT_API_TOKEN=你的_API_Token
```

### 启动应用

```bash
python app.py
```

访问地址：http://localhost:7890

## ⚙️ 配置说明

### 环境变量 (.env)

```bash
# ==================== LongCat API 配置 ====================

# LongCat API 基础地址
LONGCAT_API_URL=https://ai.gitee.com/v1

# LongCat API Token
# ⚠️ 请替换为你的实际 API Token
LONGCAT_API_TOKEN=aaaaaaaa

# ==================== 模型配置 ====================

# 文生图模型名称
LONGCAT_TEXT_TO_IMAGE_MODEL=LongCat-Image

# 图生图模型名称
LONGCAT_IMAGE_TO_IMAGE_MODEL=LongCat-Image-Edit

# ==================== IP 限制配置 ====================

# 每个公网IP每日最大请求次数
IP_DAILY_LIMIT=10
```

### 获取 API Token

请访问美团 AI 平台获取你的 LongCat API Token。

## 📖 使用指南

### 文生图操作步骤

1. 打开"✨ 文生图"选项卡
2. 在"提示词"文本框中输入描述（例如："一只可爱的小猫在花园里玩耍"）
3. 可选：输入负向提示词（例如："模糊、低质量"）
4. 选择艺术风格（可选）
5. 点击"✨ 生成图片"按钮
6. 等待图片生成完成

### 图生图操作步骤

1. 打开"🖼️ 图生图"选项卡
2. 上传一张图片（拖拽或点击上传）
3. 在"修改提示词"文本框中输入修改描述（例如："添加一顶红色的帽子"）
4. 可选：输入负向提示词
5. 选择艺术风格（可选）
6. 点击"🎨 生成图片"按钮
7. 等待图片生成完成
8. 可选：点击"📋 复制到输入区继续修改"进行连续修改

### 连续修改图片

图生图功能支持对同一张图片进行多次修改：

1. 生成第一版图片
2. 点击"📋 复制到输入区继续修改"按钮
3. 图片将自动复制到输入区
4. 输入新的修改提示词
5. 再次生成

## ⚠️ API 限制

### 当前限制

- **宽高比**：当前版本的 LongCat API 不支持自定义宽高比
- **图片尺寸**：使用 API 默认尺寸（通常为 1024x1024）
- **请求频率**：每个公网IP每日最多 10 次请求
- **配额重置**：每日凌晨自动重置

### UI 说明

虽然界面中仍显示宽高比选项，但实际不会生效。这是 API 限制，非应用问题。

## 🏗️ 技术架构

- **前端框架**：Gradio
- **后端语言**：Python
- **HTTP 客户端**：Requests + OpenAI 客户端
- **文生图接口**：OpenAI 兼容接口
- **图生图接口**：MultipartEncoder 表单上传 (requests-toolbelt)
- **图片存储**：本地文件系统 (`generated_images/`)
- **访问控制**：基于公网IP的请求限制 (IPRateLimiter)
- **Logo 显示**：Base64 编码嵌入，确保跨环境兼容

### 推理参数

- `num_inference_steps`: 40 (推理步数)
- `guidance_scale`: 4.5 (引导系数)

## 📁 项目结构

```
LongCat-Image/
├── app.py                  # 主应用代码
├── longcat.png             # LongCat Logo
├── .env.example            # 环境变量示例
├── .gitignore              # Git 忽略规则
├── generated_images/       # 生成的图片目录
├── ip_request_log.json     # IP 请求日志
├── README.md               # 项目文档
```

## 📝 版本历史

### v2.0.6 (2025-12-14)

- 🔧 修复 Logo 图片显示不完整问题
- 🖼️ 使用 Base64 编码嵌入图片，确保在 Gradio 中正确显示
- 📝 修复 README 环境变量名称拼写错误
- 📦 补充 `requests-toolbelt` 依赖说明

### v2.0.5 (2025-12-14)

- 🎨 进一步优化图片显示效果
- 📏 增大图片尺寸：界面(120px), README(160px)
- ✨ 添加垂直对齐样式和高度属性

### v2.0.4 (2025-12-14)

- 🔧 修复 LongCat Logo 图片显示不全问题
- 📏 增大图片显示尺寸：README(128px), 界面(80px)

### v2.0.3 (2025-12-14)

- 🖼️ 使用 LongCat Logo 替换标题中的 🎨 Emoji
- 🎨 在界面中显示 LongCat 品牌图片

### v2.0.2 (2025-12-14)

- ✅ 修复图生图"复制到输入区"按钮错误
- ✅ 优化 Gradio 组件数据传递

### v2.0.1 (2025-12-14)

- ✅ 修复文生图 `size` 参数兼容性问题
- ✅ 更新 UI 提示，标注 API 限制

### v2.0 (2025-12-14)

- ✨ 从 Jimeng-4.5 迁移到 LongCat-Image API
- ✨ 支持文生图和图生图功能
- ✨ 添加 IP 限制机制

## 🧪 测试

运行基本测试：

```bash
# 语法检查
python -c "import ast; ast.parse(open('app.py').read())" && echo "✅ 语法检查通过"

# 模块导入测试
python -c "from app import NanoBananaApp; print('✅ 模块导入成功')"
```

详细测试指南请参考：`TEST_v2.0.2.md`

## 🔧 故障排除

### 常见问题

**1. API Token 无效**

- 检查 `.env` 文件中的 Token 是否正确
- 确认 Token 未过期
- 验证 Token 权限

**2. 无法访问应用**

- 确认端口 7890 未被占用
- 检查防火墙设置
- 尝试访问 `http://localhost:7890`

**3. 图片生成失败**

- 检查网络连接
- 验证 API Token 有效性
- 查看应用日志错误信息

**4. IP 限制问题**

- 每个公网IP每日限制 10 次
- 配额每日凌晨自动重置
- 局域网访问会降级处理

### 日志位置

- 应用启动日志：控制台输出
- IP 请求日志：`ip_request_log.json`
- 生成图片：`generated_images/` 目录

## 📊 性能优化

- 图片自动保存到本地，避免重复生成
- IP 限制防止滥用
- 异步处理提升响应速度
- 错误重试机制

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

## 📄 许可证

本项目采用 MIT 许可证。

## 🔗 相关链接

- [LongCat API 文档](https://ai.gitee.com/)
- [Gradio 官方文档](https://gradio.app/)
- [Python Requests 库](https://docs.python-requests.org/)

## 📞 支持

如有问题，请：

1. 查看 `CHANGES.md` 了解最新变更
2. 查看 `FIX_*.md` 了解已知问题修复
3. 检查应用日志获取详细错误信息

---

**版本**: v2.0.6
**最后更新**: 2025-12-14
**状态**: ✅ 稳定可用

⭐ 如果这个项目对你有帮助，请给它一个星标！