加载中…
TL;DR: 给应用加图像生成功能,过去意味着三道接入门槛:在上游注册账号、绑国际信用卡、配置服务账号。本来想晚上写代码,结果一整夜耗在 IAM 控制台上。
今天 CodeGateway 上线图像生成 API。你现有的sk-cg-key 现在可以调 5 个上游模型Google Imagen 4 (fast / std / ultra)、Google Gemini 2.5 Flash Image、OpenAI gpt-image-2 / 1.5,完全兼容 OpenAI Images API。注册即送 $2 起步额度 —— 按最便宜档位约 100 张图。
CodeGateway 把 Google 和 OpenAI 两家图像生成上游统一收在单个 /v1/images/generations 端点之后。wire-protocol 完全兼容 OpenAI Images API:任何已经在用 OpenAI SDK 的项目,只要把 OPENAI_BASE_URL 改成 https://api.codegateway.dev/v1,key 改成 sk-cg-...,别的什么都不用动。
模型 ID | 路由 | 价格 | 适用场景 |
|---|---|---|---|
| Vertex (Imagen) | $0.02/张 | 速度、成本、写实/概念插画 |
| Vertex (Imagen) | $0.04/张 | 标准质量 |
| Vertex (Imagen) | $0.06/张 | 高端质量 |
| Vertex (Gemini) | 按 token (~$0.04–0.08/张) | 图内文字渲染、信息图标签 |
| OpenAI | $0.005–$0.211/张(质量 × 比例) | UI / 卡通,原生支持 16:9 |
| OpenAI | $0.009–$0.200/张 | 同上,稍弱 —— 适合做兜底 |
价格反映上游公开价格再加 CodeGateway 的阶梯加价(新户 1.5x,地板 1.2x)。完整价格表见 /pricing。
打开 https://www.codegateway.dev,邮箱注册,Dashboard → API Keys → Create Key。无需国际信用卡,新户自动到账 $2 起步额度。
Python:
from openai import OpenAI
client = OpenAI(
api_key="sk-cg-xxxxx",
base_url="https://api.codegateway.dev/v1"
)
response = client.images.generate(
model="imagen-4.0-generate-001",
prompt="A serene mountain landscape at sunset",
n=1,
response_format="b64_json",
)curl:
curl https://api.codegateway.dev/v1/images/generations \
-H "Authorization: Bearer sk-cg-xxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "imagen-4.0-generate-001",
"prompt": "A serene mountain landscape at sunset",
"n": 1,
"response_format": "b64_json"
}'Node.js:
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "sk-cg-xxxxx",
baseURL: "https://api.codegateway.dev/v1",
});
const response = await client.images.generate({
model: "imagen-4.0-generate-001",
prompt: "A serene mountain landscape at sunset",
n: 1,
response_format: "b64_json",
});响应里的 data[0].b64_json 是 base64 编码的 PNG。解码后保存:
import base64
image_data = base64.b64decode(response.data[0].b64_json)
with open("output.png", "wb") as f:
f.write(image_data)每个模型都有清晰的强项区。可以把下面这张表抄到你的 spec 注释里:
场景 | 首选 | 备选 | 单张成本 |
|---|---|---|---|
博客头图(1:1) | Imagen 4 std | Imagen 4 fast | $0.04 / $0.02 |
博客头图(16:9 横版) | gpt-image-2 medium | — | $0.041 |
正文配图(写实风) | Imagen 4 fast | Imagen 4 std | $0.02 / $0.04 |
正文信息图(带文字标签) | gpt-image-2 medium | Gemini 2.5 Flash Image | $0.041 |
步骤图 / 流程图 | gpt-image-2 medium | Gemini 2.5 Flash Image | $0.041 |
产品 UI 概念图 | gpt-image-2 medium | Gemini | $0.041 |
纯装饰 / 抽象 / 背景 | Imagen 4 fast | — | $0.02 |
OG / 社交卡片(1.91:1) | gpt-image-2 medium | Imagen 4 std + 裁剪 | $0.041 |
完整推理过程 + 5 段 prompt 横向对比见 Imagen 4 vs Gemini 2.5 Flash Image vs GPT Image:实跑横评。
维度 | 直连 Google Vertex AI | 直连 OpenAI Images | CodeGateway |
|---|---|---|---|
开户流程 | GCP 项目 + 服务账号 | OpenAI API 账号 | 仅邮箱 |
支付方式 | 国际信用卡(GCP 计费) | 国际信用卡(OpenAI 计费) | Stripe / 支付宝 / 微信均可 |
上手时间 | 30+ 分钟(IAM、配额、预算) | 5–10 分钟 | 2 分钟 |
起步额度 | 无 | 无 | $2 免费 |
协议 | Vertex 原生(不兼容 OpenAI) | OpenAI Images API | OpenAI Images API(一套代码,双家上游) |
跨厂商切换 | 重新注册 + 改写代码 | 重新注册 + 改写代码 | 改 |
计费 | 按上游各自规则 | OpenAI 自有规则 | 按上游 + 阶梯加价(地板 1.2x) |
本次发布的核心价值:在 CodeGateway 里,「切模型」就是改一个字段,「切上游」也是改一个字段。没有锁定 —— 这是本次上线最关键的工程价值。
上线前,我们用这套 API 给自己的 4 篇博客生成了 16 张头图和正文配图:
imagen-4.0-generate-001:$0.16imagen-4.0-fast-generate-001:$0.06gemini-2.5-flash-image:$0.54gpt-image-2 medium:$0.164合计:$0.92 / 16 张图 / 4 个混合模型 / 一个 key。完整复盘 + 可复现 spec 见 真实账单:1 小时内 $0.92 出 16 张博客头图。
完整生成脚本已开源在 Whitedit/code-gateway-cookbook —— generate.py + spec-example.yaml,MIT 协议,直接抄改即可。
Q:一个 CodeGateway key 真的能调全部 5 个上游模型?
A:可以。网关按请求 body 里的 model 字段路由 —— imagen-* / gemini-* 走 Vertex AI 路由;gpt-image-* 走 OpenAI 路由。客户端代码完全不用改。
Q:生成图片的著作权归谁?
A:归你。Google 和 OpenAI 的 ToS 都允许商用(Google 生成式 AI 条款 / OpenAI 使用政策)。CodeGateway 只做网关,不主张任何权利。但 著作权 ≠ 合规 —— 不要生成公众人物 / 侵权商标 / 违反平台政策的内容。
Q:失败的请求会扣钱吗?
A:不会。4xx / 5xx 响应 不计费,只有携带 b64_json 或 url 的成功响应才扣余额。我们 Sprint 4b 自吃狗粮的 16 张图全部一次过。
Q:上游模型会下架或调价吗?
A:上游 Google / OpenAI 按自己节奏发布通告。CodeGateway 网关跟随上游 —— 上游调价时,我们 CMS 的价格表会同步更新,新价立刻显示在 /pricing。进行中的请求按提交时刻的价格结算。
Q:阶梯加价和图像 API 用量怎么联动?
A:图像 API 的消费计入你的 90 天滚动累计 消费窗口 —— 与文本 API 用量合并算。新户 1.5x;累计满 $10 降到 1.4x;地板 1.2x。图像 + 文本 API 混合使用 比单边走更快触达低档加价。详见 阶梯加价说明。
Q:Imagen 4 后端真的固定 1024×1024?
A:是的。Imagen 4 路由目前固定 1024×1024;传入 aspect_ratio 会「接受但忽略」。要 16:9 / 9:16 横版/竖版,请切到 gpt-image-2(OpenAI 路由原生支持 size)。
Q:现有 OpenAI SDK 代码能零改动迁移过来吗?
A:可以。把 OPENAI_BASE_URL 改成 https://api.codegateway.dev/v1,把 OPENAI_API_KEY 改成 sk-cg-xxx,应用代码原封不动。Cursor、Aider 这些工具同理。
Q:下一步会上哪些模型?
A:路线图:FLUX 系列、Stable Diffusion 3.x、DALL-E 4(等 OpenAI 发布)、自定义 LoRA 微调路由。详见 /roadmap。
工具的本职,是 让你少做配置,多去创造。一个 key、5 个模型、$2 起步额度 —— 把「选哪个 API、怎么注册、怎么计费」三件事压缩到一个动作里。省下来的精力,留给真正重要的工作。