GPT Image 2.6 Sunburst · Token · API

クイックスタート

3 ステップで動きます：タスクを送信 → 結果を照会 → 画像のリンクを受け取る。YOUR_API_KEY をご自身のキーに置き換えれば、下のコマンドはそのまま実行できます。

ステップ 1 · タスクを送信（すぐにタスク ID が返ります。HTTP 202）

curl https://kovapi.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-image-2.6-sunburst-token", "prompt": "夕暮れの港を描いた油絵、筆跡がはっきり見える、暖色系の配色", "size": "16:9", "resolution": "2K"}'

レスポンス（HTTP 202）

{
  "id": "img_7f3c9a1e2b4d6f8a0c1e3b5d",
  "object": "image.generation.job",
  "status": "queued",
  "created": 1791281400,
  "model": "gpt-image-2.6-sunburst-token"
}

ステップ 2 · status が succeeded か failed になるまで、2〜3 秒ごとに照会

curl https://kovapi.com/v1/images/jobs/img_7f3c9a1e2b4d6f8a0c1e3b5d \
  -H "Authorization: Bearer YOUR_API_KEY"

成功時のレスポンス

{
  "id": "img_7f3c9a1e2b4d6f8a0c1e3b5d",
  "object": "image.generation.job",
  "status": "succeeded",
  "created": 1791281400,
  "model": "gpt-image-2.6-sunburst-token",
  "data": [
    {"url": "https://img.kovapi.com/i/2be8cd16d37f3a4b9c0e1f2a3b4c5d6e.png"}
  ],
  "usage": {"images": 1, "resolution": "2K", "model": "gpt-image-2.6-sunburst-token"}
}

ステップ 3 · data[0].url が画像（PNG）のリンクです。保存期間は 15 日間なので、長く使う場合はご自身のストレージにダウンロードしてください。

完全なサンプル（Python：送信 → 待機 → ローカルに保存）

import time
import requests

BASE = "https://kovapi.com/v1"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

# 1. タスクを送信
job = requests.post(f"{BASE}/images/generations", headers=HEADERS, json={
    "model": "gpt-image-2.6-sunburst-token",
    "prompt": "夕暮れの港を描いた油絵、筆跡がはっきり見える、暖色系の配色",
    "size": "16:9",
    "resolution": "2K",
}).json()
if "error" in job:
    raise SystemExit(job["error"]["message"])

# 2. 終わるまで 3 秒ごとに照会
while job["status"] not in ("succeeded", "failed"):
    time.sleep(3)
    job = requests.get(f"{BASE}/images/jobs/{job['id']}", headers=HEADERS).json()

# 3. 画像をダウンロード
if job["status"] == "succeeded":
    url = job["data"][0]["url"]
    with open("gpt-image-2.6-sunburst-token.png", "wb") as f:
        f.write(requests.get(url).content)
    print("saved", url)
else:
    print("failed:", job["error"]["code"], job["error"]["message"])

認証

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

コンソールで API Key を作成すると利用を開始できます。

リクエストパラメータ

POST /v1/images/generations のリクエスト本文（JSON）：

background に transparent（透明背景。PNG か WebP 出力と組み合わせてください）を指定できます。output_format は png（既定）、jpeg、webp。n は 1 のみ。表にないパラメーターは送信時に 400 unsupported_image_parameter を返し、課金しません。結果は url で返し、usage にそのジョブのトークン数と課金額が入ります。

トークン課金

送信時にサイズ・画質・参照画像の枚数から上限額を仮押さえし、生成後に OpenAI が返す実際の使用量で精算して、差額はその場で返します。失敗時は全額返金です。100 万トークンあたりの価格：

実測の出力トークンと費用（入力は含まず）

同じサイズ・画質なら出力トークンは毎回同じで、プロンプトに左右されません。参照画像は 1 枚あたり約 700–1,600 の画像入力トークンです。

比率・解像度・出力サイズ

size に比率、resolution に段階を指定します。生成されたオリジナル画像を切り抜き・リサイズなしで、下表のサイズのまま納品します。幅と高さはいずれも 16 の倍数で、4K は 1 辺 3840 px 以内・総画素数約 830 万以内です。

