内容
# 照片拍摄 AI 设计
[](https://opensource.org/licenses/MIT)
[](https://modelcontextprotocol.io)
[](https://claude.ai/code)
[](https://pi.agent)
[](https://github.com/vllm-project/openllm)
> AI 驱动的照片拍摄设计工具，支持 MCP 服务器、可重用技能和智能代理。支持 WaveSpeed AI、Nano Banana、OpenAI、Stability AI 和 PhotoShoot 应用集成。
[**快速设置 →**](SETUP.md) | [文档 →](docs/) | [示例 →](examples/)
## 概述
照片拍摄 AI 设计通过模型上下文协议（MCP）为 [photoshoot.app](https://photoshoot.app/) 平台扩展了高级 AI 代理功能。该项目为多个 AI 图像生成服务提供了一个统一的接口，使得电商、时尚、营销和肖像等领域的照片拍摄自动化变得轻松。
## 功能
### AI 提供商集成
无缝切换多个 AI 提供商：
| 提供商 | 模型 | 最适合 | 定价 |
| --- | --- | --- | --- |
| [WaveSpeed AI](https://wavespeed.ai) | 700+ 模型，包括 FLUX、Stable Diffusion、Kling、Veo、Sora | 产品摄影、视频内容 | 有竞争力的费率 |
| [Nano Banana](https://ai.google.dev/gemini-api/docs/image-generation) | Google Gemini 的原生图像生成 | 时尚、OOTD、生活方式 | ~$0.02/图像 |
| [OpenAI](https://platform.openai.com) | DALL-E 3、GPT-4 | 专业肖像、创意概念 | 标准 OpenAI 定价 |
| [Stability AI](https://platform.stability.ai) | Stable Diffusion XL | 自定义样式、艺术内容 | $0.004-$0.02/图像 |
| [PhotoShoot 应用](https://photoshoot.app) | 专有照片拍摄模型 | 电商、品牌一致性 | 平台定价 |
| [fal.ai](https://fal.ai) | 快速推理 | 快速原型设计、批量处理 | 按使用付费 |
### MCP 工具
完整的模型上下文协议工具集：
- **`photoshoot_generate`** - 从文本或参考图像生成 AI 照片
- **`photoshoot_edit`** - 编辑和增强现有图像
- **`photoshoot_template`** - 获取可用的模板和样式
- **`photoshoot_batch`** - 批量处理多个图像
- **`photoshoot_variations`** - 生成图像变体
- **`photoshoot_upscale`** - 将图像缩放至更高分辨率
### 技能系统
用于常见设计工作流的模块化、可重用技能：
| 技能 | 描述 | 用例 |
| --- | --- | --- |
| [`product-photography`](packages/skills/product-photography.md) | 专业产品照片生成 | 电商、产品列表、目录 |
| [`ootd-fashion`](packages/skills/ootd-fashion.md) | 时尚和生活方式内容创作 | Instagram、TikTok、Pinterest 时尚 |
| [`image-enhancement`](packages/skills/image-enhancement.md) | AI 驱动的照片编辑和修饰 | 后期处理、优化 |
| [`brand-style`](packages/skills/brand-style.md) | 品牌一致的视觉生成 | 活动、营销材料 |
| [`batch-production`](packages/skills/batch-production.md) | 大批量批量处理 | 目录生产、批量操作 |
### AI 代理
用于复杂工作流的自主代理：
**DesignerAgent**
- 分析参考图像并提取样式参数
- 根据品牌指南生成照片
- 创建平台特定内容（Amazon、Instagram、TikTok）
- 管理模板库
**OptimizerAgent**
- 批量图像增强
- 平台优化（Amazon、Shopify、社交媒体）
- 背景移除和替换
- 水印和格式化
## 安装
### 快速开始（3 分钟）
```bash
# 克隆仓库
git clone git@github.com:photoshootapp/photoshoot-ai-design.git
cd photoshoot-ai-design
# 安装依赖
npm install
# 配置 API 密钥
cp .env.example .env
# 编辑 .env 并添加您的 API 密钥
# 启动 MCP 服务器
npm run mcp:start
```
参见 [SETUP.md](SETUP.md) 获取详细的设置说明和 API 密钥获取。
### Claude 代码插件
```bash
# 从插件市场安装
claude plugin install photoshoot-ai-design
# 或在 .claude/settings.json 中手动配置
{
"mcpServers": {
"photoshoot": {
"command": "node",
"args": ["packages/mcp-server/dist/index.js"],
"cwd": "/path/to/photoshoot-ai-design"
}
}
}
```
### Pi 代理插件
```bash
pi-agent plugin add photoshoot-ai-design
```
### OpenLLM 插件
```python
import openllm
plugin = openllm.load_plugin("photoshoot-ai-design")
model = openllm.start("vllm/nano-banana", plugins=[plugin])
```
## 用法
### MCP 工具示例
```typescript
// 生成产品摄影
await mcpClient.callTool({
name: "photoshoot_generate",
arguments: {
type: "product",
provider: "wavespeed",
prompt: "无线耳机的专业产品照片",
style: "studio",
quantity: 4
}
});
// 生成 OOTD 时尚内容
await mcpClient.callTool({
name: "photoshoot_generate",
arguments: {
type: "ootd",
provider: "nano-banana",
prompt: "街头时尚照片拍摄，城市环境",
style: "vibrant",
quantity: 6
}
});
// 编辑和增强图像
await mcpClient.callTool({
name: "photoshoot_edit",
arguments: {
image: "https://example.com/product.jpg",
provider: "auto",
edits: {
lighting: "studio",
background: "white",
retouch: true
}
}
});
```
### 技能示例
```bash
# 产品摄影
/photoshoot-design product --reference="product.jpg" --style=studio --platform=amazon
# OOTD 时尚
/photoshoot-design ootd --reference="outfit.jpg" --style=streetwear --location=urban
# 图像增强
/photoshoot-design enhance --image="photo.jpg" --intensity=medium
```
### 代理示例
```typescript
import { DesignerAgent, createPhotoShootClient } from '@photoshoot/agents';
const client = await createPhotoShootClient();
const agent = new DesignerAgent(client, {
defaultStyle: 'studio',
defaultQuantity: 4
});
// 生成产品摄影
await agent.generateProductPhotography({
productImage: 'shoe.jpg',
style: 'minimalist',
platform: 'amazon',
quantity: 8
});
// 创建 OOTD 内容
await agent.createOOTDContent({
outfitImage: 'outfit.jpg',
style: 'luxury',
location: 'rooftop',
vibe: 'chic'
});
// 优化平台
await agent.optimizeForPlatform({
images: ['img1.jpg', 'img2.jpg'],
platform: 'instagram'
});
```
## 架构
```
photoshoot-ai-design/
├── packages/
│ ├── mcp-server/ # MCP 服务器，包含所有 AI 提供商
│ │ ├── src/
│ │ │ ├── api/clients/ # 个别 API 客户端
│ │ │ │ ├── wavespeed.ts
│ │ │ │ ├── nanobanana.ts
│ │ │ │ ├── openai.ts
│ │ │ │ ├── stability.ts
│ │ │ │ ├── photoshoot.ts
│ │ │ │ └── fal.ts
│ │ │ ├── config.ts
│ │ │ └── index.ts
│ │ └── .env.example
│ │
│ ├── mcp-client/ # MCP 客户端 SDK
│ ├── skills/ # 技能定义（Markdown）
│ ├── agents/ # AI 代理实现
│ │
│ └── plugins/
│ ├── claude-code/ # Claude 代码插件
│ ├── pi-agent/ # Pi 代理插件
│ └── openllm/ # OpenLLM 插件
│
├── docs/ # 文档
├── examples/ # 用法示例
├── .env.example # 环境配置模板
├── SETUP.md # 快速设置指南
└── README.md # 本文件
```
## API 参考
### MCP 工具
#### `photoshoot_generate`
使用 AI 生成照片拍摄图像。
```typescript
{
type: 'product' | 'ootd' | 'portrait',
provider?: 'wavespeed' | 'nano-banana' | 'openai' | 'stability' | 'auto',
prompt: string,
reference?: string,
style?: string,
quantity?: number,
width?: number,
height?: number
}
```
#### `photoshoot_edit`
编辑和增强图像。
```typescript
{
image: string,
provider?: 'wavespeed' | 'nano-banana' | 'openai' | 'stability' | 'auto',
prompt?: string,
edits?: {
lighting?: string,
background?: string,
retouch?: boolean,
enhance?: boolean
}
}
```
#### `photoshoot_batch`
批量处理多个图像。
```typescript
{
images: string[],
operation: 'enhance' | 'resize' | 'format' | 'watermark' | 'remove-background',
options?: Record<string, unknown>
}
```
## 配置
### 环境变量
```bash
# WaveSpeed AI（推荐用于产品摄影）
WAVESPEED_API_KEY=your_key_here
WAVESPEED_API_URL=https://api.wavespeed.ai/v1
# Nano Banana（Google Gemini - 推荐用于时尚）
NANO_BANANA_API_KEY=your_key_here
NANO_BANANA_API_URL=https://generativelanguage.googleapis.com/v1beta
# OpenAI（DALL-E）
OPENAI_API_KEY=your_key_here
OPENAI_API_URL=https://api.openai.com/v1
# Stability AI（Stable Diffusion）
STABILITY_API_KEY=your_key_here
STABILITY_API_URL=https://api.stability.ai/v1
# PhotoShoot 应用
PHOTOSHOOT_API_KEY=your_key_here
PHOTOSHOOT_API_URL=https://api.photoshoot.app
# fal.ai
FAL_API_KEY=your_key_here
FAL_API_URL=https://fal.ai
```
### 提供商选择
系统根据以下条件自动选择最佳提供商：
1. **可用的 API 密钥** - 仅使用已配置的提供商
2. **内容类型** - 不同的提供商在不同类型上表现出色
3. **用户偏好** - 可手动覆盖
**自动选择逻辑：**
- 产品摄影 → WaveSpeed AI
- 时尚/OOTD → Nano Banana
- 肖像 → OpenAI DALL-E
- 自定义样式 → Stability AI
- 备用 → PhotoShoot 应用（无需 API 密钥的演示模式）
## 贡献
我们欢迎贡献！请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 获取指南。
### 贡献领域
- 新的 AI 提供商集成
- 额外的技能定义
- 代理功能增强
- 其他平台的插件支持
- 文档和示例
## 开发
```bash
# 安装依赖
npm install
# 构建所有包
npm run build
# 运行 MCP 服务器
npm run mcp:start
# 运行测试
npm test
# 开发模式，热重载
npm run dev
```
## 性能
- **批量处理**：同时处理最多 100 张图像
- **自动缓存**：通过智能缓存减少冗余 API 调用
- **并发请求**：可配置的并发请求限制
- **超时保护**：所有 API 调用内置超时
## 路线图
- [ ] 视频生成支持（Kling、Veo、Sora via WaveSpeed）
- [ ] 3D 模型生成
- [ ] 高级编辑功能（inpainting、outpainting）
- [ ] 实时样式转换
- [ ] 移动应用集成
- [ ] 云存储集成
- [ ] 团队协作功能
## 许可证
MIT 许可证 - 参见 [LICENSE](LICENSE) 获取详细信息。
## 链接
- [PhotoShoot 应用](https://photoshoot.app/) - 主要平台
- [WaveSpeed AI](https://wavespeed.ai/docs) - WaveSpeed 文档
- [Nano Banana](https://ai.google.dev/gemini-api/docs/image-generation) - Google Gemini 文档
- [MCP 规范](https://modelcontextprotocol.io) - 协议详细信息
- [Claude 代码](https://claude.ai/code) - Claude 代码 IDE
- [Pi 代理](https://pi.agent) - Pi 代理平台
- [OpenLLM](https://github.com/vllm-project/openllm) - OpenLLM 生态系统
## 支持
- **GitHub 问题**：[github.com/photoshootapp/photoshoot-ai-design/issues](https://github.com/photoshootapp/photoshoot-ai-design/issues)
- **电子邮件**：support@photoshoot.app
- **Discord**：即将推出
## 致谢
使用以下技术构建：
- [模型上下文协议](https://modelcontextprotocol.io) - AI 工具集成标准
- [WaveSpeed AI](https://wavespeed.ai) - 统一 AI API 平台
- [Google Gemini](https://ai.google.dev/gemini-api) - Nano Banana 图像生成
- [Claude](https://claude.ai) - Anthropic 的 AI 助手
---
**为 AI 摄影社区构建 ❤️**
