生图调用文档
两套生图模型调用指南
gpt-image-2(OpenAI 兼容) · gemini-3.1-flash-image(Google 原生)
Codex Skill — 一键调两套模型
把这个 skill 下载到 Codex 后,直接说 “用 gpt-image-2 画一只猫” 或 “用 Gemini 画日落”,自动选对应接口
下载 Skill (.zip)12 KB · 解压到 ~/.codex/skills/
安装说明
1. 下载并解压 zip 到 ~/.codex/skills/zhonghe-image-router/
2. 配置环境变量(按需配一个或全配):
export ZHONGHE_GPT_IMAGE_API_KEY="sk-..." # gpt-image-2 分组的 Key export ZHONGHE_GEMINI_API_KEY="sk-..." # gemini 分组的 Key
3. 重启 Codex,告诉它 "用 gpt-image-2 画一只猫" 即可
基础信息
- 模型:
gpt-image-2 - 端点:
https://lenovo-ai.cn/v1/images/generations - 编辑端点:
https://lenovo-ai.cn/v1/images/edits - API Key 必须绑定
gpt-image-2分组
curl 调用
bash
curl https://lenovo-ai.cn/v1/images/generations \
-H "Authorization: Bearer sk-你的key" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "一只在月球上看星空的猫",
"size": "1024x1024",
"n": 1
}'OpenAI Python SDK
python
from openai import OpenAI
client = OpenAI(
api_key="sk-你的key",
base_url="https://lenovo-ai.cn/v1"
)
result = client.images.generate(
model="gpt-image-2",
prompt="一只在月球上看星空的猫",
size="1024x1024",
n=1
)
print(result.data[0].url) # 或 .b64_jsonNode SDK
javascript
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "sk-你的key",
baseURL: "https://lenovo-ai.cn/v1"
});
const r = await client.images.generate({
model: "gpt-image-2",
prompt: "一只在月球上看星空的猫",
size: "1024x1024",
n: 1
});
console.log(r.data[0].url);编辑图片(/v1/images/edits)
支持基于 mask 的局部重绘。image 是原图,mask 是蒙版(透明区域 = 重绘区域)。
bash
curl https://lenovo-ai.cn/v1/images/edits \
-H "Authorization: Bearer sk-你的key" \
-F image=@原图.png \
-F mask=@蒙版.png \
-F prompt="把猫换成狗" \
-F model="gpt-image-2" \
-F size="1024x1024"支持的尺寸
- •
1024x1024— 方形(默认) - •
1024x1792— 竖屏 - •
1792x1024— 横屏
完整文档下载
两套模型对比
| 特性 | gpt-image-2 | gemini-3.1-flash-image |
|---|---|---|
| 协议 | OpenAI 兼容 | Google 原生 |
| 端点 | /v1/images/generations | /v1beta/models/.../generateContent |
| 流式 | ❌ 不支持 | ✅ :streamGenerateContent |
| 返回格式 | URL + base64 | 仅 base64 |
| 尺寸控制 | 1024x1024 / 1024x1792 / 1792x1024 | imageSize: 1K/2K/4K + aspectRatio |
| 宽高比 | 由 size 决定 | 1:1 / 16:9 / 9:16 / 4:3 / 3:4 |
| 生成多张 | ✅ n 参数(最多 10) | ❌ 单次 1 张 |
| 图片编辑 | ✅ /v1/images/edits + mask | ✅ 在 contents 里传 inlineData |
| SDK 支持 | OpenAI SDK / curl | Google GenAI SDK / curl |
| 所属分组 | gpt-image-2 | gemini / antigravity |
两套模型必须用两个不同的 Key
这两套接口走的上游协议不同(OpenAI 协议 vs Google 协议),平台规定一个 Key 只能绑定一个分组。 所以你需要在 /dashboard/keys 创建两个 Key,分别绑定 gpt-image-2 和 gemini 分组。