Bilder

Die Bildgenerierung wird in der Dokumentennavigation dargestellt, sodass ausländische Dokumente eine konsistente Produktkarte behalten. Die Verfügbarkeit öffentlicher Endpunkte im Ausland ist schemagesteuert. Überprüfen Sie GET /api/openapi.json, bevor Sie Bildendpunkte aus dem Produktionscode aufrufen.

Anfrage

Wenn Image-Endpunkte aktiviert sind, erwarten Sie ein asynchrones Aufgabenmodell: Erstellen Sie eine Aufgabe mit einer Eingabeaufforderung und Modelloptionen und fragen Sie dann nach Abschluss ab. Anfragen verwenden weiterhin die Inhaberauthentifizierung:

Authorization: Bearer KITTA_API_KEY

Überseepfade nicht aus anderen Dokumenten ableiten. Verwenden Sie für die bereitgestellte Umgebung nur Pfade, die im ausländischen OpenAPI-Schema vorhanden sind.

Antwort

Zu den Antworten auf Bildaufgaben gehören in der Regel die Aufgaben-ID, der Status, die URL des Ergebnisbilds bei Erfolg und ein Fehlercode bei einem Fehler. Speichern Sie die Aufgaben-ID vor der Abfrage, damit Benutzer das Ergebnis nach der Seitenaktualisierung oder dem Neustart des Workers wiederherstellen können.

Abrechnung und Gutschriften

Die Kosten für die Bilderzeugung richten sich möglicherweise nach Modell, Auflösung, Referenzbildern oder erfolgreicher Aufgabe. Überprüfen Sie die Eingabeaufforderungsgröße und das Eingabemedium, bevor Sie eine Aufgabe erstellen, und überprüfen Sie das Profil vor großen Stapeln.

Fehler

Behandeln Sie nicht unterstützte Modelle, ungültige Referenzbilder, unzureichende Credits und Verarbeitungsfehler separat. Wenn in GET /api/openapi.json keine Bildendpunkte vorhanden sind, behandeln Sie die Funktion als nicht öffentlich verfügbar für das Konto.

Kanonische OpenAPI-Endpunkte

• Modelle auflisten: GET /api/open/v1/media/models?mediaType=image
• Bild erzeugen: POST /api/open/v1/media/images/jobs
• Auftrag abrufen: GET /api/open/v1/media/images/jobs/{jobId}

Jede Erstellungsanfrage benötigt einen eindeutigen Idempotency-Key-Header. Die API verwendet API-Kontingent statt Web-Mitgliedschafts-Credits und erstattet das Kontingent bei Provider-, Speicher- oder Persistenzfehlern idempotent.