UlazAI ontwikkelaarsdocumentatie
Fouten en limieten
Foutafhandeling en platformlimieten
Gebruik gestructureerde afhandeling voor API-fouten en valideer invoer aan de clientzijde om het aantal fouten te verminderen nieuwe pogingen.
Algemene HTTP-reacties
| Codeer | Betekenis | Typische oorzaak |
|---|---|---|
400 |
Ongeldig verzoek | Ontbrekende prompt, niet-ondersteunde grootte, ongeldige modelparameters |
401 |
Ongeautoriseerd | Ontbrekende of ongeldige API-sleutel/sessietoken |
402 |
Betaling vereist | Onvoldoende gekochte credits of toegangsbeperking voor API |
403 |
Verboden | API register-/inlogeindpunten zijn opzettelijk uitgeschakeld |
404 |
Niet gevonden | Generatie-ID is geen eigendom van de huidige gebruiker of komt niet overeen met het eindpunt |
500 |
Serverfout | Fout bij upstreamprovider of netwerktime-out |
Vraag limieten aan om de clientzijde af te dwingen
prompt: maximaal 5000 tekens op uniform eindpunt.image_urls: maximaal 14 URL's op uniform eindpunt.size: modelspecifiek, valideren tegen modelmatrix.quality: modelspecifieke waarden voor Seedream 5 Lite, Nano Banana 2, Ideogram en Qwen.- Voor gebruik van API zijn aangeschafte credits vereist; welkomstcredits zijn alleen voor de website.
Strategie opnieuw proberen
Aanbevolen productiegedrag:
- Probeer het niet opnieuw
400,401,402, of403zonder de invoer of authenticatie te wijzigen. - Opnieuw proberen
500met exponentiële uitstel en idempotentiesleuteling in uw app-laag. - Poll-statuseindpunt voordat taken voor het genereren van dubbele taken worden gestart.