CodeGateway 图像生成 API 上线：一个 Key 调 5 个模型，按用量计费

图像生成 API 上线:一个 Key 调 5 个模型,按用量计费

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 张图。

目录

1. 一句话发布说明
2. 5 个模型 + 真实价格
3. 3 步集成示例
4. 按场景选模型(决策表)
5. 对比直连 Google / OpenAI
6. 真实账单:4 篇博客、16 张图自吃狗粮
7. FAQ
8. 立即开始

一句话发布说明

CodeGateway 把 Google 和 OpenAI 两家图像生成上游统一收在单个 /v1/images/generations 端点之后。wire-protocol 完全兼容 OpenAI Images API:任何已经在用 OpenAI SDK 的项目,只要把 OPENAI_BASE_URL 改成 https://api.codegateway.dev/v1,key 改成 sk-cg-...,别的什么都不用动。

5 个模型 + 真实价格

价格反映上游公开价格再加 CodeGateway 的阶梯加价(新户 1.5x,地板 1.2x)。完整价格表见 /pricing。

3 步集成示例

Step 1:注册 + 拿 key(~2 分钟)

打开 https://www.codegateway.dev,邮箱注册,Dashboard → API Keys → Create Key。无需国际信用卡,新户自动到账 $2 起步额度。

Step 2:调 API(用任意 OpenAI SDK)

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",
});

Step 3:保存图片

响应里的 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 注释里:

完整推理过程 + 5 段 prompt 横向对比见 Imagen 4 vs Gemini 2.5 Flash Image vs GPT Image:实跑横评。

对比直连 Google / OpenAI

本次发布的核心价值:在 CodeGateway 里,「切模型」就是改一个字段,「切上游」也是改一个字段。没有锁定 —— 这是本次上线最关键的工程价值。

真实账单:4 篇博客、16 张图自吃狗粮

上线前,我们用这套 API 给自己的 4 篇博客生成了 16 张头图和正文配图:

• 4 张头图,用 imagen-4.0-generate-001:$0.16
• 3 张写实正文图,用 imagen-4.0-fast-generate-001:$0.06
• 9 张带标签信息图,用 gemini-2.5-flash-image:$0.54
• 4 张 16:9 横版头图重出,用 gpt-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 协议,直接抄改即可。

FAQ

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。

立即开始

• 注册:https://www.codegateway.dev(仅邮箱,送 $2 起步额度)
• 价格:/pricing
• 模型目录:/models
• 开源生成脚本:Whitedit/code-gateway-cookbook · image-gen/

延伸阅读

• Imagen 4 vs Gemini 2.5 Flash Image vs GPT Image —— 5 段 prompt 横向对比
• 真实账单:1 小时内 $0.92 出 16 张博客头图 —— 完整自吃狗粮复盘
• Codex CLI vs Claude Code:按任务选工具 —— 同款「按场景选」框架
• 充值与计费指南 —— Stripe / 支付宝 / 微信
• 阶梯加价说明 —— 90 天滚动,地板 1.2x
• Google Cloud —— Imagen 4 模型卡
• OpenAI —— Image Generation 指南

工具的本职,是 让你少做配置,多去创造。一个 key、5 个模型、$2 起步额度 —— 把「选哪个 API、怎么注册、怎么计费」三件事压缩到一个动作里。省下来的精力,留给真正重要的工作。