Kling 3.0 API

Integra la API de vídeo de BetterToken en la aplicación del usuario.
Lee BETTERTOKEN_API_KEY solo del entorno; nunca la incrustes, registres ni envíes a analítica.
Base: https://bettertoken.ai/v1
Modelo: kling-3.0.
Prompt: A rainy city street at night, slow forward camera move
Usa exactamente el JSON de solicitud de abajo y respeta los campos y límites del modelo elegido.
POST /videos/quote con la misma solicitud devuelve una estimación sin reservar saldo. Requiere autenticación; no es el endpoint público de precios.
ANTES de POST /videos, guarda fuera del proceso un Idempotency-Key nuevo y el cuerpo exacto. Tras reiniciar, carga ese estado o retoma el ID guardado de la tarea aceptada. Reutiliza ambos si la respuesta es incierta; un timeout no justifica crear otra tarea de pago.
Tras la aceptación 202 en /videos (200 en la ruta de compatibilidad), guarda id y consulta GET /videos/{id} cada 5 segundos. Gestiona queued, in_progress, completed, failed y canceled. Una entrega incierta sigue in_progress con stage=reconciliation; no crees otra tarea. Ante 429, respeta Retry-After. Consulta hasta 360 veces con pausas de 5 segundos; la red y la espera por límites pueden alargar el tiempo total. Conserva el ID al detenerte; detener la consulta no cancela ni recrea la tarea.
Tras completed, descarga GET /videos/{id}/content con una API key autorizada del propietario. Un archivo caducado devuelve 410 video_artifact_expired. El contenido es privado; trata la caducidad y los errores de descarga por separado de los fallos de generación.
Comprueba la facturación para conocer el cargo final. Un fallo o cancelación confirmados libera o devuelve los fondos al origen mediante el procesamiento financiero; el estado de la tarea no demuestra que el reembolso haya terminado. La entrega incierta y los problemas posteriores a la generación se gestionan por separado.
Los errores relay están en error: 402 video_insufficient_balance, 409 video_idempotency_conflict/video_acceptance_pending, 422 para parámetros inválidos y 503 para aceptación incierta o servicio no disponible. Conserva la clave y el cuerpo originales ante una respuesta incierta. No añadas una suscripción web ni generación dentro de la página.

{
  "model": "kling-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",
    "aspect_ratio": "16:9"
  },
  "provider_options": {
    "kling": {
      "mode": "std"
    }
  },
  "audio": {
    "mode": "off"
  }
}