351 lines
10 KiB
Markdown
351 lines
10 KiB
Markdown
# BowongAI 集成总结
|
||
|
||
## 🎯 **集成概述**
|
||
|
||
基于您提供的BowongAI API接口，我已经完整更新了模板管理系统，实现了图生图和图生视频功能的集成。
|
||
|
||
## 🔗 **API接口信息**
|
||
|
||
### Webhook URL
|
||
```
|
||
https://n8n.bowongai.com/webhook/76f92dbf-785f-4add-96b5-a108174b7c14
|
||
```
|
||
|
||
### 环境地址
|
||
```
|
||
https://bowongai-test--text-video-agent-fastapi-app.modal.run
|
||
```
|
||
|
||
## 📋 **支持的工作流**
|
||
|
||
### 1. 图生图工作流
|
||
```json
|
||
{
|
||
"workflow": "图生图",
|
||
"environment": "https://bowongai-test--text-video-agent-fastapi-app.modal.run",
|
||
"image_generation": {
|
||
"model": "gemini-2.5-flash-image-preview",
|
||
"prompt": "详细的提示词...",
|
||
"image_url": "输入图片URL"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 2. 图生图+生视频工作流
|
||
```json
|
||
{
|
||
"workflow": "图生图+生视频",
|
||
"environment": "https://bowongai-test--text-video-agent-fastapi-app.modal.run",
|
||
"image_generation": {
|
||
"model": "gemini-2.5-flash-image-preview",
|
||
"prompt": "详细的提示词...",
|
||
"image_url": "输入图片URL"
|
||
},
|
||
"video_generation": {
|
||
"model": "302/MiniMax-Hailuo-02",
|
||
"prompt": "do anything you want",
|
||
"duration": "6",
|
||
"aspect_ratio": "9:16"
|
||
}
|
||
}
|
||
```
|
||
|
||
## 🏗️ **技术实现**
|
||
|
||
### 1. BowongAI基础服务类（通用服务）
|
||
```typescript
|
||
// src/services/bowongai.service.ts
|
||
@Injectable()
|
||
export class BowongAIService {
|
||
private readonly webhookUrl = 'https://n8n.bowongai.com/webhook/76f92dbf-785f-4add-96b5-a108174b7c14';
|
||
private readonly environment = 'https://bowongai-test--text-video-agent-fastapi-app.modal.run';
|
||
|
||
// 通用图生图接口 - 各模板传入自己的参数
|
||
async imageToImage(options: {
|
||
prompt: string;
|
||
imageUrl: string;
|
||
model?: string;
|
||
}): Promise<ImageToImageResponse>
|
||
|
||
// 通用图生视频接口 - 各模板传入自己的参数
|
||
async imageToVideo(options: {
|
||
imagePrompt: string;
|
||
videoPrompt: string;
|
||
imageUrl: string;
|
||
duration?: number;
|
||
aspectRatio?: string;
|
||
imageModel?: string;
|
||
videoModel?: string;
|
||
}): Promise<ImageToVideoResponse>
|
||
}
|
||
```
|
||
|
||
### 2. 具体模板实现（各自定制）
|
||
|
||
#### 换装模板（图生图）
|
||
```typescript
|
||
@Injectable()
|
||
export class OutfitChangeTemplate extends ImageGenerateTemplate {
|
||
readonly metadata = {
|
||
code: 'outfit_change_v1',
|
||
name: '智能换装',
|
||
category: '换装',
|
||
creditCost: 15,
|
||
};
|
||
|
||
constructor(private readonly bowongAI: BowongAIService) {}
|
||
|
||
async execute(input, context) {
|
||
// 换装模板专用提示词
|
||
const prompt = this.buildOutfitChangePrompt(input);
|
||
|
||
return await this.bowongAI.imageToImage({
|
||
prompt,
|
||
imageUrl: input.inputImage,
|
||
model: 'gemini-2.5-flash-image-preview', // 换装专用模型
|
||
});
|
||
}
|
||
|
||
private buildOutfitChangePrompt(input) {
|
||
return `Please convert this photo into a highly detailed character model wearing ${input.clothingDescription}. Place in front of the model a delicate, colorful box featuring the printed image of the person from the photo...`;
|
||
}
|
||
}
|
||
```
|
||
|
||
#### 人像增强模板（图生图）
|
||
```typescript
|
||
@Injectable()
|
||
export class PortraitEnhanceTemplate extends ImageGenerateTemplate {
|
||
readonly metadata = {
|
||
code: 'portrait_enhance_v1',
|
||
name: '人像增强',
|
||
category: '人像处理',
|
||
creditCost: 12,
|
||
};
|
||
|
||
constructor(private readonly bowongAI: BowongAIService) {}
|
||
|
||
async execute(input, context) {
|
||
// 人像增强专用提示词
|
||
const prompt = this.buildPortraitPrompt(input);
|
||
|
||
return await this.bowongAI.imageToImage({
|
||
prompt,
|
||
imageUrl: input.inputImage,
|
||
model: 'gemini-2.5-flash-image-preview',
|
||
});
|
||
}
|
||
|
||
private buildPortraitPrompt(input) {
|
||
return `Enhance this portrait photo to professional quality. Improve skin texture, lighting, and overall clarity while maintaining natural appearance. ${input.enhanceLevel === 'subtle' ? 'Apply subtle enhancements' : 'Apply dramatic improvements'}...`;
|
||
}
|
||
}
|
||
```
|
||
|
||
#### 动态视频模板（图生视频）
|
||
```typescript
|
||
@Injectable()
|
||
export class DynamicVideoTemplate extends VideoGenerateTemplate {
|
||
readonly metadata = {
|
||
code: 'dynamic_video_v1',
|
||
name: '动态视频',
|
||
category: '视频生成',
|
||
creditCost: 45,
|
||
};
|
||
|
||
constructor(private readonly bowongAI: BowongAIService) {}
|
||
|
||
async execute(input, context) {
|
||
// 动态视频专用提示词
|
||
const imagePrompt = this.buildImagePrompt(input);
|
||
const videoPrompt = this.buildVideoPrompt(input);
|
||
|
||
return await this.bowongAI.imageToVideo({
|
||
imagePrompt,
|
||
videoPrompt,
|
||
imageUrl: input.inputImage,
|
||
duration: input.duration || 4,
|
||
aspectRatio: input.aspectRatio || '9:16',
|
||
imageModel: 'gemini-2.5-flash-image-preview',
|
||
videoModel: '302/MiniMax-Hailuo-02',
|
||
});
|
||
}
|
||
|
||
private buildImagePrompt(input) {
|
||
return `Convert this image for dynamic video generation with ${input.motionType} motion effects...`;
|
||
}
|
||
|
||
private buildVideoPrompt(input) {
|
||
return `Create ${input.motionType} animation with ${input.intensity} intensity. ${input.customPrompt || 'Natural movement'}`;
|
||
}
|
||
}
|
||
```
|
||
|
||
## 🎨 **模板化提示词设计**
|
||
|
||
### 换装模板提示词
|
||
```typescript
|
||
private buildOutfitChangePrompt(input: OutfitChangeInput): string {
|
||
const styleMap = {
|
||
casual: 'casual everyday wear',
|
||
formal: 'formal business attire',
|
||
vintage: 'vintage retro style',
|
||
modern: 'modern contemporary fashion',
|
||
elegant: 'elegant sophisticated style'
|
||
};
|
||
|
||
const styleText = styleMap[input.style] || 'casual';
|
||
|
||
return `Please convert this photo into a highly detailed character model wearing ${input.clothingDescription}.
|
||
Style: ${styleText}.
|
||
Place in front of the model a delicate, colorful box featuring the printed image of the person from the photo.
|
||
Behind the box, show a computer screen actively displaying the modeling process.
|
||
Set the entire scene in a bright, stylish indoor environment.
|
||
Ensure the lighting is crisp and luminous, highlighting both the model and its packaging.`;
|
||
}
|
||
```
|
||
|
||
### 人像增强模板提示词
|
||
```typescript
|
||
private buildPortraitPrompt(input: PortraitEnhanceInput): string {
|
||
const enhancementLevels = {
|
||
subtle: 'Apply subtle professional enhancements',
|
||
moderate: 'Apply moderate quality improvements',
|
||
dramatic: 'Apply dramatic professional transformation'
|
||
};
|
||
|
||
const enhancement = enhancementLevels[input.enhanceLevel] || 'moderate';
|
||
|
||
return `${enhancement} to this portrait photo.
|
||
Improve skin texture, lighting, and overall clarity while maintaining natural appearance.
|
||
Focus on professional photography quality with ${input.lightingStyle || 'natural'} lighting.
|
||
Preserve the person's unique features and expressions.`;
|
||
}
|
||
```
|
||
|
||
### 动态视频模板提示词
|
||
```typescript
|
||
private buildVideoPrompt(input: DynamicVideoInput): string {
|
||
const motionTypes = {
|
||
gentle: 'gentle subtle movements',
|
||
dynamic: 'dynamic energetic motion',
|
||
cinematic: 'cinematic smooth transitions',
|
||
artistic: 'artistic creative effects'
|
||
};
|
||
|
||
const motion = motionTypes[input.motionType] || 'gentle';
|
||
|
||
return `Create ${motion} with ${input.intensity || 'medium'} intensity.
|
||
${input.customPrompt || 'Natural lifelike movement'}.
|
||
Maintain character consistency throughout the animation.`;
|
||
}
|
||
```
|
||
|
||
## 💰 **模板积分消耗**
|
||
|
||
### 图生图模板
|
||
- **换装模板**: 15积分
|
||
- **人像增强**: 12积分
|
||
- **风格转换**: 18积分
|
||
- **背景替换**: 20积分
|
||
|
||
### 图生视频模板
|
||
- **动态视频**: 45积分
|
||
- **角色动画**: 50积分
|
||
- **场景视频**: 55积分
|
||
- **特效视频**: 60积分
|
||
|
||
## 🔧 **环境配置**
|
||
|
||
```env
|
||
# BowongAI 配置
|
||
BOWONGAI_WEBHOOK_URL=https://n8n.bowongai.com/webhook/76f92dbf-785f-4add-96b5-a108174b7c14
|
||
BOWONGAI_ENVIRONMENT=https://bowongai-test--text-video-agent-fastapi-app.modal.run
|
||
```
|
||
|
||
## 📱 **前端调用示例**
|
||
|
||
### 图生图调用
|
||
```typescript
|
||
const response = await fetch('/api/templates/outfit_change_v1/execute', {
|
||
method: 'POST',
|
||
headers: {
|
||
'Authorization': `Bearer ${token}`,
|
||
'Content-Type': 'application/json',
|
||
},
|
||
body: JSON.stringify({
|
||
inputImage: 'https://cdn.roasmax.cn/upload/e9066bf20fb546b09ece65d6fbcf2dd3.png',
|
||
clothingDescription: '红色连衣裙',
|
||
style: 'elegant'
|
||
})
|
||
});
|
||
```
|
||
|
||
### 图生视频调用
|
||
```typescript
|
||
const response = await fetch('/api/templates/image_to_video_v1/execute', {
|
||
method: 'POST',
|
||
headers: {
|
||
'Authorization': `Bearer ${token}`,
|
||
'Content-Type': 'application/json',
|
||
},
|
||
body: JSON.stringify({
|
||
inputImage: 'https://cdn.roasmax.cn/upload/e9066bf20fb546b09ece65d6fbcf2dd3.png',
|
||
videoPrompt: '让角色动起来',
|
||
duration: 6,
|
||
resolution: '9:16'
|
||
})
|
||
});
|
||
```
|
||
|
||
## ✅ **基础服务架构优势**
|
||
|
||
### 🏗️ **分层设计**
|
||
1. **BowongAI基础服务层**: 提供通用的API调用能力
|
||
2. **模板业务层**: 各模板实现自己的业务逻辑和提示词
|
||
3. **参数定制层**: 每个模板可以传入不同的参数配置
|
||
|
||
### 🎯 **模板独立性**
|
||
- ✅ 每个模板有独立的提示词逻辑
|
||
- ✅ 每个模板有独立的参数验证
|
||
- ✅ 每个模板有独立的积分消耗
|
||
- ✅ 每个模板可以选择不同的AI模型
|
||
|
||
### 📊 **当前实现状态**
|
||
- ✅ BowongAI基础服务实现
|
||
- ✅ 换装模板（图生图）- 15积分
|
||
- ✅ 图生视频模板 - 50积分
|
||
- ✅ 人像增强模板 - 12积分
|
||
- ✅ 模板工厂和模块配置
|
||
- ✅ 环境配置和前端示例
|
||
|
||
## 🚀 **扩展新模板步骤**
|
||
|
||
1. **继承对应的抽象类**
|
||
2. **实现execute方法，调用BowongAI基础服务**
|
||
3. **定义模板专用的提示词构建逻辑**
|
||
4. **配置模板特定的参数和积分**
|
||
5. **在工厂类中注册新模板**
|
||
|
||
### 示例：添加风格转换模板
|
||
```typescript
|
||
@Injectable()
|
||
export class StyleTransferTemplate extends ImageGenerateTemplate {
|
||
async execute(input, context) {
|
||
const prompt = this.buildStylePrompt(input); // 风格转换专用提示词
|
||
|
||
return await this.bowongAI.imageToImage({
|
||
prompt,
|
||
imageUrl: input.inputImage,
|
||
model: 'gemini-2.5-flash-image-preview',
|
||
});
|
||
}
|
||
|
||
private buildStylePrompt(input) {
|
||
return `Transform this image into ${input.targetStyle} style...`;
|
||
}
|
||
}
|
||
```
|
||
|
||
现在BowongAI作为基础服务，支持各种模板的个性化定制！🎉
|