API de geração de vídeo

Integre a API de vídeo da BetterToken ao aplicativo do usuário.
Leia BETTERTOKEN_API_KEY apenas do ambiente; nunca a incorpore, registre em logs ou envie à análise.
Base: https://bettertoken.ai/v1
Modelo: wan-3.0.
Prompt: A rainy city street at night, slow forward camera move
Use exatamente o JSON de solicitação abaixo e respeite os campos e limites do modelo selecionado.
POST /videos/quote com a mesma solicitação retorna uma estimativa sem reservar saldo. Exige autenticação; não é o endpoint público de preços.
ANTES de POST /videos, persista fora do processo um novo Idempotency-Key e o corpo exato. Após reiniciar, carregue esse estado ou retome o ID salvo da tarefa aceita. Reutilize ambos se a resposta for incerta; um timeout não justifica criar outra tarefa paga.
Após a aceitação 202 em /videos (200 na rota de compatibilidade), salve id e consulte GET /videos/{id} a cada 5 segundos. Trate queued, in_progress, completed, failed e canceled. Um envio incerto permanece in_progress com stage=reconciliation; não crie outra tarefa. Em 429, respeite Retry-After. Faça até 360 consultas com pausas de 5 segundos; atrasos de rede e espera por limites podem prolongar o tempo total. Preserve o ID ao parar; parar a consulta não cancela nem recria a tarefa.
Após completed, solicite GET /videos/{id}/content com uma API key autorizada do proprietário. Um arquivo expirado retorna 410 video_artifact_expired. O conteúdo é privado; trate expiração e falhas de download separadamente das falhas de geração.
Confira a cobrança final no faturamento. Uma falha ou cancelamento confirmado libera ou devolve os fundos à origem pelo processamento financeiro; o status da tarefa não comprova que o reembolso terminou. Envio incerto e problemas após a geração exigem tratamento separado.
Os erros relay ficam em error: 402 video_insufficient_balance, 409 video_idempotency_conflict/video_acceptance_pending, 422 para parâmetros inválidos e 503 para aceitação incerta ou serviço indisponível. Preserve a chave e o corpo originais diante de uma resposta incerta. Não adicione assinatura web nem geração dentro da página.

{
  "model": "wan-3.0",
  "operation": "text_to_video",
  "prompt": "A rainy city street at night, slow forward camera move",
  "duration": {
    "mode": "fixed",
    "seconds": 5
  },
  "output": {
    "format": "mp4",
    "resolution": "480p",
    "aspect_ratio": "16:9"
  },
  "audio": {
    "mode": "on"
  }
}