Codexplus

GPT 生图 API:统一接口,按量计费

和 OpenAI 官方协议完全一致,改一个 Base URL 就能出图。这一页把型号、价格、参数、三种语言的示例、两种返回格式和常见报错全部写清楚,照抄能跑。

Base URL
https://codexplus.shop/v1
请求
POST /v1/images/generations
鉴权
Authorization: Bearer <你的 Key>
价格
所有生图模型统一一个价,5 厘起,按张计费
协议
OpenAI Images API 兼容,官方 SDK 直接可用

一、三分钟跑通

先把密钥放进环境变量,然后用 curl 打一发。拿到 data[0] 里的图就算通了。

export CODEXPLUS_BASE="https://codexplus.shop/v1"
export CODEXPLUS_KEY="YOUR_API_KEY"

curl "$CODEXPLUS_BASE/images/generations" \
  -H "Authorization: Bearer $CODEXPLUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "model": "gpt-image-2",
        "prompt": "一只赛博朋克风格的猫,霓虹夜景,电影感",
        "n": 1,
        "size": "1024x1024"
      }'

返回是这样(字段位置和 OpenAI 官方一致):

{
  "created": 1763107200,
  "data": [
    { "b64_json": "iVBORw0KGgoAAAANSUhEUg..." }
  ]
}

第一个坑就在这里:data[0] 里可能是 b64_json,也可能是 url。取决于型号和上游实现。第六节给出两种都能跑的写法——只处理一种,另一种情况下会存出 0 字节文件。

二、接口约定

生图接口基本约定
项值说明
方法POST只接受 POST
路径/v1/images/generations和 OpenAI 官方同路径
Base URLhttps://codexplus.shop/v1必须带 /v1,少写会 404
Content-Typeapplication/json用 SDK 时自动带
鉴权Authorization: Bearer <Key>Key 在控制台「令牌」页创建
计费按张,5 厘起不按 token,n=4 就是 4 张的钱
同步/异步同步请求会等到图片生成完才返回

三、型号、价格与实测

在售型号分成两族,价格统一一个价,选哪个只影响出图风格,不影响单价。

在售生图型号
型号族适合
gpt-image-2GPT 生图日常出图首选,通用档
gpt-image-2.5GPT 生图同系列版本号,效果取向与 2 略有差异
gpt-image-2.5-flareGPT 生图同系列变体
gpt-image-2.5-sunburstGPT 生图同系列变体
gpt-image-2.6GPT 生图更新的版本
grok-imagine-image-liteGrok 生图该分组暂无可用渠道(实测返回 503),暂不售卖
grok-imagine-image-2.0Grok 生图可用性以控制台模型页为准

型号列表跟着上游更新,实时可用性以控制台「模型」页为准,这页不写死。

计价口径:先把这个讲清楚

后台以美元计价,额度按 1 元 = 1 美元额度 兑换,所以下面所有美元价格就等于人民币价格,不用再乘汇率。

计价口径
项值说明
模型单价$0.5 / 张后台标价,所有 gpt-image 型号同价
分组倍率0.01ximage 0.005 分组
实际扣费$0.005 / 张=0.005 元=5 厘0.5 × 0.01,即 5 厘
额度扣减2,500 额度/张1 元 = 1 美元 = 500,000 额度
计费方式按张,不按 tokenn=4 收 4 张的钱
额外费用无无月费、无开通费、无最低消费、无图片存储费
失败是否扣费不扣上游无可用渠道返回的 503,实测未产生扣费记录

按型号的真实单张价格

下面每一行的「额度扣减」都来自真实调用后的计费日志,不是照标价推算的。

各型号单张价格与实测扣费
型号标价倍率实扣(美元)实扣(人民币)额度扣减
gpt-image-2$0.5/张0.01x$0.0050.005 元2,500
gpt-image-2.5$0.5/张0.01x$0.0050.005 元2,500
gpt-image-2.5-flare$0.5/张0.01x$0.0050.005 元2,500
gpt-image-2.5-sunburst$0.5/张0.01x$0.0050.005 元2,500
gpt-image-2.6$0.5/张0.01x$0.0050.005 元2,500
gpt-image-2.6-sunburst$0.5/张0.01x$0.0050.005 元2,500

