GPT-Image-2 API 指南

GPT-Image-2 — OpenAI 圖片生成 API

透過 TokenHub 統一 API 存取 OpenAI 最新的圖片生成 model。完全相容 OpenAI，支援同步回應（無需輪詢）、最高 4K 的多種尺寸、quality 等級，以及 PNG/JPEG/WebP 輸出格式。支援文字轉圖片（t2i）與圖片轉圖片編輯（i2i、多圖合成與 inpainting）。本指南將帶你完成完整整合。

Text → ImageImage → Image (i2i)OpenAI-CompatibleSynchronousUp to 4KToken-based

1取得你的 API Key

前往 tokenhub.store 建立帳戶（支援 GitHub / Google 登入）
前往 Dashboard → API Keys，點選「Create New Key」
前往 Dashboard → Billing 充值 Credits（1 Credit = $1 USD）
複製你的 API Key（格式： th-xxxxxxxxxxxx...)

⚠️ API Key 只會在建立時顯示一次，請妥善保存。若遺失，需重新建立一組。

2API 概覽

Base URL

https://tokenhub.store/api/v1

驗證

所有請求都需要在標頭中帶上 API Key：

Header

Authorization: Bearer th-your-api-key

端點（同步、OpenAI-compatible）

POST

/images/generations

文字轉圖片。根據文字提示生成圖片。

POST

/images/edits

圖片轉圖片編輯。支援單張圖片編輯、多圖合成，以及可選的遮罩 inpainting。

3價格

層級	價格	解析度範圍
1K	$0.125 / image	最長邊 ≤ 1536 px（例如 1024×1024、1024×1536）
2K	$0.250 / image	最長邊 ≤ 2048 px（例如 2048×2048）
4K	$0.500 / image	最長邊 > 2048 px（例如 4096×4096）

依輸出解析度級距採固定每張定價（由尺寸的最長邊決定）。n 張圖片 = 單價 × n。失敗的請求不收費。

依最長邊對應級距：≤ 1536 px → 1K（$0.125），≤ 2048 px → 2K（$0.250），> 2048 px → 4K（$0.500）。範例：1024×1024 與 1024×1536 都是 1K；2048×2048 是 2K；4096×4096 是 4K。

4請求參數

參數	類型	必填	預設值	說明
model	string	必填	—	model ID。使用 "openai/gpt-image-2"（或簡寫 "gpt-image-2"）。
prompt	string	必填	—	描述要生成的圖片的文字提示詞。
n	integer	選填	1	要生成的圖片數量（1–10）。
size	string	選填	1024x1024	輸出尺寸。選項：1024x1024、1536x1024、1024x1536、2048x2048、2048x1152、3840x2160、2160x3840、auto。
quality	string	選填	auto	生成品質。選項：auto、low、medium、high。較高品質會消耗更多 Tokens。
format	string	選填	png	輸出圖片格式。選項：png、jpeg、webp。

/images/edits 的額外欄位（i2i）

參數	類型	必填	預設值	說明
image	file / string \| array	必填	—	要編輯的輸入圖片。可透過 multipart 接收檔案，或在 JSON 中提供 URL / base64 data URI。可提供多張以合成為一張輸出。
mask	file / string	選填	—	可選的 inpainting mask。透明區域會被重新生成；不透明區域會被保留。
input_fidelity	string	選填	low	保留輸入內容的程度。選項：low、high。使用 high 以保留身份／版面配置；使用 low 以進行更大幅度的變換。
output_format	string	選填	png	edit endpoint 的 'format' 別名。選項：png、jpeg、webp。
output_compression	integer	選填	100	壓縮等級 0–100（僅適用於 jpeg / webp）。

5完整 curl 範例

bash

curl -X POST https://tokenhub.store/api/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "prompt": "A serene Japanese garden at sunset, koi pond reflections, cherry blossoms, soft cinematic lighting, ultra-detailed"
  }'

回應：

json

{
  "created": 1740000000,
  "data": [
    {
      "url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
    }
  ]
}

6Python 完整範例

python

# pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://tokenhub.store/api/v1",
)

result = client.images.generate(
    model="openai/gpt-image-2",
    prompt="A majestic dragon flying over snowy mountains at dawn, epic fantasy art, ultra-detailed",
    n=1,
    size="1536x1024",
    quality="high",
)

image_url = result.data[0].url
print("Image URL:", image_url[:80], "...")

7JavaScript / Node.js 完整範例

javascript

// npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://tokenhub.store/api/v1",
});

const result = await client.images.generate({
  model: "openai/gpt-image-2",
  prompt: "A majestic dragon flying over snowy mountains at dawn, epic fantasy art, ultra-detailed",
  n: 1,
  size: "1536x1024",
  quality: "high",
});

console.log("Image URL:", result.data[0].url.slice(0, 80), "...");

8使用建議

英文提示詞通常能得到最佳結果；也支援中文。
Response data[].url 可能是純 https URL 或 data URI（base64）。儲存到磁碟時請同時處理這兩種情況。
為了降低成本，草稿階段可使用 low/medium 品質，僅在最終輸出時使用 high/4K 尺寸。
此 endpoint 是同步的——沒有 task id，也不需要輪詢。請求通常會在 5–30 秒內完成，取決於尺寸與品質。
請在用戶端將 HTTP timeout 設為 ≥ 120s，以避免大型圖片時過早斷線。

9FAQ

準備開始了嗎？

註冊 TokenHub，立即開始使用 GPT-Image-2 API

取得 API Key 儲值 Credits