• 表の 15 種類の比率に対応します。それ以外の比率は送信時に 400 を返し、課金しません。size を auto にして参照画像を渡すと、1 枚目の参照画像に最も近い比率で生成し、参照画像がなければ 1:1 です。1K のいくつかの細長い比率はモデルの最小ピクセル数を下回るため、表のとおり拡大したサイズで生成します（16:9 は 1088×608）。
• size にはピクセルサイズ（例：1536x1024）も指定できます。比率は表の 15 種類のいずれかで、幅と高さは 16 の倍数に切り下げ、その段階の上限を超えると等倍で縮小、小さすぎるとモデルの最小ピクセル数（約 65.5 万）まで等倍で拡大します。段階は resolution で決まり、ない場合は長辺で判断します：1536 以下は 1K、2048 以下は 2K、それより大きいと 4K。長辺の範囲は 1K が 512–1536、2K が 2016–2304、4K が 2049–4096 で、外れると送信時に 400 を返し、課金しません。

画質とネイティブ解像度

• quality を指定しないと medium で生成します。画質が変えるのはトークン数と料金だけで、サイズは変わりません。auto はモデルが決め、仮押さえは max で見積もり、精算は実際の使用量です。
• quality に 1K、2K、4K が入っていて resolution がない場合は、解像度ティアとして扱います（サイズも料金もそのティアになります）。
• 混雑時はジョブがすぐ失敗せずに順番待ちになります。長く待っても（約 15 分）画像が出ないときは失敗として全額返金し、そのまま再送信できます。

画像から画像と参照画像

• image（1 枚）か images（複数、最大 16 枚。超えた分は使いません）を渡すと画像から画像になります。プロンプトでどう変えるかを書いてください。POST /v1/images/edits も同じパラメーターで使えます。
• どちらのエンドポイントも JSON の本文だけを受け付け、multipart でのファイルアップロードには対応していません。そのため OpenAI SDK の images.edit() はそのままでは使えません。下の例のように、リンクまたは base64 で渡してください。
• 参照画像はそれぞれ公開リンク（http / https）、data: URI、またはプレーンな base64 で、1 枚 16MB まで、形式は PNG、JPEG、WebP に限ります。それ以外の形式の参照画像はジョブが失敗し、全額返金されます。
• URL は画像そのものを直接ダウンロードできるものにしてください。ウェブページや、ログインが必要な URL、直リンク禁止の URL は使えません。読み込めない参照画像は送信時に 400 で拒否され、どの画像がなぜ読めないかが示されます。タスクは作成されず、課金もされません。
• 出力の比率は参照画像ではなく size で決まります。元の画像の比率を保ちたい場合は、size をその比率にしてください。
• 参照画像は当サイトで代わりにホストし、7 日間保存します。

参照画像 2 枚で画像から画像

curl https://kovapi.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-image-2.6-sunburst-token", "prompt": "人物はそのままに、背景を夜の海辺に変えて、暖かい色のストリングライトを添える", "images": ["https://example.com/people.jpg", "https://example.com/beach.jpg"], "size": "3:4", "resolution": "2K"}'

タスクの状態と返却フィールド

GET /v1/images/jobs/{id} は次のステータスを返します。各フィールドの説明は 非同期タスク をご覧ください。2〜3 秒ごとに照会するか、Webhook を使ってください。

1 つのアカウントで同時に生成できるタスクは 50 件までで、それ以上は送信順に順番待ちになります。15 分たっても始まらないタスクは失敗となり、全額返金されます。タスクの記録は 3 日間、画像のリンクは 15 日間保存されます。

生成にかかる時間

送信から結果まで通常 20〜60 秒です。4K、複数の参照画像を使う編集、混雑時はもう少しかかり、まれに 1〜2 分かかるジョブもあります。

エラーと返金

送信時のエラーはすぐに HTTP 4xx / 5xx で返り、タスクは作成されず、課金もされません。受け付け後の失敗は照会エンドポイントで報告され、確保額は全額返金されます。すべてのコードは エラーコード に載っています。

送信時に返るエラー

失敗したタスク（status が failed）

ポーリングの代わりに Webhook を使う

送信時に callback_url を付けると、タスクが終わった時点で（成功・失敗とも）、照会エンドポイントが返すものとまったく同じ内容をゲートウェイがその URL へ送ります。署名付きで、届かなかった場合は自動で再試行します。コンソールの「設定 → Webhook」で、アカウント全体の送信先を設定することもできます。 Webhook のドキュメント →

curl https://kovapi.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-image-2.6-sunburst-token", "prompt": "夕暮れの港を描いた油絵、筆跡がはっきり見える、暖色系の配色", "size": "1:1", "callback_url": "https://your-domain.com/webhook"}'