AI 图像生成工具文档

功能概述

本工具基于Together AI平台，提供图像生成服务，并集成到Cursor MCP系统中。支持通过参数配置生成高质量图片，适用于多种应用场景。

环境要求

操作系统

• 推荐：macOS 10.15及以上版本、Windows 10及以上版本、Linux（Ubuntu 20.04及以上）
• 最低要求：macOS 10.12及以上、Windows 8及以上、Linux（Ubuntu 16.04及以上）

软件依赖

• Python 3.7及以上版本
• 必要的依赖库已自动包含在安装包中

安装指南

1. 下载工具包

   • 访问官方下载页面获取最新版本的安装包。

2. 安装步骤

   # 解压安装包
   tar -xzf ai-image-generator-toolkit-vX.Y.Z.tar.gz
   
   # 进入解压目录
   cd ai-image-generator-toolkit-vX.Y.Z
   
   # 安装依赖
   pip install -r requirements.txt
   
   # 启动服务
   python main.py
   

配置说明

核心配置文件

• 主配置文件：config.json

  {
    "api_key": "your_api_key_here",
    "max_image_size": "1024x1024",
    "supported_aspect_ratios": ["1:1", "4:3", "16:9", "3:4", "9:16"],
    "default_params": {
      "steps": 3,
      "aspect_ratio": "1:1"
    }
  }
  

• 参数解释

  参数名	类型	是否必填	默认值	说明
  api_key	string	是		API访问密钥
  max_image_size	string	否	"1024x1024"	支持的最大图像尺寸
  supported_aspect_ratios	array	否	["1:1", "4:3", ...]	支持的宽高比列表
  default_params	object	否	{steps:3, aspect_ratio:"1:1"}	默认生成参数

使用说明

功能模块

• 图像生成功能

  • 支持多语言提示词输入，包括中文、英文等。
  • 提供多种尺寸和宽高比选项，满足不同场景需求。

• 批量处理功能

  • 支持一次性生成多个图片，提高工作效率。
  • 可设置生成参数模板，方便重复使用。

使用示例

# 示例1：生成标准尺寸的图像
generate_image(
    prompt="一只飞翔的鸟儿在蓝天中",
    file_name="bird.jpg",
    save_folder="/Users/username/Pictures",
    aspect_ratio="1:1"
)

# 示例2：批量生成不同宽高比的图像
params_list = [
    {"prompt": "森林清晨", "file_name": "forest_morning", "aspect_ratio": "4:3"},
    {"prompt": "沙漠日落", "file_name": "desert_sunset", "aspect_ratio": "16:9"}
]
batch_generate(params_list)

参数详解

注意事项

1. 性能提示

   • 建议在稳定的网络环境下使用。
   • 处理大批量请求时，建议分批次处理以保证成功率。

2. 安全须知

   • 请勿泄露API密钥给他人。
   • 遵守当地法律法规，合理使用生成内容。

3. 故障排除

   • 如遇网络问题，请检查网络连接。
   • 若提示参数错误，请核对参数格式和取值范围。

更新日志

v1.0.0（2024-03-20）

• 初始版本发布，包含基本图像生成功能。
• 支持中文和英文双语提示词输入。

v1.1.0（2024-04-15）

• 新增批量生成功能。
• 优化API调用性能，提升响应速度。

v1.2.0（2024-05-01）

• 支持自定义宽高比和尺寸设置。
• 增加错误处理机制，提高稳定性。

联系我们

如需技术支持或反馈问题，请访问官方支持页面联系我们的客服团队。