> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fanifyai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Erreurs

> Traitez les erreurs Problem Details et les codes stables de Fanify Hub.

Les routes Hub renvoient des objets [Problem Details](https://www.rfc-editor.org/rfc/rfc9457) avec le type `application/problem+json`.

```json theme={null}
{
  "type": "https://fanifyai.com/docs/hub/errors#insufficient_credits",
  "title": "Insufficient credits",
  "status": 402,
  "detail": "Your available balance does not cover this generation.",
  "instance": "/api/v1/hub/generations",
  "code": "insufficient_credits"
}
```

Utilisez `code` pour votre logique. `title` et `detail` servent à l'affichage.

| HTTP | Codes |
| - | - |
| 400 | `invalid_input` |
| 401 | `unauthorized` |
| 402 | `insufficient_credits` |
| 404 | `model_not_found`, `generation_not_found`, `resource_not_found` |
| 409 | `not_cancelable` |
| 410 | `file_expired` |
| 413 | `payload_too_large` |
| 422 | `no_route_available`, `idempotency_conflict` |
| 429 | `rate_limited` |
| 503 | `generation_in_progress`, `webhooks_not_configured` |
| 500 | `internal_error` |

Une réponse `429 rate_limited` contient `Retry-After` en secondes. Une réponse `503 generation_in_progress` contient toujours `Retry-After: 5`.

## Détails des codes

<h3 id="invalid_input">
  `invalid_input`
</h3>

La requête est invalide ou contient une valeur non prise en charge. Corrigez-la avant de réessayer.

<h3 id="unauthorized">
  `unauthorized`
</h3>

La clé d'API ou la session console est absente, invalide ou révoquée.

<h3 id="insufficient_credits">
  `insufficient_credits`
</h3>

Le solde disponible ne couvre pas l'estimation de la génération.

<h3 id="model_not_found">
  `model_not_found`
</h3>

Le modèle demandé n'existe pas ou n'est pas disponible dans le catalogue Hub.

<h3 id="generation_not_found">
  `generation_not_found`
</h3>

La génération demandée n'existe pas pour ce compte.

<h3 id="resource_not_found">
  `resource_not_found`
</h3>

La ressource demandée n'existe pas pour ce compte.

<h3 id="not_cancelable">
  `not_cancelable`
</h3>

Seule une génération encore `queued` peut être annulée.

<h3 id="file_expired">
  `file_expired`
</h3>

Le fichier, la sortie ou la complétion conservée a expiré ou n'est plus disponible.

<h3 id="payload_too_large">
  `payload_too_large`
</h3>

Le fichier envoyé dépasse la limite configurée.

<h3 id="no_route_available">
  `no_route_available`
</h3>

Aucune route configurée ne peut exécuter la combinaison de paramètres demandée.

<h3 id="idempotency_conflict">
  `idempotency_conflict`
</h3>

La clé d'idempotence a déjà été utilisée avec un autre corps de requête.

<h3 id="rate_limited">
  `rate_limited`
</h3>

La limite de requêtes ou de concurrence est atteinte. Attendez la durée indiquée par `Retry-After`.

<h3 id="generation_in_progress">
  `generation_in_progress`
</h3>

Une requête portant la même clé d'idempotence est toujours en cours.

<h3 id="webhooks_not_configured">
  `webhooks_not_configured`
</h3>

Le service de webhooks n'est pas disponible.

<h3 id="internal_error">
  `internal_error`
</h3>

Une erreur inattendue s'est produite. La réponse n'expose aucun détail interne.

## Erreurs enregistrées avec une génération

En V1, l'objet `error` d'une génération peut porter les codes stables `content_moderated`, `provider_error`, `queue_timeout` ou `interrupted`. Un fournisseur peut aussi transmettre un code propre à son API.

`missing_resource` est réservé à une version future et n'est jamais produit en V1. Une référence `sha256:` introuvable renvoie actuellement `400 invalid_input` lors de la soumission.

<Note>
  La plupart des erreurs de `/api/v1/hub/chat/completions` utilisent une enveloppe compatible OpenAI. L'échec d'authentification `401 unauthorized` survient avant le traitement du chat et reste au format Problem Details.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.