ReferenzGPT Image 2.5 Stabil

API-Leitfaden für das TopviewAI Pro Studio

Verwalten Sie API-Schlüssel und verstehen Sie Studioanfragen nach der Anmeldung. Das Bildbeispiel nutzt GPT Image 2.5; andere Modelle haben eigene Anfrageformate.

https://topviewai.pro

Schnellstart

Führen Sie Ihren ersten API-Aufruf in zwei Schritten aus: Aufgabe einreichen und Status abfragen.

Aufgabe einreichen

Senden Sie eine POST-Anfrage an den Generate-Endpunkt, um eine Task ID zu erhalten.

Status abfragen

Verwenden Sie die Task ID, um den Fortschritt zu überprüfen, bis die Bild-URL verfügbar ist.

Authentifizierung

Diese Studio-Endpunkte benötigen eine angemeldete Sitzung und einen API-Schlüssel. Ein Bearer-Schlüssel allein reicht nicht. Halten Sie Ihren Schlüssel geheim.

HTTP-Header

Authorization: Bearer {YOUR_API_KEY}

POST

https://topviewai.pro/api/image/gpt-image-2-5/generate

Senden Sie eine Bildanfrage an GPT Image 2.5. Die Antwort enthält eine task_id; fragen Sie das Ergebnis am zugehörigen Status-Endpunkt ab.

Die Anfrage läuft asynchron: Speichern Sie task_id und fragen Sie den Status bis SUCCESS oder einem abschließenden Fehler ab.

Body-Parameter

Parametername	Typ	Erforderlich	Beschreibung
`prompt`	string	Ja	Beschreiben Sie das Bild mit 1 bis 20.000 Zeichen.
`aspect_ratio`	string	Nein	Optionales Seitenverhältnis; Standard ist auto. Beispiele: 1:1, 4:3, 3:4, 16:9, 9:16.

Antwort (JSON)

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "IN_PROGRESS"
  }
}

GET

https://topviewai.pro/api/image/gpt-image-2-5/status

Abfrage des Ausführungsstatus und Ergebnisses einer Aufgabe.

Query-Parameter

Parametername	Erforderlich	Beschreibung
`task_id`	Ja	Die beim Einreichen der Aufgabe zurückgegebene ID.

Antwortbeispiel

{
  "code": 200,
  "message": "success",
  "data": {
    "status": "SUCCESS",
    "task_id": "xxxxxxxx",
    "request": {
      "prompt": "Ein Sonnenuntergang über den Bergen",
      "aspect_ratio": "16:9"
    },
    "response": [
      "https://cdn.example.com/images/task_xxx_0.jpeg"
    ],
    "consumed_credits": 4,
    "created_at": "2026-11-05 13:05:09",
    "error_message": null
  }
}

Abrechnung

Kostenbeispiel für GPT Image 2.5

4 Credits / 1K-Bild

Die Kosten variieren nach Modell, Auflösung und Einstellungen. Prüfen Sie die Studioschätzung und den im Auftrag gemeldeten Verbrauch.

Fehlerbehandlung

401 UnbefugtUngültiger API-Schlüssel
402 Zahlung erforderlichUnzureichendes Guthaben
429 Zu viele AnfragenAnfragelimit erreicht

Über TopviewAI Pro

Ein gemeinsames Studio für Video, Bilder, Bearbeitung, Sprache und Audio.

Für jede Aufgabe das Modell wählen

Nutzen Sie Seedance 2.5 für Video, GPT Image 2.5 für Bilder und die weiteren Modelle im Studio. Jedes Modell behält seinen echten Namen.

Ein Guthaben, modellabhängige Kosten

Wählen Sie ein Abo oder eine einmalige Aufladung nach Bedarf. Credits bezahlen die tatsächlich genutzten Modelle und Werkzeuge.

Bildwerkzeuge Videowerkzeuge