GPT Image 2 API: Vollständiger Entwickler-Leitfaden mit Preisen und Beispielen

Wenn Sie eine Anwendung entwickeln, die KI-Bildgenerierung benötigt, ist GPT Image 2 eines der fähigsten verfügbaren Modelle. Die Kombination aus fotorealistischer Ausgabe, genauer Textdarstellung und starker Befehlsausführung macht es ideal für Produktionsanwendungen — von E-Commerce-Produktfotografie über Marketing-Automatisierung bis hin zu Kreativ-Tools.

Dieser Leitfaden deckt alles ab, was Entwickler benötigen, um GPT Image 2 über die Kairval API zu integrieren, einschließlich Authentifizierung, Anfrageformaten, Codebeispielen und Best Practices für die Produktion.

API-Übersicht

Die Kairval API bietet eine einheitliche Schnittstelle für den Zugang zu GPT Image 2 und anderen KI-Bildgenerierungsmodellen. Hauptfunktionen:

• Text-zu-Bild-Generierung: Bilder aus Textbeschreibungen erstellen
• Bild-zu-Bild-Bearbeitung: Vorhandene Bilder mit Text-Prompts transformieren
• Mehrere Ausgabeformate: PNG, JPG, WebP
• Verschiedene Seitenverhältnisse: 1:1, 16:9, 9:16, 4:3, 3:4
• Batch-Generierung: Mehrere Bilder in einer einzigen Anfrage generieren
• Asynchrone Verarbeitung: Jobs einreichen und Ergebnisse per Webhook oder Polling abrufen

Authentifizierung

Alle API-Anfragen erfordern Authentifizierung über einen API-Schlüssel:

1. Registrieren Sie sich für ein Kairval-Konto auf kairval.com
2. Generieren Sie einen API-Schlüssel aus Ihren Dashboard-Einstellungen
3. Fügen Sie den Schlüssel in den Authorization-Header jeder Anfrage ein

Authorization: Bearer kv_your_api_key_here

Halten Sie Ihren API-Schlüssel sicher. Exponieren Sie ihn niemals im clientseitigen Code oder öffentlichen Repositories. Verwenden Sie Umgebungsvariablen oder einen Secrets Manager in der Produktion.

Text-zu-Bild-Generierung

Endpunkt

POST https://api.kairval.com/v1/images/generate

Anfrage-Body

{
  "model": "gpt-image-2",
  "prompt": "Ein moderner minimalistischer Arbeitsbereich mit Laptop, Kaffeetasse und Sukkulente auf einem weißen Schreibtisch, weiches natürliches Licht, redaktioneller Fotografie-Stil",
  "aspect_ratio": "16:9",
  "output_format": "png",
  "negative_prompt": "verschwommen, Wasserzeichen, niedrige Qualität"
}

Anfrage-Parameter

Antwort

{
  "id": "gen_abc123",
  "model": "gpt-image-2",
  "created": 1714713600,
  "data": [
    {
      "url": "https://storage.kairval.com/generated/abc123.png",
      "revised_prompt": "Ein sauberer moderner Arbeitsbereich..."
    }
  ]
}

Codebeispiele

Python:

import requests
import os

API_KEY = os.environ.get("KAIRVAL_API_KEY")
API_URL = "https://api.kairval.com/v1/images/generate"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

payload = {
    "model": "gpt-image-2",
    "prompt": "Eine moderne Bürolobby mit Glaswänden, Zimmerpflanzen und warmer Beleuchtung",
    "aspect_ratio": "16:9",
    "output_format": "webp",
    "negative_prompt": "verschwommen, verzerrt, niedrige Qualität"
}

response = requests.post(API_URL, json=payload, headers=headers)
result = response.json()

for image in result["data"]:
    print(f"Bild-URL: {image['url']}")

TypeScript:

const response = await fetch("https://api.kairval.com/v1/images/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KAIRVAL_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gpt-image-2",
    prompt: "Eine moderne Bürolobby mit Glaswänden, Zimmerpflanzen und warmer Beleuchtung",
    aspect_ratio: "16:9",
    output_format: "webp",
    negative_prompt: "verschwommen, verzerrt, niedrige Qualität",
  }),
});

const result = await response.json();

