Errore "modello non disponibile"/"modello non trovato" di hiapi: cause e come risolverlo

Se POST https://api.hiapi.ai/v1/tasks rifiuta la richiesta perché il modello non è disponibile o la richiesta non è valida, l'attività non viene creata. Prima di riprovare, verifica il nome esatto del modello e i campi della richiesta rispetto alla documentazione corrente dei modelli.

Cause comuni

1. Il nome del modello è obsoleto o incompleto. I nomi dei modelli di HiAPI non hanno tutti la stessa forma. Alcuni sono nomi semplici, altri includono il percorso della modalità. La richiesta di generazione di immagini da testo di GPT Image 2 usa gpt-image-2/text-to-image.
2. Errori di battitura, differenze di maiuscole/minuscole o spazi nascosti hanno alterato il nome. Copia il nome del modello dalla documentazione corrente, non digitarlo a memoria, e rimuovi gli spazi dai valori caricati dalle variabili d'ambiente.
3. Il modello o la rotta è stato disattivato o rinominato. I nomi provenienti da articoli vecchi o da frammenti salvati potrebbero non essere più disponibili. Fai riferimento alla pagina corrente dei modelli e al changelog.
4. La richiesta mescola formati di rotta. Quando un modello offre più rotte, usa il campo di primo livello route indicato nella documentazione o la forma @route supportata, ma non inviare valori in conflitto tra loro.
5. L'autenticazione fallisce prima della rotta. 401 indica che la chiave API è mancante o non valida. 403 indica che la chiave non ha i permessi. Tratta questi casi separatamente dal campo del modello.

Passaggi per la correzione

1. Apri la documentazione corrente di GPT Image 2 o la pagina del modello pertinente e copia il nome esatto del modello.
2. Mantieni il suffisso della modalità che fa parte del nome nella documentazione. Per la generazione di immagini da testo di GPT Image 2, usa gpt-image-2/text-to-image.
3. Confronta ogni campo in input con la tabella dei parametri di quel modello. Anche se il nome del modello è valido, un campo di input non supportato può comunque restituire 400 INVALID_REQUEST.
4. Rimuovi gli spazi nel punto di chiamata. In Python, usa model = os.environ["MODEL"].strip(); in Node.js, usa model.trim().
5. Se il modello ha più rotte, passa il valore di primo livello route indicato nella documentazione e usa la struttura dei parametri corrispondente a quella rotta.
6. Registra il codice di stato HTTP completo e il corpo della risposta. Non dedurre un problema di chiave da un errore di validazione del modello, né un problema di modello da 401/403.

Verifica con una richiesta minima

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": "una piccola tazza in ceramica su un tavolo di legno, luce soffusa della finestra",
      "aspect_ratio": "1:1",
      "resolution": "1K"
    }
  }'

Restituire HTTP 200 con data.taskId significa che l'attività è stata accettata. Esegui il polling di GET /v1/tasks/:id finché data.status non è success o fail, oppure configura un callback per l'ambiente di produzione. Se restituisce 400, leggi il messaggio di validazione e ricontrolla la pagina del modello. Se restituisce 401 o 403, correggi la chiave o i suoi permessi.

Contenuti correlati

• Documentazione del modello GPT Image 2
• Riferimento API per la creazione di attività
• Guida all'autenticazione
• Panoramica dei modelli HiAPI

Domande frequenti

Dovrei rimuovere /text-to-image da ogni nome di modello? No. La denominazione dei modelli varia da serie a serie. Copia i valori fissi dalla documentazione corrente dei modelli. Per la generazione di immagini da testo di GPT Image 2, /text-to-image fa parte del nome del modello.

Un errore di modello significa che la mia chiave è sbagliata? Non necessariamente. La validazione della richiesta e l'autenticazione sono separate. 401 indica che la chiave è mancante o non valida; 403 indica che alla chiave mancano i permessi. 400 rimanda alla struttura della richiesta, al nome del modello, alla rotta o ai campi di input.

Posso normalizzare tutti i nomi dei modelli nel client? Evita di creare regole di normalizzazione personalizzate. Memorizza e invia i nomi esatti pubblicati nella documentazione corrente dei modelli.