Vai al contenuto
UlazAI

Documenti per sviluppatori UlazAI

Errori e limiti

Prezzi Pannello di controllo Studio d'immagine

Gestione degli errori e limiti della piattaforma

Utilizza la gestione strutturata per gli errori API e convalida gli input lato client per ridurli riprova.

Risposte HTTP comuni

Codice Significato Causa tipica
400 Richiesta non valida prompt mancante, dimensioni non supportate, parametri del modello non validi
401 Non autorizzato Chiave/token di sessione API mancante o non valido
402 Pagamento richiesto Crediti acquistati insufficienti o limitazione di accesso API
403 Proibito Gli endpoint di registrazione/accesso API sono intenzionalmente disabilitati
404 Non trovato ID di generazione non di proprietà dell'utente corrente o mancata corrispondenza dell'endpoint
500 Errore del server Errore del provider upstream o timeout della rete

Richiedi limiti da applicare sul lato client

  • prompt: massimo 5000 caratteri sull'endpoint unificato.
  • image_urls: massimo 14 URL sull'endpoint unificato.
  • size: specifico del modello, convalida rispetto a matrice del modello.
  • quality: valori specifici del modello per Seedream 5 Lite, Nano Banana 2, Ideogram e Qwen.
  • L'utilizzo di API richiede crediti acquistati; i crediti di benvenuto sono solo sul sito web.

Riprovare la strategia

Comportamento di produzione consigliato:

  • Non riprovare 400, 401, 402, o 403 senza modificare l'input o l'autenticazione.
  • Riprova 500 con backoff esponenziale e immissione di idempotenza nel livello dell'app.
  • Esegui il polling dello stato dell'endpoint prima di avviare processi di generazione duplicati.