Guishu GPT Image 2

通过 Guishu Token 提供的 OpenAI 兼容图像接口生成图像。

快速开始

使用配套脚本。该脚本按以下顺序从环境变量中读取 API 密钥：

1. LLM_TOKEN_API_KEY
2. GUI_SHU_TOKEN_KEY
3. OPENAI_API_KEY

export LLM_TOKEN_API_KEY="sk-..."
python3 {baseDir}/scripts/generate.py 
  --prompt "一款蓝色智能音箱的简洁产品海报，影棚灯光" 
  --size 1024x1024 
  --quality high 
  --n 1

默认接口地址为：

https://api.llm-token.cn/v1/images/generations

默认模型为：

gpt-image-2

工作流程

1. 如需了解接口详情、支持的请求字段、超时建议或面向用户的配置说明，请查阅 references/gpt-image-2-api.md。
2. 准备一条明确具体的图像提示词（prompt）。提示词应清晰描述主体、风格、构图、相机参数、光线、色彩及输出用途。
3. 运行 scripts/generate.py。推荐使用 --response-format b64_json 参数，使脚本能直接将图像以 Base64 形式保存至本地，无需依赖临时 URL。
4. 检查输出目录内容。脚本会生成图像文件，并同时写入 prompts.json、request.json 和 index.html。
5. 若请求长时间等待后超时，请勿自动重试。高分辨率请求耗时可能达 70–150 秒，且上游服务仍可能计费。

常用命令

# 预演模式：不发送可计费请求。
python3 {baseDir}/scripts/generate.py --prompt "test prompt" --dry-run

# 竖版人像（高宽比 9:16）。
python3 {baseDir}/scripts/generate.py 
  --prompt "超写实人像摄影，自然光，浅景深" 
  --size 1024x1792 
  --quality high

# 从文本文件批量读取提示词（每行一条）。
python3 {baseDir}/scripts/generate.py --prompt-file ./prompts.txt --n 1

# 自定义接口地址（适用于网关变更场景）。
python3 {baseDir}/scripts/generate.py 
  --endpoint https://api.llm-token.cn/v1/images/generations 
  --model gpt-image-2 
  --prompt "极简风格应用图标，白色背景"

安全与成本说明

• 切勿在日志或终端中打印 API 密钥。优先使用环境变量传入密钥，而非命令行参数 --api-key。
• 避免在长时超时后盲目重试。对可能已处理完成的请求，应先征得用户确认再决定是否重试。
• 面向普通用户，建议优先使用 Web UI：https://image2.gpt-agent.cc/。
• 面向自动化任务或 Agent 工作流，推荐使用脚本调用，并将结果本地化保存。