Código del widget de vídeo: cómo llegan a tus visitantes las tareas de vídeo en segundo plano

Una respuesta de chat llega en segundos. Un vídeo generado puede tardar unos minutos. El widget de vídeo está diseñado en torno a esa diferencia, para que tus visitantes tengan una experiencia clara y tu cuenta esté protegida mientras se ejecuta la tarea.

La misma línea de código

Todos los tipos de widget usan el mismo código para insertar:

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

La diferencia está en el servidor. Cuando el tipo de widget es Vídeo, el prompt de un visitante inicia una tarea en lugar de devolver un resultado al instante.

Paso a paso

1. El visitante envía un prompt. La solicitud llega a api14 con el id de tu widget. El servidor comprueba que la página está en uno de tus sitios autorizados, aplica tus límites e inicia la tarea con el modelo que elegiste.
2. Se devuelve un id de tarea. El widget muestra un estado de trabajo. El id de tarea está vinculado a tu widget: otro widget, o alguien que intente adivinar ids, no puede leerlo.
3. El widget consulta el estado. Cada pocos segundos pregunta si el vídeo está listo. Estas consultas tienen un límite de frecuencia separado del de los prompts nuevos, así que una tarea larga no consume la cuota de solicitudes del visitante.
4. El vídeo se reproduce. Cuando la tarea termina, el widget descarga el clip, lo reproduce y muestra un enlace Descargar.

Si la generación falla, el visitante ve tu mensaje de error (o uno neutro predeterminado), y el motivo aparece en tu lista de widgets para que puedas solucionarlo.

Lo que controlas tú

• El modelo: se elige en Widgets. El widget solicita la duración admitida más cercana a 5 segundos y la resolución más cercana a 720p, así que el coste por clip se mantiene previsible.
• La clave API: cada widget funciona con una de tus claves API, seleccionada en el editor. La lista termina con Crear nueva clave API. Las tareas se registran bajo esa clave y se aplican sus límites.
• La apariencia: título, textos, color de acento, tema, radio de las esquinas y ubicación. El widget es de marca blanca.

Tus visitantes nunca ven el funcionamiento interno

El visitante solo ve tus textos, el estado de progreso y el vídeo terminado. Tus instrucciones, tu saldo, tu clave API y los errores sin procesar del proveedor se quedan en el servidor.

Supervisión

La lista de widgets muestra el último uso, el gasto de hoy y el último error de cada widget. Uso agrupa las solicitudes por widget o por sitio, y los correos de fallo te avisan de problemas que puedes solucionar, como un saldo vacío o un modelo retirado.

Descubre más sobre los modelos de vídeo en la documentación de vídeo y crea tu widget en la página de widgets.