Código do widget de vídeo: como as tarefas de vídeo em segundo plano chegam aos visitantes

Uma resposta de chat chega em segundos. Um vídeo gerado pode levar alguns minutos. O widget de vídeo foi construído em torno dessa diferença, para que seus visitantes tenham uma experiência clara e sua conta fique protegida enquanto a tarefa roda.

A mesma linha de código

Todos os tipos de widget usam o mesmo código de incorporação:

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

A diferença está no servidor. Quando o tipo do widget é Vídeo, o prompt de um visitante inicia uma tarefa em vez de devolver um resultado na hora.

Passo a passo

1. O visitante envia um prompt. A solicitação vai para a api14 com o id do seu widget. O servidor verifica se a página está em um dos seus sites permitidos, aplica seus limites e inicia a tarefa com o modelo que você escolheu.
2. O widget recebe um id de tarefa. O widget mostra que está trabalhando. O id da tarefa fica vinculado ao seu widget: outro widget, ou alguém tentando adivinhar ids, não consegue lê-lo.
3. O widget consulta o status. A cada poucos segundos, ele pergunta se o vídeo está pronto. Essas consultas têm um limite de taxa separado do limite de novos prompts, então uma tarefa longa não consome a cota de solicitações do visitante.
4. O vídeo é reproduzido. Quando a tarefa termina, o widget baixa o clipe, reproduz e mostra um link Baixar.

Se a geração falhar, o visitante vê a sua mensagem de erro (ou uma mensagem padrão neutra), e o motivo aparece na sua lista de widgets para que você possa corrigir.

O que você controla

• O modelo: escolhido em Widgets. O widget pede a duração suportada mais próxima de 5 segundos e a resolução mais próxima de 720p, então o custo por clipe fica previsível.
• A chave de API: todo widget funciona com uma das suas chaves de API, selecionada no editor. A lista termina com Criar nova chave de API. As tarefas são registradas nessa chave e os limites dela se aplicam.
• A aparência: título, textos, cor de destaque, tema, arredondamento dos cantos e posição. O widget é white label.

Seus visitantes nunca veem os bastidores

O visitante vê apenas os seus textos, o indicador de progresso e o vídeo pronto. Suas instruções, seu saldo, sua chave de API e os erros brutos do provedor ficam todos no servidor.

Monitoramento

A lista de widgets mostra o último uso, o gasto de hoje e o último erro de cada widget. Uso agrupa as solicitações por widget ou por site, e os e-mails de falha avisam sobre problemas que você pode corrigir, como saldo zerado ou um modelo removido.

Saiba mais sobre modelos de vídeo na documentação de vídeo e crie seu widget na página de widgets.