AI图像生成#

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

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

---

前置配置：获取 API Key#

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

bash

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

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

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

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

---

使用方法#

基本生成#

bash

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

输出示例：

text

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

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

指定宽高比#

bash

# 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

可用尺寸比例：

代码比例适用场景11:1（默认）头像、社交媒体方图216:9横屏壁纸、Banner、视频封面34:3PPT配图、展示图43:4海报、宣传图59:16手机壁纸、短视频封面

指定输出目录#

bash

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

仅获取链接（不下载）#

bash

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

直接调用 API（无需脚本）#

text

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小时内有效

参数说明#

参数必填说明示例prompt是图片描述，中英文均可，最多800字符"一只猫咪在草地上玩耍"--size否宽高比，1-5，默认1（1:1）2--output否图片保存目录，默认为 output/~/Desktop--no-download否只返回链接，不下载图片—--key否临时传入 API Keyyour_key

提示词优化建议#

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

要素示例主体描述一只白色比熊犬、一位穿汉服的少女、现代城市天际线风格写实照片风、水彩插画风、赛博朋克风、中国水墨风构图正面特写、俯视视角、全景构图、九宫格排版色彩/氛围暖色调、冷蓝色调、金色阳光、夜间霓虹灯光质量修饰高清、超细节、4K、电影级画质

错误处理#

情况处理方式error_code 10001/10002API Key 无效，引导用户至 聚合数据 重新申请error_code 10012今日调用次数已用尽，建议升级套餐error_code 282401提示词不可为空，请补充图片描述error_code 282403包含敏感内容，请修改提示词后重试error_code 282404生成失败，建议稍后重试或修改提示词请求超时文生图耗时较长（最长60秒），超时后重试一次下载失败图片链接24小时内有效，提示用户手动访问链接保存

---

脚本位置#

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

---

关于聚合数据#

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

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

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