Naar inhoud

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, of 403 zonder de invoer of authenticatie te wijzigen.
  • Opnieuw proberen 500 met exponentiële uitstel en idempotentiesleuteling in uw app-laag.
  • Poll-statuseindpunt voordat taken voor het genereren van dubbele taken worden gestart.