Codice del widget video: come i job video in background arrivano ai tuoi visitatori

Una risposta in chat arriva in pochi secondi. Un video generato può richiedere qualche minuto. Il widget video è costruito attorno a questa differenza, così i tuoi visitatori hanno un'esperienza chiara e il tuo account resta protetto mentre il job è in corso.

La stessa riga di codice

Ogni tipo di widget usa lo stesso codice di incorporamento:

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

La differenza è sul server. Quando il tipo di widget è Video, il prompt di un visitatore avvia un job invece di restituire subito un risultato.

Passo dopo passo

1. Il visitatore invia un prompt. La richiesta arriva ad api14 con l'id del tuo widget. Il server verifica che la pagina sia su uno dei tuoi siti consentiti, applica i tuoi limiti e avvia il job con il modello che hai scelto.
2. Viene restituito un id del job. Il widget mostra uno stato di elaborazione. L'id del job è legato al tuo widget: un altro widget, o chi prova a indovinare gli id, non può leggerlo.
3. Il widget controlla lo stato. A intervalli di pochi secondi chiede se il video è pronto. Questi controlli hanno un limite di frequenza separato da quello dei nuovi prompt, quindi un job lungo non consuma la quota di richieste del visitatore.
4. Il video viene riprodotto. Quando il job è completato, il widget scarica la clip, la riproduce e mostra un link Scarica.

Se la generazione fallisce, il visitatore vede il tuo messaggio di errore (o un messaggio neutro predefinito), e il motivo compare nel tuo elenco dei widget così puoi risolverlo.

Cosa controlli tu

• Il modello: scelto in Widget. Il widget richiede la durata supportata più vicina a 5 secondi e la risoluzione più vicina a 720p, così il costo per clip resta prevedibile.
• La chiave API: ogni widget funziona con una delle tue chiavi API, selezionata nell'editor. L'elenco termina con Crea nuova chiave API. I job vengono registrati sotto quella chiave e si applicano i suoi limiti.
• L'aspetto: titolo, testi, colore di accento, tema, raggio degli angoli e posizione. Il widget è white label.

I visitatori non vedono mai i meccanismi interni

Il visitatore vede solo i tuoi testi, lo stato di avanzamento e il video finito. Le tue istruzioni, il tuo saldo, la tua chiave API e gli errori grezzi del fornitore restano tutti sul server.

Monitoraggio

L'elenco dei widget mostra l'ultimo utilizzo, la spesa di oggi e l'ultimo errore di ciascun widget. Utilizzo raggruppa le richieste per widget o per sito, e le email di errore ti avvisano dei problemi che puoi risolvere, come un saldo esaurito o un modello rimosso.

Scopri di più sui modelli video nella documentazione sui video e crea il tuo widget nella pagina dei widget.