Videos

Die Videogenerierung ist in der Dokumentenstruktur für Übersee enthalten, um eine konsistente Produktkarte zu gewährleisten. Die Verfügbarkeit öffentlicher Endpunkte muss jedoch anhand des OpenAPI-Schemas und der Kontokonfiguration im Ausland bestätigt werden.

Anfrage

Wenn Videoendpunkte aktiviert sind, ist ein asynchrones Aufgabenmodell zu erwarten. Eine Erstellungsanfrage umfasst normalerweise eine Eingabeaufforderung, ein Modell, eine Dauer, ein Seitenverhältnis und optional einen Rahmen oder ein Referenzmedium. Alle Anfragen verwenden die Inhaberauthentifizierung:

Authorization: Bearer KITTA_API_KEY

Verwenden Sie nur die von GET /api/openapi.json zurückgegebenen Endpunktpfade. Kopieren Sie keine Pfade aus anderen Bereitstellungen in ausländische Clients.

Antwort

Antworten auf Videoaufgaben geben normalerweise zuerst eine Aufgaben-ID und einen Status zurück, nach Abschluss dann eine Ergebnisvideo-URL. Speichern Sie die Aufgaben-ID und die ursprüngliche Projekt-ID zusammen, da die Videogenerierung eine Browsersitzung überdauern kann.

Abrechnung und Gutschriften

Videoaufgaben können teuer sein. Erzwingen Sie die Benutzerbestätigung für lange Dauer, hohe Auflösung oder Batch-Generierung. Überprüfen Sie Profil, bevor Sie Stapel erstellen, und pausieren Sie Ihre Warteschlange bei unzureichendem Guthaben.

Fehler

Behandeln Sie ungültige Eingabeaufforderungen, nicht unterstützte Modelle, nicht erreichbare Referenzmedien, unzureichende Credits und Verarbeitungsfehler. Wenn das Schema keine Videoendpunkte verfügbar macht, zeigen Sie die Funktion als nicht verfügbar an, anstatt versteckte Routen auszuprobieren.

Aktuelle öffentliche Endpunkte

Verifizierte Modelle liefert GET /api/open/v1/media/models?mediaType=video, Jobs werden mit POST /api/open/v1/media/videos/jobs erstellt und mit GET /api/open/v1/media/videos/jobs/{jobId} abgefragt. Für die Erstellung ist ein eindeutiger Idempotency-Key erforderlich; derselbe Schlüssel gibt bei Wiederholung die erste Antwort zurück, ohne einen zweiten Job oder eine zweite Abbuchung zu erzeugen. Verwendet wird das API-Kontingent statt Website-Credits; Fehler bei Erstellung, Speicherung, asynchroner Verarbeitung oder Zeitüberschreitung werden idempotent erstattet.