Primeros pasos
Widgets (insértalos en tu sitio)
Añade a tu web un widget de marca blanca de chat, imagen, voz, música o vídeo con una sola etiqueta script, limitado a tus dominios y a tus topes de gasto.
Los widgets añaden una interfaz de IA de marca blanca a tu propio sitio web con una sola etiqueta script: chat, imagen, voz, música o vídeo, con cualquier modelo del catálogo. Los visitantes no necesitan una clave de API. Las peticiones se cobran de tu saldo en USD al precio normal del modelo.
Crear un widget
- Abre Widgets y elige New widget (o diseña uno primero, sin cuenta, en la página de widgets).
- Elige un tipo y un modelo, y luego establece el título, los colores, el tema, el radio de las esquinas, los textos y la posición. Los widgets de chat también admiten instrucciones privadas y un límite de longitud de respuesta.
- La vista previa ejecuta de verdad tus ajustes sin guardar, así que puedes probar un modelo o unas instrucciones antes de guardar. Las peticiones de la vista previa se cobran de tu saldo.
- Guarda y copia el código de inserción.
Código de inserción
<script src="https://api14.com/widget.js" data-widget="YOUR_WIDGET_ID" async></script>
Coloca la etiqueta dentro de <body>, donde quieras que aparezca el widget. Opciones:
| Atributo | Efecto |
|---|---|
data-widget | Obligatorio. El id del widget que aparece en el panel. |
data-target | Selector CSS de un elemento donde renderizar, por ejemplo #support. Sin él, el widget se renderiza justo antes de la etiqueta script. |
data-height | Altura de un widget en línea, por ejemplo 520px. Por defecto: 480px para chat, 420px para los demás tipos. |
El widget se renderiza en un Shadow DOM aislado, así que los estilos de tu página no se filtran y el widget no modifica tu página. Con la posición Floating button, se abre desde un botón en la esquina inferior.
Sitios permitidos
Un widget solo responde a las peticiones de los sitios que listes en Ajustes, Sitios de widgets. Un dominio por línea; un dominio también cubre sus subdominios (example.com cubre www.example.com). Añade un puerto para permitir solo ese puerto, por ejemplo localhost:3000 para pruebas locales. La vista previa del panel siempre funciona.
Una página de cualquier otro sitio recibe 403 site_not_allowed y el widget no se renderiza (la consola del navegador muestra una línea que explica el motivo).
La comprobación usa la cabecera Origin del navegador. Los navegadores no pueden modificarla, pero las herramientas fuera de un navegador sí, así que trata la lista de sitios como una restricción, no como un secreto. Los controles de gasto de abajo son los que limitan el coste.
Controles de gasto
Como un widget es público, su coste está limitado por topes que solo tú puedes cambiar:
| Control | Dónde | Efecto |
|---|---|---|
| Límite diario de gasto de este widget | Editor del widget | Cuando el widget ha gastado esa cantidad hoy (UTC), se detiene hasta el día siguiente: 429 widget_daily_limit. |
| Límite diario de gasto de todos los widgets | Ajustes, Controles de widgets | Un único tope para todos los widgets de la cuenta. |
| Peticiones por visitante al día | Ajustes, Controles de widgets | Se cuentan por IP de visitante, para cada widget. Por defecto 100: 429 visitor_daily_limit. |
| Peticiones por visitante por minuto | Fijo | 10 por minuto por visitante: 429 rate_limited. |
| Tasa del widget | Tu plan | Todos los visitantes de un widget comparten las peticiones por minuto de tu plan. |
Tu saldo es el límite final: con $0, todos los widgets devuelven 402 insufficient_balance hasta que añadas fondos.
Estado y alertas
La lista de widgets muestra cuándo se usó cada widget por última vez, el gasto y las peticiones de hoy, y el último error cuando un widget falla por un motivo que puedes corregir: saldo vacío, un modelo retirado, un límite de gasto alcanzado o un sitio que falta en la lista. Con Email me when a widget fails activado (Ajustes, Controles de widgets) recibes como máximo un correo por widget al día.
Uso muestra las peticiones de los widgets con el nombre del widget y el sitio de origen; agrupa por By widget o By site para compararlos.
Qué ven los visitantes
- Las respuestas del chat llegan en streaming y admiten formato básico (párrafos, listas, negrita, cursiva, código y enlaces). La conversación se mantiene mientras el visitante navega entre páginas en la misma pestaña.
- Un botón Stop termina una respuesta larga; tras un error, un enlace Try again reenvía el mensaje.
- Las imágenes, el audio y el vídeo incluyen un enlace Download. El vídeo se genera como un trabajo en segundo plano y aparece cuando está listo, normalmente en unos minutos.
- Los visitantes nunca ven tus instrucciones, tu saldo ni el error sin procesar del modelo. Ven tu mensaje de error (o uno neutro por defecto) y la causa se te muestra a ti en el panel.
- Los textos que dejes vacíos usan valores por defecto en el idioma de tu cuenta.