Autenticación

API Keys

Envía la API key del workspace como bearer token.

Authorization: Bearer vt_live_...

Las keys pertenecen a una organización.

La organización debe tener un plan de pago activo.

Headers

Authorization: Bearer vt_live_...
Content-Type: application/json
Idempotency-Key: optional-retry-key

Usa Idempotency-Key para reintentos de generaciones pagadas.

También puedes enviar idempotency_key en el body cuando el endpoint lo soporta.

Créditos

Los créditos se calculan con las mismas reglas de servidor que usa la app.

Los endpoints pagados descuentan créditos antes de poner el trabajo en cola.

Si el workspace no tiene créditos suficientes, la API devuelve 402 insufficient_credits y no crea ningún trabajo.

Si la cola falla después del descuento, los créditos se devuelven antes de responder con error.

Créditos Insuficientes

{
  "error": {
    "code": "insufficient_credits",
    "message": "Insufficient credits for this request.",
    "retryable": false,
    "context": {
      "credits_required": 1200,
      "credits_available": 500
    }
  }
}

Scopes

Usa scopes de lectura para catálogo, assets, estado y lecturas del editor.

Usa scopes de escritura para generación, uploads, creación de referencias y cambios del editor.