Taaklimiet voor de API#

Generatie-API's verwerken taken asynchroon. Wanneer een taak succesvol is aangemaakt, retourneert de API een taskId. Gebruik het resultaatendpoint om de taakstatus, voortgang, wachtrijpositie en definitieve uitvoer te controleren.

Dit document beschrijft de openbare taaklimieten voor API-integraties, waaronder verzoeken per minuut, onvoltooide taken en de creditafschrijving wanneer meerdere taken worden ingediend.

Overzicht van verzoeklimieten#

De generatie-API's gebruiken geen vaste openbare limiet voor verzoeken per minuut bij het aanmaken van taken. De praktische limiet hangt af van het aantal onvoltooide taken dat een account tegelijkertijd heeft.

Werkstroom	Verzoeken per minuut	Gelijktijdige / onvoltooide taken	Creditafschrijving
AI 3D	Geen vaste openbare limiet per minuut	1 actieve taak tegelijk. Extra ingediende taken wachten in de wachtrij.	Afschrijving per geaccepteerde taak
Andere generatie-API's	Geen vaste openbare limiet per minuut	Maximaal 30 onvoltooide taken per account en werkstroom	Afschrijving per geaccepteerde taak

Onvoltooide taken omvatten zowel wachtende als actieve taken.

De limiet van 30 taken is een limiet voor het aantal taken, geen creditpakket of gratis quotum. Elke geaccepteerde generatietaak wordt afgerekend volgens de creditregels van die API.

Taakstatus#

Status	Betekenis	Telt als onvoltooid
`Unprocessed`	De taak is geaccepteerd en wacht op uitvoering	Ja
`Processing`	De taak wordt momenteel uitgevoerd	Ja
`Success`	De taak is succesvol voltooid	Nee
`Failed`	De taak is mislukt	Nee

Het resultaatendpoint kan ook waitNumber retourneren, dat de wachtrijpositie van een wachtende taak aangeeft. Wanneer een taak actief of voltooid is, is waitNumber meestal 0.

AI-3D-taken#

AI-3D-taken worden één voor één verwerkt.

Je kunt meerdere AI-3D-taken indienen en elke geslaagde indiening retourneert een taskId. Er wordt echter maar één AI-3D-taak tegelijk uitgevoerd. Extra AI-3D-taken wachten totdat de huidige taak is voltooid.

Aanbevolen integratiegedrag:

Bewaar de geretourneerde taskId.
Vraag het resultaatendpoint elke 3-5 seconden op.
Behandel Unprocessed als wachtend.
Behandel Processing als actief in uitvoering.
Gebruik waitNumber en percentage om de voortgang aan je gebruikers te tonen.

Andere generatietaken#

Voor andere generatiewerkstromen dan AI 3D kan elk account maximaal 30 onvoltooide taken voor dezelfde werkstroom hebben.

Dit is een limiet op accountniveau. Meerdere API-sleutels onder hetzelfde account delen dezelfde limiet.

Dit betekent niet altijd dat alle 30 taken op exact hetzelfde moment actief zijn. Sommige taken kunnen wachten en andere kunnen worden uitgevoerd. De limiet telt beide mee.

Wanneer het account al 30 onvoltooide taken voor een werkstroom heeft, kunnen nieuwe indieningen voor die werkstroom tijdelijk worden geweigerd totdat bestaande taken zijn voltooid.

Code	Naam	Betekenis
`9015`	`TASK_NOT_COMPLETED`	Het account heeft de limiet voor onvoltooide taken in deze werkstroom bereikt. Probeer opnieuw nadat bestaande taken zijn voltooid.

Credits en onvoltooide taken#

Credits worden afgeschreven wanneer een generatietaak succesvol wordt aangemaakt. Als de taak uiteindelijk mislukt, worden de afgeschreven credits automatisch terugbetaald.

De limiet voor onvoltooide taken verandert de creditkosten per taak niet. Als je meerdere taken indient, wordt elke geaccepteerde taak afzonderlijk afgerekend.

Voorbeelden:

Voorbeeld	Actieve onvoltooide taken	Credits afgeschreven bij het aanmaken van taken
Dien 30 taken voor meubelvervanging in	30	30 x 1 tegoedeenheid = 30 tegoedeenheden
Dien 30 taken voor kamerdecoratie in met `modelType: "Base"`	30	30 x 3 tegoedeenheden = 90 tegoedeenheden
Dien 30 taken voor kamerdecoratie in met `modelType: "Pro"`	30	30 x 10 tegoedeenheden = 300 tegoedeenheden
Dien voor tuinontwerp 10 `Flash`-, 10 `Base`- en 10 `Pro`-taken in	30	10 x 1 + 10 x 3 + 10 x 10 = 140 tegoedeenheden

Zie de referentie voor creditafschrijving voor de volledige credittabel.

Het regelmatig opvragen van het resultaatendpoint maakt geen nieuwe generatietaak aan en telt niet als onvoltooide taak.

Tijdelijke antwoorden bij een bezette dienst#

In sommige gevallen kunnen nieuwe taakindieningen tijdelijk worden geweigerd omdat de dienst bezet is. Dit kan ook gebeuren als je account minder dan 30 onvoltooide taken heeft.

Code	Naam	Betekenis
`5020`	`QUEUE_TASK_OVERFLOW`	De dienst is momenteel bezet. Probeer het later opnieuw.

Dit is tijdelijk. Behandel het niet als een blijvende fout.

Aanbevolen clientgedrag#

Bewaar elke geretourneerde taskId.
Vraag de taakstatus regelmatig op.
Houd lokaal per account en werkstroom een lijst van onvoltooide taken bij.
Verwijder taken uit de lijst met onvoltooide taken wanneer de status Success of Failed wordt.
Houd bij werkstromen anders dan AI-3D het aantal onvoltooide taken op maximaal 30 voordat je meer taken indient.
Als je 9015 of 5020 ontvangt, probeer het dan na een wachttijd opnieuw.

Aanbevolen gedrag bij herpogingen:

Situatie	Aanbevolen actie
`9015 TASK_NOT_COMPLETED`	Wacht totdat bestaande taken van hetzelfde account en dezelfde werkstroom zijn voltooid en probeer het dan opnieuw.
`5020 QUEUE_TASK_OVERFLOW`	Wacht en probeer opnieuw met toenemende wachttijden.
De taak is `Unprocessed`	Blijf de status opvragen; de taak wacht.
De taak is `Processing`	Blijf de status opvragen; de taak wordt uitgevoerd.

Meer verwerkingscapaciteit nodig?#

Als de standaardlimiet van 30 onvoltooide taken per account en werkstroom niet aan je integratiebehoeften voldoet, neem dan contact op via [email protected]. We kunnen je toepassing bekijken en mogelijkheden bespreken voor meer capaciteit of een afzonderlijke regeling.