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 就不會影響正式環境。

API Key 應該存放在哪裡？

存放在你的伺服器上的環境變數裡，其他地方都不要放：

export SEEDROUTER_API_KEY="your-key"

絕不要把 Key 放進瀏覽器端的 JavaScript、行動 App 的安裝包或公開的程式碼儲存庫。任何看得到它的人都能花掉你的額度。如果你的產品有前端，就讓前端呼叫你自己的後端，再由後端帶著 Key 呼叫 API。

如果 Key 真的外洩了，請立刻到 API Key 頁面撤銷它。撤銷後的 Key 會立即失效，使用它的請求都會被拒絕。

如何用這把 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。完整的程式迴圈請見 用 Python 呼叫 GPT Image 2 API。

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 參考文件裡。

全部文章

相關指南