Gå til indhold

UlazAI udviklerdokumenter

Fejl og grænser

Fejlhåndtering og platformsgrænser

Brug struktureret håndtering af API-fejl og valider input på klientsiden for at reducere forsøger igen.

Almindelige HTTP-svar

Kode Betydning Typisk årsag
400 Ugyldig anmodning Manglende prompt, ikke-understøttet størrelse, ugyldige modelparametre
401 Uautoriseret Manglende eller ugyldig API nøgle/sessionstoken
402 Betaling påkrævet Utilstrækkelige købte kreditter eller API adgangsbegrænsning
403 Forbudt API register/login slutpunkter er bevidst deaktiveret
404 Ikke fundet Generations-id ejes ikke af den nuværende bruger eller endepunktsmismatch
500 Serverfejl Upstream-udbyderfejl eller netværkstimeout

Anmodningsgrænser for at håndhæve klientsiden

  • prompt: maksimalt 5000 tegn på unified endpoint.
  • image_urls: maksimalt 14 URL'er på unified endpoint.
  • size: modelspecifik, valider imod model matrix.
  • quality: modelspecifikke værdier for Seedream 5 Lite, Nano Banana 2, Ideogram og Qwen.
  • Brug af API kræver købte kreditter; velkomstkreditter er kun på webstedet.

Prøv strategi igen

Anbefalet produktionsadfærd:

  • Forsøg ikke igen 400, 401, 402, eller 403 uden at ændre input eller godkendelse.
  • Prøv igen 500 med eksponentiel backoff og idempotenstastning i dit applag.
  • Afstemningsstatusslutpunkt før lancering af duplikerede generationsjob.