图片生成 API
神稳AI 提供与官方 Sub2API 对齐的 OpenAI Images API。Cherry Studio、OpenAI SDK 与原本可连接 Sub2API Images API 的第三方客户端，通常只需替换 Base URL 与专用生图 API Key。
图片请求必须选择 gpt-image-2，并走 Images / 绘画功能；请勿把图片模型填进 Chat Completions 对话接口。生图 Key 显示 1x 倍率，最终按 Main Sub2API 返回成本结算。
可以把这些模型 ID 复制到 config.toml、API request body，或任何需要填写模型名称的 OpenAI 兼容客户端。
先准备 API 金钥
1. 前往个人页面
登录后到个人页面建立或复制 API Key。金钥长得像 sk-or-v1-xxxxxxxxxxxx，请当密码保管。
前往个人页面2. 新增 API Key 并选择通道
点击「新增 API Key」，输入便于辨识的名称，再根据用途选择通道：
- 稳定通道 · 0.22x（Pro 号池）
- 优先稳定性，支持 OpenAI（Codex 接入）、OpenAI 兼容与 CC 接入。适合长时间运行及重要文字任务。
- 低价通道 · 0.09x（Plus 号池）
- 优先价格，支持 OpenAI（Codex 接入）与 OpenAI 兼容。适合日常开发、学习、测试，以及更重视成本的文字任务。
生图请另外选择 OpenAI 生图 Key 或 Grok 生图 Key。文字与生图用途不能混在同一把 Key；需要多个用途时请分别建立。
3. 确认 Base URL
图片客户端填写带 /v1 的 Base URL；实际生图端点是 /v1/images/generations。
不要把 API 金钥发给别人，也不要提交到 GitHub、GitLab 或任何公开仓库。
下方指令会根据你选择的系统切换。
Cherry Studio 配置
打开 Cherry Studio 的模型服务设置，新增 OpenAI 或 OpenAI-compatible 服务商。API 地址填写 https://api.shenwenai.com/v1，API Key 填写你在神稳AI个人页面建立的 OpenAI 生图专用金钥。
新增自定义模型 gpt-image-2，并把它设为图片生成模型。之后从 Cherry Studio 的绘画或图片生成页面选择 gpt-image-2；普通聊天页面不会调用 Images API。
如果模型列表没有自动出现，手动新增模型 ID：gpt-image-2。不要填写 gpt-image-2 到只支持 Chat Completions 的纯聊天模型栏位。
检查模型列表
成功时，返回的 data 数组里会包含 gpt-image-2。只有已开放图片生成功能的 API Key 才会看到该模型。
curl https://api.shenwenai.com/v1/models \
-H "Authorization: Bearer sk-or-v1-你的金钥"生成一张图片
下面使用 url 回传，方便直接在浏览器打开测试。正式程序也可以省略 response_format，取得标准 b64_json。每次请求目前只能生成一张图片。
Idempotency-Key 用来避免网络重试造成重复生图和重复扣款。同一次请求请沿用相同值；修改提示词或规格后必须换一个新值。
curl https://api.shenwenai.com/v1/images/generations \
-H "Authorization: Bearer sk-or-v1-你的金钥" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: my-first-image-001" \
-d '{
"model": "gpt-image-2",
"prompt": "一杯放在木桌上的精品手冲咖啡，窗边自然光，真实摄影",
"n": 1,
"size": "1536x1024",
"quality": "medium",
"output_format": "png",
"response_format": "url"
}'使用参考图编辑
编辑端点支持标准 multipart/form-data，一次最多上传 10 张 PNG、JPEG 或 WebP 参考图，每张最多 10MB，请求总大小最多 64MB。把 reference.png 换成你电脑上的文件路径。
curl https://api.shenwenai.com/v1/images/edits \
-H "Authorization: Bearer sk-or-v1-你的金钥" \
-H "Idempotency-Key: my-first-edit-001" \
-F "model=gpt-image-2" \
-F "image[]=@reference.png" \
-F "prompt=保留主体，把背景改成下雪的山景" \
-F "size=1024x1024" \
-F "quality=high"Python OpenAI SDK
from openai import OpenAI
import base64
client = OpenAI(
api_key="sk-or-v1-你的金钥",
base_url="https://api.shenwenai.com/v1",
)
result = client.images.generate(
model="gpt-image-2",
prompt="极简风格的智能手表产品摄影",
size="1024x1024",
quality="medium",
)
with open("shenwen-image.png", "wb") as image_file:
image_file.write(base64.b64decode(result.data[0].b64_json))支持参数与计费
支持 model、prompt、n、size、quality、background、output_format、output_compression、moderation、partial_images、stream、response_format、user；编辑请求另支持 image / image[] 与 mask。未知的新参数会继续透传给 Sub2API。
GPT Image 2 尺寸可用 auto，或同时满足以下条件的 WIDTHxHEIGHT：两边都是 16 的倍数、最长边不超过 3840、总像素 655,360 至 8,294,400、长宽比不超过 3:1。常用尺寸包含 1024x1024、1536x1024、1024x1536、2048x2048、2048x1152、3840x2160。
生图 Key 显示 1x 倍率。默认品质固定使用 medium，高品质固定使用 high；按 ¥1 = $1 平台额度计算，最终扣除额度等于 Main Sub2API 返回的实际成本。n 支持 1 至 5。
站内工具与公开 API 共用全站 30 张生成容量；同一用户与同一 Key 各自最多同时生成 5 张。达到上限后请求会保持连接并自动排队，等待期间不会送往上游或扣费；只有排队已满或等待超过 15 分钟才会返回 429。
请求中的 quality 会由 Key 档位统一覆盖。为兼容旧客户端，standard / hd 仍可传入，jpg 会转成 jpeg。GPT Image 2 固定使用高输入保真度且不支持透明背景；style、input_fidelity 与透明背景请求会由神稳AI安全忽略，并在 X-Shenwen-Image-Compatibility 回应头标示。
2K 与 4K 是请求目标而非保证；高于 2560x1440 总像素的输出属于实验范围，上游可能回传较小尺寸。请以下载后图片的实际像素为准。复杂请求可能超过 2 分钟，api.shenwenai.com 最长可等待 15 分钟。
请求建立时会按尺寸、品质与 n 预留额度。上游回传后按 Main Sub2API 成本正式结算；没有成本或 usage 的失败请求会释放预留额度。
充值按 ¥1 = $1 平台额度换算，图片生成按 Main Sub2API 实际成本 1x 扣除。
常见问题
模型列表没有 gpt-image-2：确认图片生成功能已经对这把 API Key 开放。
400 / model_not_found：模型名称必须完整填写 gpt-image-2，并使用 Images API，而不是 Chat Completions。
请求发到 shenwenai.com/v1：请把 Base URL 改成 https://api.shenwenai.com/v1；网站网域不是 API 网域。
约 120 秒后仍在生成：120 秒是自动续租的并发 lease，不是请求超时；请保持连接并让客户端 timeout 高于 2 分钟。
409 / idempotency_key_in_use：同一个 Idempotency-Key 被拿来发送不同参数，请换一个新值。
429 / image_queue_full、image_user_queue_full 或 image_queue_timeout：排队总量、个人排队量或 15 分钟等待时间已达到上限，请稍后重试。
402 / insufficient_quota：余额不足以预留本次图片生成费用，请先充值。