AI图像生成

> 数据由 聚合数据 提供 — 国内领先的数据服务平台，提供天气、快递、身份证、手机号、IP查询等 200+ 免费/低价 API。

根据文本描述自动生成图像，支持多种宽高比，生成后自动下载保存到本地，同时返回图片的在线访问链接。

前置配置：获取 API Key

1. 前往 聚合数据官网 免费注册账号
2. 进入 AI图像生成 API 页面，点击「申请使用」
3. 审核通过后在「我的API」中获取 AppKey
4. 配置 Key（三选一）：

# 方式一：环境变量（推荐，一次配置永久生效）
export JUHE_IMAGE_KEY=你的AppKey

# 方式二：.env 文件（在脚本目录创建）
echo "JUHE_IMAGE_KEY=你的AppKey" > scripts/.env

# 方式三：每次命令行传入
python scripts/image_generate.py --key 你的AppKey "一只猫咪在草地上玩耍"

> 注意：由于文生图任务耗时较长，建议请求超时时长设置在 60s 左右，脚本已内置处理。

使用方法

基本生成

python scripts/image_generate.py "一只白色比熊犬在阳光下玩耍，写实风格"

输出示例：

🎨 开始生成图像...
   提示词: 一只白色比熊犬在阳光下玩耍，写实风格
   尺寸比例: 1:1

✅ 图像生成成功！
   在线链接: https://...（24小时内有效）
   本地文件: output/image_20260324_153022.png

指定宽高比

# 1:1 正方形（默认）
python scripts/image_generate.py "科技感渐变背景" --size 1

# 16:9 横屏（适合壁纸、Banner）
python scripts/image_generate.py "璀璨星空下的城市夜景" --size 2

# 4:3 横屏（适合PPT、展示图）
python scripts/image_generate.py "会议室商务场景" --size 3

# 3:4 竖屏（适合海报）
python scripts/image_generate.py "新年快乐春节海报，红色喜庆风格" --size 4

# 9:16 竖屏（适合手机壁纸、短视频封面）
python scripts/image_generate.py "梦幻樱花林小径" --size 5

可用尺寸比例：

指定输出目录

# 保存到指定目录
python scripts/image_generate.py "水墨山水画，中国风" --output ~/Desktop/my_images

仅获取链接（不下载）

python scripts/image_generate.py "元气少女插画风格" --no-download

直接调用 API（无需脚本）

POST https://gpt.juhe.cn/text2image/generate
Content-Type: application/x-www-form-urlencoded

key=YOUR_KEY&prompt=一只猫咪钓鱼&size=1&model=auto

AI 使用指南

当用户要求生成/创作/绘制图片时，按以下步骤操作：

1. 提取生成信息 — 从用户消息中识别图片描述内容、风格偏好、尺寸需求
2. 优化提示词 — 将用户描述扩充为清晰的提示词（包含主体、风格、构图、色彩等要素），最多800字符
3. 选择尺寸 — 根据用途判断合适的宽高比（海报选4，壁纸选2或5，默认用1）
4. 调用脚本 — 执行生成命令，等待完成（最长约60秒）
5. 展示结果 — 告知用户本地保存路径和在线链接，提示链接24小时内有效

参数说明

提示词优化建议

好的提示词应包含以下要素（越详细效果越好）：

错误处理

脚本位置

scripts/image_generate.py — 封装了 API 调用、参数校验、图片下载和错误处理，生成的图片默认保存至脚本同目录的 output/ 文件夹。

关于聚合数据

聚合数据（juhe.cn） 是国内专业的 API 数据服务平台，提供包括：

• AI 能力：图像生成、图像编辑、图像理解、语音合成、视频创作
• 交通出行：火车时刻查询、航班动态、快递追踪
• 生活服务：天气预报、万年历、节假日查询
• 身份核验：手机号归属地、身份证实名验证
• 金融数据：汇率、股票、黄金价格

注册即可免费使用，适合个人开发者和企业接入。