为什么「统一一个价」:这六个型号在后台标价都是 $0.5/张,走同一个 0.01x 分组,所以选哪个型号都是 5 厘一张。区别只在出图风格。

不在这个分组的型号:grok-imagine-image-lite 在后台有标价,但该分组下暂无可用渠道,实测返回 503,所以不列入上表。

真实调用实测

2026-11-14 实测,同一句 prompt、同一尺寸(1024×1024)、同一分组,只换型号。下表是每一次调用的真实结果。

真实调用测试结果
型号耗时返回格式图片体积扣费
gpt-image-232.0 sb64_json2,263,325 B2,500 额度
gpt-image-2.530.8 sb64_json2,291,537 B2,500 额度
gpt-image-2.5-flare30.5 sb64_json2,481,027 B2,500 额度
gpt-image-2.5-sunburst29.0 sb64_json2,344,380 B2,500 额度
gpt-image-2.630.2 sb64_json2,769,839 B2,500 额度
gpt-image-2.6-sunburst30.3 sb64_json2,622,100 B2,500 额度

样张:同 prompt,只换型号

下面三张是上面实测里真实返回的图片(原图转 WebP,画质 82%,尺寸未改)。是为了让人能直接比出差异,不是精修的宣传图。

gpt-image-2 生成的赛博朋克风格猫,霓虹夜景
gpt-image-2 · 32.0 s · $0.005
gpt-image-2.5 生成的赛博朋克风格猫,霓虹夜景
gpt-image-2.5 · 30.8 s · $0.005
gpt-image-2.6 生成的赛博朋克风格猫,霓虹夜景
gpt-image-2.6 · 30.2 s · $0.005

Prompt:一只赛博朋克风格的猫,霓虹夜景,电影感 · 参数:n=1、size=1024x1024

分辨率支持

分辨率与实测状态
尺寸方向状态
1024x1024方实测通过,六次调用全部返回 1024×1024
1536x1024横官方通用档,本页未实测
1024x1536竖官方通用档,本页未实测

本页只写实测过的结论。其它尺寸是否可用、是否加价,以控制台模型页为准;不支持的尺寸会直接返回 400,不会自动缩放到最近的支持值。

四、参数说明

生图请求参数
参数必填类型说明
model是string生图型号,见上一节
prompt是string画面描述。中文可用;要画面里出现准确的文字,把那段字用引号括起来
n否int一次出几张,默认 1。按张计费,n=4 收 4 张的钱
size否string通用档:1024x1024 方、1536x1024 横、1024x1536 竖。其它尺寸看型号是否支持,不支持会 400
quality否string部分型号支持,取值以控制台模型说明为准;不支持的型号会忽略这个字段
response_format否stringb64_json 或 url。不支持时被忽略,所以代码要按返回内容自适应

尺寸不是越大越好。超出型号支持范围直接 400,不会自动缩。先用 1024x1024 跑通,再逐步试更大的。

五、三种语言写法

Python(官方 SDK)

import base64, pathlib, urllib.request
from openai import OpenAI

client = OpenAI(
    base_url="https://codexplus.shop/v1",
    api_key="YOUR_API_KEY",
)

resp = client.images.generate(
    model="gpt-image-2",
    prompt="一只赛博朋克风格的猫,霓虹夜景,电影感",
    size="1024x1024",
    n=1,
)

item = resp.data[0]
b64 = getattr(item, "b64_json", None)
url = getattr(item, "url", None)

if b64:
    pathlib.Path("out.png").write_bytes(base64.b64decode(b64))
elif url:
    urllib.request.urlretrieve(url, "out.png")
else:
    raise RuntimeError("返回里既没有 b64_json 也没有 url")

print("done -> out.png")

Node.js

import fs from "node:fs";

