Referencia · Errores

Errores de Photta API cada tipo y qué hacer

En una frase

Cada fallo de Photta API devuelve la misma estructura: un status, un `error.type`, un mensaje y un `request_id`. Reintenta 429 tras la cabecera Retry-After y 5xx con backoff; corrige 400, 401 y 402 en tu propio código.

Obtener una API keyLeer la documentación
  • Errores: 7 tipos de error
  • Retry-After: Retry-After: 30s
  • Límites: 600 requests/min

Cada cifra de esta página proviene de la documentación de la API de Photta · verificado

Tipos de error

La lista completa que publica la documentación de la API.

400invalid_request_error
The request is malformed or contains invalid parameters.
401authentication_error
The API key is missing, invalid, or expired.
402insufficient_credits_error
Your account does not have enough credits.
404not_found_error
The requested resource does not exist.
409conflict_error
The request conflicts with current state — e.g. your concurrent-batch cap is reached.
429rate_limit_error
Too many requests. Slow down and retry.Retry-After: 30
500api_error
An internal server error occurred. Retry later.

La estructura de un error

La misma envoltura en cada endpoint, independientemente de lo que haya fallado.

{
  "error": {
    "type": "rate_limit_error",
    "message": "Rate limit exceeded."
  },
  "request_id": "req_xxxxxxxx"
}

Gestión de errores

  • Respeta el Retry-After

    Un 429 incluye una cabecera Retry-After. Espera esa cantidad de segundos y luego reintenta con backoff exponencial; reintentar de inmediato solo aleja aún más la siguiente ventana.

  • Los fallos reembolsan credits

    Una generación que falla tras haber sido aceptada reembolsa sus credits automáticamente, por lo que un reintento no cobra el doble.

  • Indica el request id

    Cada respuesta incluye un `request_id`. Regístralo. Es la forma más rápida de que soporte localice un fallo específico entre miles.

  • 409 es una señal de cola

    Un conflicto significa que se alcanzó el límite de lotes concurrentes de tu plan. Haz polling del lote que ya está en curso hasta que finalice y vuelve a enviar; no ejecutes bucles activos.

Preguntas sobre errores de la API

¿Qué aspecto tiene el cuerpo de un error?

Un objeto `error` con un `type` y un `message`, junto con el `request_id`. El tipo es estable y legible por máquinas; el mensaje es para humanos y puede cambiar.

¿Qué errores merece la pena reintentar?

429 tras esperar los segundos de Retry-After, y 5xx con backoff exponencial. Un 400, 401 o 402 fallará igual hasta que cambie algo de tu lado.

¿Qué significa un 402?

`insufficient_credits_error` — la cuenta no tiene suficientes credits para la llamada o para la reserva completa de un lote. No se genera nada y no se cobra nada.

¿Cómo notifico un fallo?

Envía el `request_id`, el endpoint y la hora. Esa terna identifica la llamada exacta; no es necesaria la imagen en sí para buscarla.

Endpoints y referencias

Cada cifra de esta página proviene de la documentación de la API de Photta · verificado

Prueba la API en cinco minutos

Genera una API key de Photta, pega el snippet de cURL de arriba y tendrás tu primera imagen con modelo antes de que termine de prepararse el café.

Crear una cuenta y obtener una API keyAPI
  • 7 tipos de error
  • Retry-After: 30s
  • 600 requests/min