Code du widget vidéo : comment les tâches vidéo en arrière-plan parviennent à vos visiteurs

Une réponse de chat arrive en quelques secondes. Une vidéo générée peut prendre quelques minutes. Le widget vidéo est conçu autour de cette différence : vos visiteurs bénéficient d’une expérience claire et votre compte reste protégé pendant l’exécution de la tâche.

La même ligne de code

Tous les types de widget utilisent le même code d’intégration :

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

La différence se joue sur le serveur. Lorsque le type de widget est Vidéo, le prompt d’un visiteur lance une tâche au lieu de renvoyer immédiatement un résultat.

Étape par étape

1. Le visiteur envoie un prompt. La requête part vers api14 avec l’identifiant de votre widget. Le serveur vérifie que la page fait partie de vos sites autorisés, applique vos limites et lance la tâche avec le modèle choisi.
2. Un identifiant de tâche est renvoyé. Le widget affiche un état de traitement. L’identifiant de tâche est lié à votre widget : un autre widget, ou quelqu’un qui tenterait de deviner des identifiants, ne peut pas le lire.
3. Le widget vérifie l’état. Toutes les quelques secondes, il demande si la vidéo est prête. Ces vérifications ont leur propre limite de débit, distincte de celle des nouveaux prompts : une tâche longue n’épuise donc pas le quota de requêtes du visiteur.
4. La vidéo se lit. Une fois la tâche terminée, le widget télécharge le clip, le lit et affiche un lien Télécharger.

Si la génération échoue, le visiteur voit votre message d’erreur (ou un message neutre par défaut), et la cause apparaît dans votre liste de widgets pour que vous puissiez y remédier.

Ce que vous contrôlez

• Le modèle : choisi dans Widgets. Le widget demande la durée prise en charge la plus proche de 5 secondes et la résolution la plus proche de 720p, pour que le coût par clip reste prévisible.
• La clé API : chaque widget fonctionne avec l’une de vos clés API, sélectionnée dans l’éditeur. La liste se termine par Créer une nouvelle clé API. Les tâches sont enregistrées sous cette clé et ses limites s’appliquent.
• L’apparence : titre, textes, couleur d’accent, thème, arrondi des coins et emplacement. Le widget est en marque blanche.

Vos visiteurs ne voient jamais les rouages

Le visiteur ne voit que vos textes, l’état d’avancement et la vidéo terminée. Vos instructions, votre solde, votre clé API et les erreurs brutes du fournisseur restent sur le serveur.

Suivi

La liste des widgets affiche la dernière utilisation, les dépenses du jour et la dernière erreur de chaque widget. Consommation regroupe les requêtes par widget ou par site, et les e-mails d’échec vous signalent les problèmes que vous pouvez corriger, comme un solde vide ou un modèle retiré.

Pour en savoir plus sur les modèles vidéo, consultez la documentation vidéo et créez votre widget sur la page des widgets.