const res = await fetch("https://codexplus.shop/v1/images/generations", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${process.env.CODEXPLUS_KEY}`,
  },
  body: JSON.stringify({
    model: "gpt-image-2",
    prompt: "一只赛博朋克风格的猫,霓虹夜景,电影感",
    n: 1,
    size: "1024x1024",
  }),
});

if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);

const { data } = await res.json();
const item = data[0];

if (item.b64_json) {
  fs.writeFileSync("out.png", Buffer.from(item.b64_json, "base64"));
} else {
  const img = await fetch(item.url);
  fs.writeFileSync("out.png", Buffer.from(await img.arrayBuffer()));
}

纯 curl

curl -sS "$CODEXPLUS_BASE/images/generations" \
  -H "Authorization: Bearer $CODEXPLUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2","prompt":"霓虹夜景里的猫","size":"1024x1024"}' \
  -o out.json

# 返回里是 b64_json:解码成文件
python3 -c "import json,base64;d=json.load(open('out.json'))['data'][0];open('out.png','wb').write(base64.b64decode(d['b64_json']))"

六、返回格式怎么处理

这是接中转最容易翻车的地方,单独说清楚。

两种返回格式
返回字段是什么怎么处理
data[0].b64_jsonbase64 编码的图片字节base64.b64decode() 后写文件
data[0].url一个可下载的图片链接再发一次 GET 下载下来

为什么会出现两种:同一个接口在不同型号、不同上游实现下回传方式不同。response_format 传了也未必被遵守。

正确姿势:两个字段都判,先看 b64_json,没有再看 url,两个都没有就当错误抛出来——不要静默写一个空文件。

七、报错对照表

常见报错与处理
现象原因怎么解决
401 UnauthorizedKey 错、没带 Bearer、Key 被禁用或额度用完先用 GET /v1/models 验证 Key 通不通
404 not foundBase URL 少了 /v1,或者路径写成 /images/generateBase 用 https://codexplus.shop/v1,路径用 /images/generations
400 invalid size该型号不支持这个分辨率先用 1024x1024 打底,再换尺寸
400 model not found型号名写错,或该型号已下架到控制台模型页复制准确型号名
返回 200 但 data 为空内容策略拦截,或 prompt 触发了限制换描述方式,去掉真实人名、品牌名、敏感场景
存出来的图是 0 字节代码只处理了 b64_json,实际返回的是 url按第六节写两个分支
请求很久没返回生图是同步接口,复杂 prompt 耗时长客户端超时设到 120 秒以上,不要用 10 秒默认值

八、批量与并发

九、为什么要走中转

直连与中转对比
对比项直连官方走 Codexplus
接入方式官方 Key同一个协议,只换 Base URL
付款需要外币卡人民币,按量扣
计价按模型分档所有生图模型统一一个价,5 厘起
网络部分网络环境不稳境内直连,不需额外代理
文本模型另买同一个 Key 也能调 GPT / Claude,见 GPT 中转

十、常见问题

GPT 生图用哪个接口?

和 OpenAI 官方一致:POST /v1/images/generations。Base URL 换成 https://codexplus.shop/v1 就行,官方 SDK 不用改一行代码。

生图多少钱一张?

每张 0.005 元(5 厘)。后台标价 $0.5/张,走 0.01x 倍率的 image 0.005 分组,实扣 $0.005;额度按 1 元 = 1 美元额度 兑换,所以折合人民币也是 0.005 元。

扣减 2,500 额度/张,按张计费不按 token。无月费、无开通费、无最低消费。失败不扣费。实时价格见定价页。

支持哪些生图模型?

gpt-image-2、gpt-image-2.5、gpt-image-2.5-flare、gpt-image-2.5-sunburst、gpt-image-2.6,以及 grok-imagine-image-lite、grok-imagine-image-2.0。完整列表以控制台模型页为准。

返回的是 b64_json 还是图片链接?

两种都可能出现,取决于型号与上游实现。先看 data[0].b64_json 有没有值:有就 base64 解码写文件,没有就下载 data[0].url。只判断其中一种,另一种情况下会存出 0 字节文件。

可以用 OpenAI 官方 SDK 吗?

可以。openai 库的 client.images.generate 直接能用,只需把 base_url 指向 https://codexplus.shop/v1。

Base URL 要不要带 /v1?

要。Base URL 写 https://codexplus.shop/v1,请求路径是 /images/generations,合起来才是 /v1/images/generations。少写 /v1 会 404。

4096x4096 这种大尺寸支持吗?

以型号为准。1024x1024、1536x1024、1024x1536 是通用档;其它尺寸要看具体型号,不支持时接口返回 400,不会自动缩放。

能批量出图吗?

同一个请求里用 n 一次出多张,n=4 就返回 4 张、按 4 张计费。要出几十张建议拆成多个请求并发,并自己控制并发数。

最后更新:2026-11-14 · 型号与价格以控制台为准