Claude Opus 5.5 已在 SeedRouter 上线
LogoSeedRouter
全部文章

GPT Image 2 API Key 获取教程：如何开通并发送第一个请求

获取 GPT Image 2 API Key、安全保存、充值额度，再用 curl、Python 或 JavaScript 发送第一个请求，并了解新 Key 最常遇到的错误。

以 Markdown 阅读

是的，GPT Image 2 有 API，在 SeedRouter 上一个 API Key 就能调用它。登录后在 API Key 页面创建 Key，在账单页充值额度，然后把 Key 放进 Authorization: Bearer 请求头，发送到 https://api.seedrouter.ai/v1/images/generations。Key 只会在创建时完整显示一次，所以请直接把它复制到服务器的环境变量里。

下面的步骤带你从零账号走到拿到一张成图，并讲解导致大多数首次请求失败的四种错误。

如何获取 GPT Image 2 API Key？

  1. 用你的 Google 账号登录 SeedRouter。
  2. 打开 API Key 页面并创建一个 Key。给它起一个能说明运行位置的名字，例如 production-server。
  3. 立即复制 Key。离开这个页面后你只能看到遮蔽后的形式，丢失的 Key 无法找回，只能吊销后重新创建一个。
  4. 在账单页充值额度。Key 一创建就能用，但请求需要额度才能运行。

一个 Key 可以调用 SeedRouter 上的所有模型，所以不需要为 GPT Image 2 和 GPT Image 2.5 分别创建 Key。更好的做法是按环境分别创建 Key，这样吊销预发环境的 Key 也不会影响生产环境。

API Key 应该保存在哪里？

保存在你的服务器上的环境变量里，别的地方都不要放：

export SEEDROUTER_API_KEY="your-key"

绝不要把 Key 放进浏览器端 JavaScript、移动应用安装包或公开代码仓库。任何读到它的人都能花掉你的额度。如果你的产品有前端，让前端调用你自己的后端，再由后端带着 Key 调用 API。

如果 Key 真的泄露了，请立即在 API Key 页面吊销它。被吊销的 Key 会立刻失效，使用它的请求都会被拒绝。

如何用 API Key 发送第一个请求？

把 Key 作为 Bearer token 发送。响应是一个任务引用，而不是图像：

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "An amber glass bottle on a cream background, studio lighting",
    "size": "1024x1024",
    "quality": "low"
  }'

保存响应中的 id，然后带着同样的请求头轮询 GET https://api.seedrouter.ai/v1/tasks/{id}，直到 status 变为 completed。已完成的任务会列出图像 URL。完整的代码循环见 GPT Image 2 API Python 教程。

GPT Image 2 有两个模型 ID，接受的字段相同：gpt-image-2 每交付一张图收一个固定价，gpt-image-2-official 按每次出图报告的 token 计费。同一个 Key 两个都能用。当前价格见模型页。

新 API Key 通常会遇到哪些错误？

错误码HTTP含义处理方法
10001401Key 缺失、输错或已被吊销在 Authorization 请求头中发送完整的 Key
20002400model 的值不是可用的模型 ID准确使用 gpt-image-2 或 gpt-image-2-official
20001400某个字段有误；能确定时错误信息会指出是哪个先修正该字段再重试
30001402账号已没有额度充值额度后重新发送

大多数首次请求失败都源于两个疏忽。一是粘贴 Key 时少了一个字符或多了一个空格，返回 10001。二是从标题里照抄模型名，例如 gpt-image-2.0 或 GPT Image 2，而不是使用模型 ID，返回 20002。这两种情况都会在任何处理开始之前被拒绝，因此不会扣费。

有免费的 GPT Image 2 API Key 吗？

没有。创建 Key 是免费的，但请求要从预付额度中扣费。你不需要为失败付费：以 failed 结束或没有返回图像的任务不收费。额度通过一次性充值购买，永不过期，也没有订阅，所以第一次少量充值就足以把集成完整测试一遍。

同一个 Key 能在 Python 和 JavaScript 中使用吗？

能。Key 只是 HTTP 请求头里的一个字符串，任何能发送 HTTP 请求的语言都能用它。在各个运行环境中都从环境变量读取：Python 用 os.environ["SEEDROUTER_API_KEY"]，Node.js 用 process.env.SEEDROUTER_API_KEY。JavaScript 代码要留在服务端；同一个 Key 放进浏览器代码，就会暴露给每一位访客。

常见问题

在这里使用 GPT Image 2 需要 OpenAI API Key 吗？

不需要。你只需要发送 SeedRouter 的 Key 这一项凭证。通过这个 API 调用 GPT Image 2，不需要在别处另外创建或管理账号。

可以创建多少个 API Key？

足够每台服务器或每个服务各用一个；每个账号的上限远高于一个集成的需要。每个 Key 都可以单独吊销。

在哪里查看一个 Key 花了多少？

在用量记录里。每个请求都会列出模型和扣费金额，便于把新集成的实际花费与你的估算对照。

把 Key 留在服务端，然后上线

按环境分别创建 Key，存进环境变量，并且只从后端以 Bearer token 的形式发送。第一个请求返回任务 id 时，开通这一步就完成了；之后的一切都在 GPT Image 2 API 文档里。

全部文章

相关指南