Premiers pas
Widgets (à intégrer sur votre site)
Ajoutez un widget en marque blanche de chat, image, voix, musique ou vidéo sur votre site avec une balise script, limité à vos domaines et à vos dépenses.
Les widgets placent une interface d'IA en marque blanche sur votre propre site avec une seule balise script : chat, image, voix, musique ou vidéo, propulsés par n'importe quel modèle du catalogue. Les visiteurs n'ont pas besoin de clé d'API. Les requêtes sont facturées sur votre solde en USD au prix normal du modèle.
Créer un widget
- Ouvrez Widgets et choisissez Nouveau widget (ou concevez-en un d'abord, sans compte, sur la page des widgets).
- Choisissez un type et un modèle, puis définissez le titre, les couleurs, le thème, l'arrondi des coins, les textes et l'emplacement. Les widgets de chat acceptent aussi des instructions privées et un plafond de longueur de réponse.
- L'aperçu exécute réellement vos réglages non enregistrés : vous pouvez donc tester un modèle ou des instructions avant d'enregistrer. Les requêtes d'aperçu sont facturées sur votre solde.
- Enregistrez, puis copiez le code d'intégration.
Code d'intégration
<script src="https://api14.com/widget.js" data-widget="YOUR_WIDGET_ID" async></script>
Placez la balise dans <body> à l'endroit où le widget doit apparaître. Options :
| Attribut | Effet |
|---|---|
data-widget | Obligatoire. L'identifiant du widget dans le tableau de bord. |
data-target | Sélecteur CSS d'un élément dans lequel afficher le widget, par exemple #support. Sans lui, le widget s'affiche juste avant la balise script. |
data-height | Hauteur d'un widget en ligne, par exemple 520px. Valeurs par défaut : 480px pour le chat, 420px pour les autres types. |
Le widget s'affiche dans un Shadow DOM isolé : les styles de votre page n'y pénètrent pas et le widget ne modifie pas votre page. Avec l'emplacement Bouton flottant, il s'ouvre à la place depuis un bouton dans le coin inférieur de l'écran.
Sites autorisés
Un widget ne répond qu'aux requêtes des sites que vous listez dans Paramètres, Sites des widgets. Un domaine par ligne ; un domaine couvre aussi ses sous-domaines (example.com couvre www.example.com). Ajoutez un port pour n'autoriser que ce port, par exemple localhost:3000 pour les tests en local. L'aperçu du tableau de bord fonctionne toujours.
Une page sur un autre site reçoit 403 site_not_allowed et le widget ne s'affiche pas (la console du navigateur affiche une ligne qui explique pourquoi).
La vérification utilise l'en-tête Origin du navigateur. Les navigateurs ne peuvent pas le modifier, mais les outils hors navigateur le peuvent : considérez donc la liste de sites comme une restriction, pas comme un secret. Ce sont les contrôles de dépense ci-dessous qui plafonnent le coût.
Contrôles de dépense
Un widget étant public, son coût est plafonné par des limites que vous seul pouvez modifier :
| Contrôle | Où | Effet |
|---|---|---|
| Limite de dépense quotidienne pour ce widget | Éditeur du widget | Quand le widget a dépensé ce montant aujourd'hui (UTC), il s'arrête jusqu'au lendemain : 429 widget_daily_limit. |
| Limite de dépense quotidienne pour tous les widgets | Paramètres, Contrôles des widgets | Un plafond unique pour tous les widgets du compte. |
| Requêtes par visiteur et par jour | Paramètres, Contrôles des widgets | Comptées par IP de visiteur, pour chaque widget. 100 par défaut : 429 visitor_daily_limit. |
| Requêtes par visiteur et par minute | Fixe | 10 par minute et par visiteur : 429 rate_limited. |
| Débit du widget | Votre forfait | Tous les visiteurs d'un même widget se partagent les requêtes par minute de votre forfait. |
Votre solde est la limite ultime : à 0 $, chaque widget renvoie 402 insufficient_balance tant que vous n'ajoutez pas de fonds.
État et alertes
La liste des widgets indique quand chaque widget a été utilisé pour la dernière fois, la dépense et les requêtes du jour, et la dernière erreur quand un widget échoue pour une raison que vous pouvez corriger : solde vide, modèle retiré, limite de dépense atteinte ou site absent de la liste. Avec M'envoyer un e-mail quand un widget échoue activé (Paramètres, Contrôles des widgets), vous recevez au plus un e-mail par widget et par jour.
Utilisation affiche les requêtes des widgets avec le nom du widget et le site d'origine ; regroupez par Par widget ou Par site pour les comparer.
Ce que voient les visiteurs
- Les réponses du chat arrivent en streaming et prennent en charge une mise en forme de base (paragraphes, listes, gras, italique, code et liens). La conversation est conservée quand le visiteur passe d'une page à l'autre dans le même onglet.
- Un bouton Arrêter met fin à une longue réponse ; après une erreur, un lien Réessayer renvoie le message.
- Les images, l'audio et la vidéo s'accompagnent d'un lien Télécharger. La vidéo est générée comme tâche en arrière-plan et apparaît quand elle est prête, généralement en quelques minutes.
- Les visiteurs ne voient jamais vos instructions, votre solde ni l'erreur brute du modèle. Ils voient votre message d'erreur (ou un message neutre par défaut), et la cause vous est montrée dans le tableau de bord.
- Les textes que vous laissez vides utilisent des valeurs par défaut dans la langue de votre compte.