Erreur « modèle indisponible » / « modèle introuvable » de hiapi : causes et solutions

Si POST https://api.hiapi.ai/v1/tasks rejette la requête parce que le modèle est indisponible ou que la requête est invalide, la tâche n'est pas créée. Avant de réessayer, vérifiez le nom exact du modèle et les champs de la requête par rapport à la documentation actuelle des modèles.

Causes courantes

1. Le nom du modèle est obsolète ou incomplet. Les noms de modèles de HiAPI ne suivent pas tous la même forme. Certains sont des noms bruts, d'autres incluent un chemin de modalité. Une requête de génération d'image à partir de texte avec GPT Image 2 utilise gpt-image-2/text-to-image.
2. Une faute de frappe, une différence de casse ou un espace masqué a modifié le nom. Copiez le nom du modèle depuis la documentation actuelle, ne le saisissez pas de mémoire, et supprimez les espaces des valeurs chargées depuis des variables d'environnement.
3. Le modèle ou la route a été désactivé ou renommé. Les noms issus d'anciens articles ou d'extraits enregistrés peuvent ne plus être disponibles. Fiez-vous à la page actuelle des modèles et au journal des modifications.
4. La requête mélange des formats de route. Lorsqu'un modèle propose plusieurs routes, utilisez le champ de premier niveau route indiqué dans la documentation ou la forme @route prise en charge, mais n'envoyez pas de valeurs contradictoires.
5. L'authentification échoue avant le routage. 401 signifie que la clé API est absente ou invalide. 403 signifie que la clé n'a pas les permissions. Traitez ces cas séparément du champ du modèle.

Étapes de correction

1. Ouvrez la documentation actuelle de GPT Image 2 ou la page du modèle concerné, et copiez le nom exact du modèle.
2. Conservez le suffixe de modalité qui fait partie du nom indiqué dans la documentation. Pour la génération d'image à partir de texte avec GPT Image 2, utilisez gpt-image-2/text-to-image.
3. Comparez chaque champ de input avec le tableau des paramètres de ce modèle. Même si le nom du modèle est valide, un champ d'entrée non pris en charge peut renvoyer 400 INVALID_REQUEST.
4. Supprimez les espaces à l'endroit de l'appel. En Python, utilisez model = os.environ["MODEL"].strip() ; en Node.js, utilisez model.trim().
5. Si le modèle a plusieurs routes, transmettez la valeur de premier niveau route indiquée dans la documentation et utilisez la structure de paramètres correspondant à cette route.
6. Enregistrez le code de statut HTTP complet et le corps de la réponse. Ne déduisez pas un problème de clé à partir d'une erreur de validation du modèle, ni un problème de modèle à partir d'un 401/403.

Vérifier avec une requête minimale

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2/text-to-image",
    "input": {
      "prompt": "a small ceramic mug on a wooden table, soft window light",
      "aspect_ratio": "1:1",
      "resolution": "1K"
    }
  }'

Un retour HTTP 200 contenant data.taskId signifie que la tâche a été acceptée. Interrogez GET /v1/tasks/:id jusqu'à ce que data.status soit success ou fail, ou configurez un callback pour l'environnement de production. Si un 400 est renvoyé, lisez le message de validation et vérifiez à nouveau la page du modèle. Si un 401 ou 403 est renvoyé, corrigez la clé ou ses permissions.

Contenu associé

• Documentation du modèle GPT Image 2
• Référence de l'API de création de tâches
• Guide d'authentification
• Aperçu des modèles HiAPI

Questions fréquentes

Dois-je supprimer /text-to-image de chaque nom de modèle ? Non. La nomenclature des modèles varie selon la série. Copiez les valeurs fixes depuis la documentation actuelle des modèles. Pour la génération d'image à partir de texte avec GPT Image 2, /text-to-image fait partie du nom du modèle.

Une erreur de modèle signifie-t-elle que ma clé est erronée ? Pas nécessairement. La validation de la requête et l'authentification sont distinctes. 401 signifie que la clé est absente ou invalide ; 403 signifie que la clé manque de permissions. 400 pointe vers la structure de la requête, le nom du modèle, la route ou les champs d'entrée.

Puis-je normaliser tous les noms de modèles côté client ? Évitez de définir vos propres règles de normalisation. Stockez et envoyez les noms exacts publiés dans la documentation actuelle des modèles.