Crear mi primera campaña
Menú de la documentación
API

Errores y límites

El formato de los errores, cada código de estado y el límite de peticiones por minuto.

Todo error tiene el mismo formato: un code estable para tu programa y un message en español para personas.

{
  "code": "bad_request",
  "message": "prompt no puede estar vacío.",
  "details": [{ "path": "prompt", "message": "prompt no puede estar vacío." }]
}

Códigos

HTTPcodeCausa y qué hacer
400
bad_request
El cuerpo no es JSON o algún campo no es válido. Mira details para saber qué campo corregir.
401
unauthorized
Falta la clave, es inválida o fue revocada. Revisa el encabezado Authorization o crea otra clave. Incluye WWW-Authenticate: Bearer.
402
insufficient_credits
El workspace no tiene créditos suficientes. Espera la renovación o consigue una recarga.
403
forbidden
La clave no tiene el permiso necesario o el workspace no está activo. Crea una clave con el permiso correcto.
403
email_unverified
El correo del Propietario no está verificado. Verifícalo desde la app antes de usar créditos.
404
not_found
El recurso no existe o es de otro workspace (no se distingue a propósito). Revisa el id.
409
conflict
Hay una petición con esa Idempotency-Key todavía en proceso, la exportación pide piezas aprobadas o el recurso aún no está listo.
410
expired
La exportación venció. Crea una nueva.
413
payload_too_large
El cuerpo supera el límite: 256 KB en POST /api/v1/banners y 64 KB en el resto de endpoints. Un archivo de la biblioteca no puede pasar de 5 MB.
422
idempotency_mismatch
Esa Idempotency-Key ya se usó con otra petición. Usa una clave nueva para cada petición distinta.
429
rate_limited
Superaste el límite por minuto. Espera los segundos que indica Retry-After.
429
concurrency_limit
Tu plan ya tiene el máximo de trabajos a la vez. Espera a que termine alguno; Retry-After indica cuánto.
500
internal_error
Falla nuestra. Reintenta con la misma Idempotency-Key; si sigue, escribe a soporte.

Límite de peticiones

Cada clave puede hacer 60 peticiones por minuto. Al pasarte recibes 429 con el encabezado Retry-After (en segundos): espera ese tiempo antes de reintentar. Los intentos repetidos con claves inválidas también se limitan. [PLACEHOLDER: confirmar el valor en producción]

Consejo. Reintenta solo los 429 y los 5xx, con espera creciente, y siempre con la misma Idempotency-Key.
IdempotenciaReintenta sin duplicar ni cobrar dos veces con el encabezado Idempotency-Key.
¿Te sirvió esta página?