GPT-Image-2 API-Anleitung

GPT-Image-2 — OpenAI Image Generation API

Greifen Sie über die TokenHub einheitliche API auf OpenAI's neuestes Bildgenerierungsmodel zu. Vollständig OpenAI-compatible, mit synchroner Antwort (kein Polling erforderlich), mehreren Größen bis zu 4K, Qualitätsstufen und PNG/JPEG/WebP-Ausgabeformaten. Unterstützt sowohl Text-to-Image (t2i) als auch Image-to-Image-Bearbeitung (i2i, Multi-Image-Komposition & Inpainting). Diese Anleitung führt Sie durch die vollständige Integration.

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

1API Key erhalten

Besuchen Sie tokenhub.store um ein Konto zu erstellen (GitHub / Google-Anmeldung unterstützt)
Gehen Sie zu Dashboard → API Keys und klicken Sie auf "Create New Key"
Gehen Sie zu Dashboard → Billing, um Credits hinzuzufügen (1 Credit = 1 USD)
Kopieren Sie Ihren API Key (Format: th-xxxxxxxxxxxx...)

⚠️ Der API Key wird bei der Erstellung nur einmal angezeigt. Speichern Sie ihn sicher. Wenn er verloren geht, müssen Sie einen neuen erstellen.

2API-Übersicht

Base URL

https://tokenhub.store/api/v1

Authentifizierung

Alle Anfragen erfordern einen API Key im Header:

Header

Authorization: Bearer th-your-api-key

Endpoints (synchron, OpenAI-compatible)

POST

/images/generations

Text-to-image. Bilder aus einem Text-Prompt generieren.

POST

/images/edits

Image-to-image-Bearbeitung. Unterstützt Bearbeitungen einzelner Bilder, Multi-Image-Komposition und optionales Inpainting mit einer Maske.

3Preisgestaltung

Stufe	Preis	Auflösungsbereich
1K	$0.125 / image	Längste Seite ≤ 1536 px (z. B. 1024×1024, 1024×1536)
2K	$0.250 / image	Längste Seite ≤ 2048 px (z. B. 2048×2048)
4K	$0.500 / image	Längste Seite > 2048 px (z. B. 4096×4096)

Pauschaler Preis pro Bild basierend auf der Ausgaberesolution-Stufe (bestimmt durch die längste Seite der Größe). n Bilder = Stückpreis × n. Fehlgeschlagene Aufrufe werden nicht berechnet.

Zuordnung der Stufe nach der längsten Seite: ≤ 1536 px → 1K ($0.125), ≤ 2048 px → 2K ($0.250), > 2048 px → 4K ($0.500). Beispiele: 1024×1024 und 1024×1536 sind beide 1K; 2048×2048 ist 2K; 4096×4096 ist 4K.

4Anforderungsparameter

Parameter	Typ	Erforderlich	Standard	Beschreibung
model	string	Erforderlich	—	Model-ID. Verwenden Sie "openai/gpt-image-2" (oder die Kurzform "gpt-image-2").
prompt	string	Erforderlich	—	Text-Prompt, der das zu generierende Bild beschreibt.
n	integer	Optional	1	Anzahl der zu generierenden Bilder (1–10).
size	string	Optional	1024x1024	Ausgabedimensionen. Optionen: 1024x1024, 1536x1024, 1024x1536, 2048x2048, 2048x1152, 3840x2160, 2160x3840, auto.
quality	string	Optional	auto	Generierungsqualität. Optionen: auto, low, medium, high. Höhere Qualität verbraucht mehr Tokens.
format	string	Optional	png	Ausgabe-Bildformat. Optionen: png, jpeg, webp.

Zusätzliche Felder für /images/edits (i2i)

Parameter	Typ	Erforderlich	Standard	Beschreibung
image	file / string \| array	Erforderlich	—	Eingabebild(er) zum Bearbeiten. Akzeptiert Datei(en) per multipart oder URL / base64 data URI in JSON. Mehrere Bilder können zu einem Ausgabeergebnis kombiniert werden.
mask	file / string	Optional	—	Optionale Inpainting-Maske. Transparente Bereiche werden neu generiert; opake Bereiche bleiben erhalten.
input_fidelity	string	Optional	low	Wie stark die Eingabe beibehalten werden soll. Optionen: low, high. Verwenden Sie high, um Identität/Layout beizubehalten; verwenden Sie low für stärkere Transformationen.
output_format	string	Optional	png	Alias von 'format' für den Edit-Endpunkt. Optionen: png, jpeg, webp.
output_compression	integer	Optional	100	Komprimierungsstufe 0–100 (nur für jpeg / webp).

5Vollständiges curl-Beispiel

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"
  }'

Antwort:

json

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

6Vollständiges Python-Beispiel

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], "...")

7Vollständiges JavaScript / Node.js-Beispiel

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), "...");

8Hinweise zur Nutzung

Englische Prompts liefern in der Regel die besten Ergebnisse; Chinesisch wird ebenfalls unterstützt.
Response data[].url kann eine normale https-URL oder eine data URI (base64) sein. Beim Speichern auf der Festplatte beide Fälle behandeln.
Um Kosten zu senken, verwenden Sie für Entwürfe low/medium quality und nur für die finale Ausgabe high/4K-Größen.
Der Endpunkt ist synchron — keine task id, kein Polling. Eine Anfrage dauert je nach Größe und Qualität normalerweise 5–30 Sekunden.
Setzen Sie auf Client-Seite ein HTTP-Timeout von ≥ 120s, um vorzeitige Verbindungsabbrüche bei großen Bildern zu vermeiden.

9FAQ

Bereit loszulegen?

Registriere dich bei TokenHub und beginne jetzt mit der Nutzung der GPT-Image-2 API

API Key erhalten Credits aufladen