hiapi „Modell nicht verfügbar“/„Modell nicht gefunden“-Fehler: Ursachen und Lösungen

Wenn POST https://api.hiapi.ai/v1/tasks die Anfrage ablehnt, weil das Modell nicht verfügbar oder die Anfrage ungültig ist, wird keine Aufgabe erstellt. Überprüfen Sie vor dem erneuten Versuch den genauen Modellnamen und die Anfragefelder anhand der aktuellen Modelldokumentation.

Häufige Ursachen

1. Der Modellname ist veraltet oder unvollständig. Nicht alle Modellnamen von HiAPI folgen derselben Form. Manche sind reine Namen, andere enthalten einen Modalitätspfad. Text-zu-Bild-Anfragen für GPT Image 2 verwenden gpt-image-2/text-to-image.
2. Tippfehler, Groß-/Kleinschreibungsunterschiede oder versteckte Leerzeichen verändern den Namen. Kopieren Sie den Modellnamen aus der aktuellen Dokumentation, statt ihn aus dem Gedächtnis einzugeben, und entfernen Sie Leerzeichen aus Werten, die aus Umgebungsvariablen geladen werden.
3. Das Modell oder die Route wurde deaktiviert oder umbenannt. Namen aus alten Artikeln oder gespeicherten Snippets sind möglicherweise nicht mehr verfügbar. Maßgeblich sind die aktuelle Modellseite und das Änderungsprotokoll.
4. Die Anfrage vermischt Routingformate. Wenn ein Modell mehrere Routen bietet, verwenden Sie das in der Dokumentation beschriebene Feld route auf oberster Ebene oder die unterstützte Form @route, senden Sie jedoch keine widersprüchlichen Werte.
5. Die Authentifizierung schlägt vor dem Routing fehl. 401 bedeutet, dass der API-Schlüssel fehlt oder ungültig ist. 403 bedeutet, dass der Schlüssel keine Berechtigung hat. Behandeln Sie diese Fälle getrennt vom Modellfeld.

Schritte zur Behebung

1. Öffnen Sie die aktuelle GPT Image 2-Dokumentation oder die relevante Modellseite und kopieren Sie den genauen Modellnamen.
2. Behalten Sie das Modalitätssuffix bei, das Teil des Dokumentationsnamens ist. Verwenden Sie für Text-zu-Bild mit GPT Image 2 gpt-image-2/text-to-image.
3. Vergleichen Sie jedes Feld in input mit der Parametertabelle des Modells. Selbst bei einem gültigen Modellnamen kann 400 INVALID_REQUEST zurückgegeben werden, wenn Eingabefelder nicht unterstützt werden.
4. Entfernen Sie Leerzeichen an der Aufrufstelle. Verwenden Sie in Python model = os.environ["MODEL"].strip(); in Node.js verwenden Sie model.trim().
5. Wenn das Modell mehrere Routen hat, übergeben Sie den in der Dokumentation beschriebenen Wert route auf oberster Ebene und verwenden Sie die zu dieser Route passende Parameterstruktur.
6. Protokollieren Sie den vollständigen HTTP-Statuscode und den Antworttext. Leiten Sie aus einem Modellvalidierungsfehler nicht auf ein Schlüsselproblem und aus 401/403 nicht auf ein Modellproblem ab.

Überprüfung mit einer minimalen Anfrage

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"
    }
  }'

Ein HTTP 200 mit data.taskId bedeutet, dass die Aufgabe akzeptiert wurde. Fragen Sie GET /v1/tasks/:id ab, bis data.status success oder fail ist, oder konfigurieren Sie einen Callback für die Produktion. Wenn 400 zurückgegeben wird, lesen Sie die Validierungsmeldung und prüfen Sie die Modellseite erneut. Wenn 401 oder 403 zurückgegeben wird, beheben Sie den Schlüssel oder seine Berechtigungen.

Verwandte Inhalte

• GPT Image 2-Modelldokumentation
• API-Referenz zum Erstellen von Aufgaben
• Authentifizierungsleitfaden
• HiAPI-Modellübersicht

Häufig gestellte Fragen

Sollte ich /text-to-image aus jedem Modellnamen entfernen? Nein. Die Modellbenennung variiert je nach Serie. Kopieren Sie die festen Werte aus der aktuellen Modelldokumentation. Für Text-zu-Bild mit GPT Image 2 ist /text-to-image Teil des Modellnamens.

Bedeutet ein Modellfehler, dass mein Schlüssel falsch ist? Nicht unbedingt. Anfragevalidierung und Authentifizierung sind getrennt. 401 bedeutet, dass der Schlüssel fehlt oder ungültig ist; 403 bedeutet, dass dem Schlüssel Berechtigungen fehlen. 400 deutet auf die Anfragestruktur, den Modellnamen, die Route oder Eingabefelder hin.

Kann ich alle Modellnamen im Client normalisieren? Vermeiden Sie eigene Normalisierungsregeln. Speichern und senden Sie die genauen Namen, die in der aktuellen Modelldokumentation veröffentlicht sind.