Pro API: grenser, feilkoder og god praksis

Grenser

Hver nøkkel har tre: samtidige renders (2 som standard), forespørsler per minutt (60 som standard) og, om du setter en, en daglig kredittgrense.

Overstig en grense, og svaret er 429 med en Retry-After-header i sekunder. Et avvist kall koster ingenting. Dagen som brukes for grensene er UTC-dagen.

Vårt eget kort deles med appens brukere. Når det er travelt, går renderene dine til leide GPUer, til samme pris og gjennom det samme APIet, med noen titalls sekunder ekstra ved oppstart.

Feilkoder

Kode	error	Hva det betyr, og hva du gjør
400	champ prompt requis	Legg til en prompt.
400	contenu_interdit	Innholdsfiltreret avviste prompten.
400	image_requise, inpaint_images_requises	Modusen krever image_b64, og mask_b64 for inpaint.
401	cle_requise, cle_invalide	Header mangler, eller ukjent nøkkel.
402	credits_insuffisants	Ikke nok saldo for denne renderen (cost er oppgitt). Fyll på på nettsiden.
403	cle_desactivee, cle_revoquee, cle_expiree	Nøkkel slått av, tilbakekalt eller utløpt: opprett en ny i appen.
403	licence_revoquee, licence_non_pro	Lisens tilbakekalt, eller en konto som ikke er Pro.
403	portee_manquante	Nøkkelen mangler tillatelsen det spørres om, angitt i portee.
403	lora_inconnu	En karakter som ikke tilhører kontoen.
404	media_indisponible	Filen er borte: send inn på nytt.
413	image_trop_lourde	Kildebilde eller maske overstiger 12 MB dekomprimert.
429	trop_de_rendus_simultanes, cadence_minute, plafond_jour	En grense er nådd, se Retry-After.
429	plafond_credits_jour	Nøkkelens daglige kredittgrense er nådd (plafond, depense, cout).
502	soumission_echouee, statut_echoue	En hendelse på render-siden: prøv igjen om noen sekunder.
503	licence_inverifiable	Kontoen kan ikke verifiseres akkurat nå: prøv igjen om et minutt.

Feilnavnene er de eksakte strengene APIet returnerer. Match på dem i stedet for på meldingen, som kan bli omformulert.

God praksis

• Poll hvert 3. sekund, ikke raskere. Køen er delt, og å hamre på den hjelper ingen.
• Last ned så snart statusen er completed. Filen arkiveres ikke.
• Skriv prompter på engelsk, og for videoer beskriv bevegelsen heller enn stillbildet.
• Én nøkkel per bruksområde, og en daglig kredittgrense på alle nøkler som lever på en server. En lekket nøkkel med en grense koster deg én dag, ikke hele saldoen.
• Behandle en 429 som normalt, ikke som en feil: vent på Retry-After og fortsett.

Prompter logges på vår side, slik de er for appen, av sikkerhetshensyn.