Video-Widget-Code: so erreichen Videoaufträge Ihre Besucher

Eine Chatantwort wird in Sekunden gestreamt. Ein generiertes Video kann einige Minuten dauern. Das Video-Widget ist um diesen Unterschied herum gebaut: Ihre Besucher erleben einen klaren Ablauf, und Ihr Konto bleibt geschützt, während der Auftrag läuft.

Dieselbe Codezeile für jedes Widget

Jeder Widget-Typ nutzt denselben Einbettungscode:

<script src="https://api14.com/widget.js" data-widget="YOUR_WIDGET_ID" async></script>

Der Unterschied liegt auf dem Server. Ist der Widget-Typ Video, startet der Prompt eines Besuchers einen Auftrag, statt sofort ein Ergebnis zu liefern.

Schritt für Schritt

1. Der Besucher sendet einen Prompt. Die Anfrage geht mit Ihrer Widget-ID an api14. Der Server prüft, ob die Seite auf einer Ihrer zugelassenen Websites liegt, wendet Ihre Limits an und startet den Auftrag mit dem gewählten Modell.
2. Eine Auftrags-ID kommt zurück. Das Widget zeigt einen Arbeitsstatus. Die Auftrags-ID ist an Ihr Widget gebunden: Ein anderes Widget oder jemand, der IDs errät, kann sie nicht auslesen.
3. Das Widget prüft den Status. Alle paar Sekunden fragt es, ob das Video fertig ist. Diese Abfragen sind getrennt von neuen Prompts ratenbegrenzt, sodass ein langer Auftrag das Anfragekontingent des Besuchers nicht aufbraucht.
4. Das Video wird abgespielt. Ist der Auftrag abgeschlossen, lädt das Widget den Clip, spielt ihn ab und zeigt einen Link Herunterladen.

Schlägt die Generierung fehl, sieht der Besucher Ihre Fehlermeldung (oder einen neutralen Standardtext), und der Grund erscheint in Ihrer Widget-Liste, damit Sie ihn beheben können.

Was Sie steuern

• Das Modell: gewählt unter Widgets. Das Widget fordert die unterstützte Dauer an, die 5 Sekunden am nächsten liegt, und die Auflösung, die 720p am nächsten liegt, sodass die Kosten pro Clip planbar bleiben.
• Der API-Schlüssel: Jedes Widget läuft unter einem Ihrer API-Schlüssel, den Sie im Editor auswählen. Die Liste endet mit Neuen API-Schlüssel erstellen. Aufträge werden unter diesem Schlüssel erfasst, und seine Limits gelten.
• Die Darstellung: Titel, Texte, Akzentfarbe, Design, Eckenradius und Platzierung. Das Widget ist White Label.

Besucher sehen nie das Innenleben

Der Besucher sieht nur Ihre Texte, den Fortschrittsstatus und das fertige Video. Ihre Anweisungen, Ihr Guthaben, Ihr API-Schlüssel und die rohen Fehler des Anbieters bleiben auf dem Server.

Überwachung

Die Widget-Liste zeigt für jedes Widget die letzte Nutzung, die heutigen Ausgaben und den letzten Fehler. Nutzung gruppiert Anfragen nach Widget oder Website, und Fehler-E-Mails informieren Sie über Probleme, die Sie beheben können, etwa ein leeres Guthaben oder ein entferntes Modell.

Mehr über Videomodelle erfahren Sie in der Video-Dokumentation, Ihr Widget erstellen Sie auf der Widgets-Seite.