GPT-Image-2 API ガイド

GPT-Image-2 — OpenAI Image Generation API

TokenHub の統合 API を通じて OpenAI の最新 image generation model にアクセスできます。OpenAI-compatible に完全対応しており、同期レスポンス（polling 不要）、最大 4K までの複数サイズ、quality レベル、PNG/JPEG/WebP 出力形式をサポートします。text-to-image (t2i) と image-to-image editing (i2i、multi-image composition & inpainting) の両方に対応しています。このガイドでは、統合手順を一通り説明します。

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

1API 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

認証

すべての request では、header に API Key が必要です:

Header

Authorization: Bearer th-your-api-key

Endpoints（同期式、OpenAI-compatible）

POST

/images/generations

Text-to-image。text prompt から image を生成します。

POST

/images/edits

Image-to-image editing。単一 image の編集、multi-image composition、mask を使った任意の inpainting に対応しています。

3料金

Tier	価格	解像度範囲
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 を受け付けます。複数指定すると1つの出力に合成できます。
mask	file / string	任意	—	任意のインペインティングマスクです。透明部分が再生成され、不透明部分は保持されます。
input_fidelity	string	任意	low	入力をどの程度保持するかです。選択肢: low, high。identity/layout を維持したい場合は high、より大胆に変換したい場合は low を使用してください。
output_format	string	任意	png	編集エンドポイント用の '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 サイズを使用してください。
このエンドポイントは同期処理です。task id も polling もありません。リクエストは通常、サイズと品質に応じて 5〜30 秒で完了します。
大きな画像での早期切断を避けるため、クライアント側の HTTP timeout は 120 秒以上に設定してください。

9FAQ

準備はできましたか？

TokenHub に登録して、今すぐ GPT-Image-2 API を使い始めましょう

API Key を取得 Credits をチャージ