UlazAI Entwicklerdokumentation
Fehler und Grenzen
Fehlerbehandlung und Plattformgrenzen
Verwenden Sie eine strukturierte Behandlung für API-Fehler und validieren Sie Eingaben clientseitig, um diese zu reduzieren wiederholt.
Häufige HTTP-Antworten
| Code | Bedeutung | Typische Ursache |
|---|---|---|
400 |
Ungültige Anfrage | Fehlendes prompt, nicht unterstützte Größe, ungültige Modellparameter |
401 |
Nicht autorisiert | Fehlender oder ungültiger API-Schlüssel/Sitzungstoken |
402 |
Zahlung erforderlich | Nicht genügend erworbene Credits oder API-Zugriffsbeschränkung |
403 |
Verboten | API-Registrierungs-/Anmeldeendpunkte sind absichtlich deaktiviert |
404 |
Nicht gefunden | Die Generations-ID gehört nicht dem aktuellen Benutzer oder der Endpunkt stimmt nicht überein |
500 |
Serverfehler | Ausfall des Upstream-Providers oder Netzwerk-Timeout |
Fordern Sie Grenzwerte an, um sie clientseitig durchzusetzen
prompt: maximal 5000 Zeichen auf einem einheitlichen Endpunkt.image_urls: maximal 14 URLs auf einem einheitlichen Endpunkt.size: modellspezifisch, validieren gegen Modellmatrix.quality: modellspezifische Werte für Seedream 5 Lite, Nano Banana 2, Ideogram und Qwen.- Für die Nutzung von API sind erworbene Credits erforderlich; Willkommens-Credits gelten nur für die Website.
Wiederholungsstrategie
Empfohlenes Produktionsverhalten:
- Versuchen Sie es nicht erneut
400,401,402, oder403ohne Eingabe oder Authentifizierung zu ändern. - Versuchen Sie es noch einmal
500mit exponentiellem Backoff und Idempotenz-Keying in Ihrer App-Ebene. - Statusendpunkt abfragen, bevor Jobs zur Duplikatgenerierung gestartet werden.