for (const image of result.data) {
  console.log(`Bild-URL: ${image.url}`);
}

Bild-zu-Bild-Bearbeitung

Endpunkt

POST https://api.kairval.com/v1/images/edit

Anfrage-Body

{
  "model": "gpt-image-2",
  "prompt": "Ändern Sie den Hintergrund zu einem tropischen Strand zum Sonnenuntergang",
  "image": "https://example.com/photo.jpg",
  "strength": 0.7,
  "output_format": "png"
}

Der strength-Parameter steuert, wie stark das Modell das Quellbild transformiert. Ein Wert von 0.3 bewirkt subtile Änderungen (Beleuchtungsanpassungen), während 0.9 dramatische Transformationen ermöglicht.

Preise

GPT Image 2 API-Preise auf Kairval sind Credit-basiert:

Besuchen Sie die Preisseite für aktuelle Raten und Volumenrabatte.

Rate Limits

Rate-Limit-Informationen sind in jedem API-Antwort-Header enthalten:

X-RateLimit-Limit: 30
X-RateLimit-Remaining: 27
X-RateLimit-Reset: 1714714200

Fehlerbehandlung

Die API verwendet Standard-HTTP-Statuscodes:

Fehlerantwort-Format:

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate-Limit überschritten. Versuchen Sie es in 60 Sekunden erneut.",
    "type": "rate_limit_error"
  }
}

Best Practices für die Produktion

Prompt-Engineering für APIs

Bei der programmatischen Bildgenerierung müssen Ihre Prompts noch präziser sein als bei der interaktiven Nutzung:

• Vorlagenstrings verwenden: Prompt-Vorlagen mit Variablen-Platzhaltern erstellen
• Eingaben validieren: Vom Benutzer bereitgestellten Prompt-Text vor dem Senden an die API bereinigen
• Qualitäts-Standards setzen: Qualitäts-Keywords und negative Prompts in die Basisvorlage aufnehmen
• Prompts und Ergebnisse protokollieren: Verfolgen Sie, welche Prompts die besten Ergebnisse liefern

Bildspeicherung

Generierte Bild-URLs aus der API sind temporär. Für den Produktionseinsatz:

1. Sofort herunterladen: Das Bild innerhalb des TTL-Zeitfensters abrufen
2. In eigener Infrastruktur speichern: Zu Ihrem CDN, S3-Bucket oder Image-Service hochladen
3. Aggressiv cachen: Generierte Bilder mit Content-Hash für Deduplizierung speichern
4. Aufräumen implementieren: Ungenutzte generierte Bilder entfernen

Kostenoptimierung

• WebP-Format verwenden für Web-Anwendungen — kleinere Dateigrößen bei minimalem Qualitätsverlust
• Bei minimaler benötigter Auflösung generieren — nicht 4K anfordern, wenn Sie nur 1080p benötigen
• Wiederholte Generierungen cachen — ähnliche Bilder aus dem Cache bedienen
• Batch wo möglich — den n-Parameter nutzen, um mehrere Variationen in einer Anfrage zu generieren

Verfügbare Modelle

GPT Image 2 ist eines von vielen Modellen, die über die Kairval API verfügbar sind. Weitere Optionen:

• GPT-4o Image — Schnellere Generierung, gut für einfachere Anwendungsfälle
• Imagen 3 — Google DeepMinds fotorealistisches Modell
• FLUX.2 Pro — Erweiterte Kontrolle mit Multi-Referenz-Bearbeitung
• Ideogram V3 — Am besten für Text-in-Bild-Darstellung
• Recraft V4 Pro — SVG-Ausgabe und Markenfarbkontrolle

Alle Modelle verwenden dieselbe API-Struktur — ändern Sie einfach den model-Parameter.

Jetzt starten

Bereit, GPT Image 2 in Ihre Anwendung zu integrieren?

1. Registrieren Sie sich bei Kairval und generieren Sie einen API-Schlüssel
2. Testen Sie die API mit den obigen Codebeispielen
3. Überprüfen Sie die Preisseite für Credit-Pakete
4. Bauen Sie Ihre Integration nach den Best Practices

Weitere Informationen zu GPT Image 2 finden Sie in unserem vollständigen Leitfaden oder auf der GPT Image 2-Modellseite.