Pro API: gränser, felkoder och god praxis

Gränser

Varje nyckel har tre: renders samtidigt (2 som standard), anrop per minut (60 som standard) och, om du anger ett, ett dagligt kredittak.

När en gräns överskrids är svaret 429 med en Retry-After-header i sekunder. Ett nekat anrop kostar ingenting. Den dag som används för gränserna är UTC-dagen.

Vårt eget kort delas med appens användare. När det är upptaget skickas dina renders till hyrda GPU:er, till samma pris och via samma API, med några tiotal sekunder extra vid uppstart.

Felkoder

Kod	error	Vad det innebär och vad du gör
400	champ prompt requis	Lägg till en prompt.
400	contenu_interdit	Innehållsfiltret nekade prompten.
400	image_requise, inpaint_images_requises	Läget kräver image_b64, och mask_b64 för inpaint.
401	cle_requise, cle_invalide	Header saknas eller okänd nyckel.
402	credits_insuffisants	Inte tillräckligt saldo för den här rendern (cost anges). Fyll på via sajten.
403	cle_desactivee, cle_revoquee, cle_expiree	Nyckeln är avaktiverad, återkallad eller utgången: skapa en ny i appen.
403	licence_revoquee, licence_non_pro	Licensen återkallad, eller ett konto som inte är Pro.
403	portee_manquante	Nyckeln saknar den behörighet som efterfrågas, angiven i portee.
403	lora_inconnu	En karaktär som inte tillhör kontot.
404	media_indisponible	Filen är borta: skicka in igen.
413	image_trop_lourde	Källbilden eller masken överstiger 12 MB avkodad.
429	trop_de_rendus_simultanes, cadence_minute, plafond_jour	En gräns är nådd, se Retry-After.
429	plafond_credits_jour	Nyckelns dagliga kredittak är nått (plafond, depense, cout).
502	soumission_echouee, statut_echoue	Ett fel på rendersidan: försök igen om några sekunder.
503	licence_inverifiable	Kontot kan inte verifieras just nu: försök igen om en minut.

Felnamnen är de exakta strängar som API:et returnerar. Matcha på dem i stället för på meddelandet, som kan ändras i formuleringen.

God praxis

• Polla var 3:e sekund, inte oftare. Kön är delad, och att bombarda den hjälper ingen.
• Ladda ner så snart statusen är completed. Filen arkiveras inte.
• Skriv promptar på engelska, och för videor, beskriv rörelsen snarare än stillbilden.
• En nyckel per användningsområde, och ett dagligt kredittak på varje nyckel som lever på en server. En läckt nyckel med ett tak kostar dig en dag, inte hela saldot.
• Behandla ett 429-svar som normalt, inte som ett fel: vänta på Retry-After och fortsätt.

Promptar loggas på vår sida, precis som för appen, av säkerhetsskäl.