Videowidgetcode: hoe videotaken je bezoekers bereiken

Een chatantwoord is in een paar seconden binnen. Een gegenereerde video kan een paar minuten duren. De videowidget is rond dat verschil gebouwd, zodat je bezoekers een duidelijke ervaring krijgen en je account beschermd blijft terwijl de taak loopt.

Dezelfde ene regel code

Elk widgettype gebruikt dezelfde insluitcode:

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

Het verschil zit op de server. Als het widgettype Video is, start de prompt van een bezoeker een taak in plaats van meteen een resultaat terug te geven.

Stap voor stap

1. De bezoeker verstuurt een prompt. Het verzoek gaat met het id van je widget naar api14. De server controleert of de pagina op een van je toegestane sites staat, past je limieten toe en start de taak met het model dat je hebt gekozen.
2. Er komt een taak-id terug. De widget toont dat hij bezig is. Het taak-id is gekoppeld aan je widget: een andere widget, of iemand die id's probeert te raden, kan het niet uitlezen.
3. De widget controleert de status. Om de paar seconden vraagt hij of de video klaar is. Voor deze controles geldt een aparte snelheidslimiet, los van nieuwe prompts, zodat een lange taak het verzoekquotum van de bezoeker niet opmaakt.
4. De video speelt af. Als de taak klaar is, downloadt de widget de clip, speelt hem af en toont een link Downloaden.

Mislukt het genereren, dan ziet de bezoeker jouw foutmelding (of een neutrale standaardmelding), en de oorzaak verschijnt in je widgetlijst zodat je het kunt oplossen.

Wat jij bepaalt

• Het model: gekozen in Widgets. De widget vraagt om de ondersteunde duur die het dichtst bij 5 seconden ligt en de resolutie die het dichtst bij 720p ligt, zodat de prijs per clip voorspelbaar blijft.
• De API-key: elke widget draait op een van je API-keys, geselecteerd in de editor. De lijst eindigt met Nieuwe API-key maken. Taken worden onder die key geregistreerd en de limieten ervan gelden.
• De weergave: titel, teksten, accentkleur, thema, hoekafronding en plaatsing. De widget is white label.

Je bezoekers zien nooit wat er achter de schermen gebeurt

De bezoeker ziet alleen je teksten, de voortgang en de afgeronde video. Je instructies, je saldo, je API-key en de ruwe fouten van de aanbieder blijven allemaal op de server.

Monitoring

De widgetlijst toont voor elke widget het laatste gebruik, de uitgaven van vandaag en de laatste fout. Gebruik groepeert verzoeken per widget of per site, en foutmails waarschuwen je voor problemen die je kunt oplossen, zoals een leeg saldo of een verwijderd model.

Lees meer over videomodellen in de videodocumentatie en bouw je widget op de widgetpagina.