Référence · Erreurs

Erreurs de l’API Photta chaque type et la marche à suivre

En une phrase

Chaque échec de l’API Photta renvoie la même structure : un statut, un `error.type`, un message et un `request_id`. Réessayez les 429 après le délai du header Retry-After et les 5xx avec un backoff ; corrigez les erreurs 400, 401 et 402 directement dans votre code.

Obtenir une clé APIConsulter la documentation
  • Erreurs: 7 types d'erreurs
  • Retry-After: Retry-After: 30s
  • Limites: 600 requêtes/min

Chaque chiffre sur cette page provient de la documentation de l'API Photta · vérifié

Types d’erreurs

La liste complète publiée par la documentation de l’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.

Structure d’une erreur

La même enveloppe sur chaque endpoint, quelle que soit l’erreur survenue.

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

Gestion des échecs

  • Respectez le Retry-After

    Une 429 comporte un en-tête Retry-After. Attendez ce nombre de secondes, puis réessayez avec un backoff exponentiel — réessayer immédiatement ne fait que repousser la fenêtre suivante.

  • Les échecs remboursent les crédits

    Une génération qui échoue après avoir été acceptée rembourse ses crédits automatiquement, de sorte qu'une nouvelle tentative ne facture pas deux fois.

  • Indiquez l’identifiant de requête

    Chaque réponse contient un `request_id`. Enregistrez-le dans vos logs. C'est le moyen le plus rapide pour le support de retrouver un échec spécifique parmi des milliers.

  • La 409 est un signal de file d’attente

    Un conflit signifie que la limite de lots simultanés de votre forfait est atteinte. Effectuez un polling sur le lot déjà en cours jusqu'à sa résolution, puis soumettez à nouveau — ne bouclez pas inutilement.

Questions sur les erreurs d’API

À quoi ressemble le corps d'une erreur ?

Un objet `error` avec un `type` et un `message`, aux côtés du `request_id`. Le type est stable et lisible par machine ; le message est destiné aux humains et peut changer.

Quelles erreurs valent la peine d'être réessayées ?

La 429 après avoir attendu les secondes de Retry-After, et les 5xx avec un backoff exponentiel. Une 400, 401 ou 402 échouera de la même manière tant que rien ne change de votre côté.

Que signifie une 402 ?

`insufficient_credits_error` — le compte ne dispose pas d'assez de crédits pour l'appel, ou pour la réservation complète d'un lot. Rien n'est généré et rien n'est débité.

Comment signaler un échec ?

Envoyez le `request_id`, l'endpoint et l'horodatage. Ce triplet identifie l'appel exact ; l'image elle-même n'est pas requise pour le retrouver.

Endpoints et références

Chaque chiffre sur cette page provient de la documentation de l'API Photta · vérifié

Testez l'API en cinq minutes

Générez une clé d'API Photta, collez le snippet cURL ci-dessus, et vous obtiendrez votre première photo portée sur modèle avant même que le café ait fini de couler.

Créer un compte et obtenir une clé APIAPI
  • 7 types d'erreurs
  • Retry-After: 30s
  • 600 requêtes/min