Erreurs du proxy

Les erreurs générées par le proxy ont la forme suivante :

{
  "error": {
    "message": "No routing configuration for project 'your-team/ticket-classifier'",
    "type": "proxy_error"
  }
}

Chaque réponse contient l’en-tête x-proxy-request-id. Communiquez-le lorsque vous signalez un problème.

Échecs courants

Statut	Cause typique	Action
`400`	Métadonnées non valides ou JSON mal formé	Corrigez le corps de requête
`400`	`OpenAI-Project must be entity/project` : l’en-tête n’est pas au format `[ENTITY]/[PROJECT]`. Pour un ID de projet OpenAI tel que `proj_abc123`, souvent resté dans `OPENAI_PROJECT_ID`, l’erreur suggère de supprimer ou de modifier la variable	Définissez l’option `project` du SDK ou `OPENAI_PROJECT_ID` sur `[ENTITY]/[PROJECT]`
`400`	Un alias de projet ou `alias@vN` dans `model`, utilisé conjointement avec `OpenAI-Project`	Envoyez `model: "router"` et sélectionnez la version avec `metadata["forge.project_version"]`
`400`	`forge.project_version` envoyé sans `OpenAI-Project`, ou valeur qui n’est pas un entier positif	Envoyez l’en-tête, ainsi qu’une version telle que `"2"`
`400`	Valeur `Forge-Cache-Mode` non valide, ou demande de cache pour un appel en diffusion en continu	Corrigez ou supprimez l’en-tête de cache
`401`	Clé API Forge manquante ou non valide	Utilisez une clé API valide
`403`	La clé n’a pas accès à l’entity indiquée dans `OpenAI-Project`. Le proxy vérifie l’accès avant toute recherche de projet	Changez d’entity ou accordez l’accès à l’équipe
`404`	`No routing configuration for project '[ENTITY]/[PROJECT]'` : nom du projet incorrect (souvent l’alias du projet, lorsqu’il diffère du nom du projet Weights & Biases), ou acheminement pas encore publié	Copiez la valeur `OpenAI-Project` depuis Studio et attendez que l’acheminement soit appliqué
`404`	`Project '[ENTITY]/[PROJECT]' has no version N` : `forge.project_version` désigne une version inexistante	Créez la version ou corrigez la valeur
`404`	`model: "router"` envoyé sans `OpenAI-Project`. Le message invite à envoyer l’en-tête	Définissez l’option `project` du SDK ou `OPENAI_PROJECT_ID`
`404`	Fournisseur inconnu dans un remplacement de modèle, ou chemin non pris en charge	Vérifiez le nom du fournisseur et son déploiement
`502`	Le fournisseur est injoignable ou son flux de réponse a échoué	Vérifiez la disponibilité du fournisseur et les identifiants d’authentification
Statut du fournisseur	Le fournisseur sélectionné a renvoyé une erreur	Consultez la réponse du fournisseur. Le proxy conserve le statut et le corps renvoyés en amont

L’erreur la plus courante concernant les projets

OpenAI-Project attend le nom du projet Weights & Biases, et non son alias. Les deux diffèrent lorsque le projet a été créé avec un nom différent de son alias. Dans ce cas, indiquer l’alias dans OpenAI-Project renvoie une erreur 404 accompagnée du message No routing configuration for project. Copiez la valeur depuis l’en-tête du projet dans Studio :

OpenAI-Project: your-team/ticket-classifier

Une erreur d’ID du modèle n’est pas une erreur `404` du proxy

Le proxy valide le nom du fournisseur, mais pas chaque ID du modèle en amont. Si le fournisseur existe mais pas le modèle, le fournisseur sélectionné renvoie sa propre erreur. Cette distinction permet de différencier les problèmes de configuration d’acheminement des écarts liés à l’évolution du catalogue du fournisseur.

Échecs de traçage

Les écritures de traces sont asynchrones : elles ne transforment pas une réponse réussie du fournisseur en échec côté client. Les opérateurs surveillent les événements structurés d’échec d’écriture, qui portent le même ID de requête du proxy. Dans la mesure du possible, les problèmes déterministes liés aux entrées de trace sont rejetés avant l’envoi au fournisseur.

API : Diagnostiquer un échec

Fournissez à l’agent l’URL de la requête, la valeur de l’en-tête OpenAI-Project, le corps de requête masqué, le statut HTTP, le corps de réponse complet et x-proxy-request-id. Ne communiquez ni la clé bearer ni l’identifiant d’authentification du fournisseur.Un agent doit vérifier les points suivants, dans l’ordre :

La valeur de OpenAI-Project, et si le projet indiqué correspond au nom du projet Weights & Biases et non à l’alias du projet.
Si model vaut router ou un remplacement de modèle, et quelle version forge.project_version sélectionne.
Si le fournisseur et le déploiement d’acheminement ont bien été appliqués.
Si le corps de réponse provient du proxy ou du fournisseur en amont.

Pour les schémas de réponse d’erreur, consultez la référence de l’API Chat Completions.

Model Distillation

Serverless Training

Échecs courants

L’erreur la plus courante concernant les projets

Une erreur d’ID du modèle n’est pas une erreur `404` du proxy

Échecs de traçage

​Échecs courants

​L’erreur la plus courante concernant les projets

​Une erreur d’ID du modèle n’est pas une erreur 404 du proxy

​Échecs de traçage

Échecs courants

L’erreur la plus courante concernant les projets

Une erreur d’ID du modèle n’est pas une erreur `404` du proxy

Échecs de traçage