Pro API: grænser, fejlkoder og god praksis

Grænser

Hver nøgle har tre: samtidige renders (2 som standard), anmodninger per minut (60 som standard) og, hvis du har sat en, en daglig kreditgrænse.

Overskrides en grænse er svaret 429 med en Retry-After-header i sekunder. Et afvist kald koster ingenting. Den dag der bruges til grænserne er UTC-dagen.

Vores eget kort deles med appens brugere. Når det er travlt, sendes dine renders til lejede GPU'er, til samme pris og via den samme API, med nogle få ti sekunder ekstra ved opstart.

Fejlkoder

Kode	error	Hvad det betyder, og hvad du gør
400	champ prompt requis	Tilføj et prompt.
400	contenu_interdit	Indholdsfilteret afviste prompten.
400	image_requise, inpaint_images_requises	Tilstanden kræver image_b64, og mask_b64 til inpaint.
401	cle_requise, cle_invalide	Header mangler, eller ukendt nøgle.
402	credits_insuffisants	Ikke nok saldo til denne render (cost oplyses). Påfyld på sitet.
403	cle_desactivee, cle_revoquee, cle_expiree	Nøgle slået fra, tilbagekaldt eller udløbet: opret en ny i appen.
403	licence_revoquee, licence_non_pro	Licens tilbagekaldt, eller en konto der ikke er Pro.
403	portee_manquante	Nøglen mangler den efterspurgte tilladelse, angivet i portee.
403	lora_inconnu	En karakter der ikke tilhører kontoen.
404	media_indisponible	Filen er væk: send igen.
413	image_trop_lourde	Kildebillede eller maske overstiger 12 MB dekomprimeret.
429	trop_de_rendus_simultanes, cadence_minute, plafond_jour	En grænse er nået, se Retry-After.
429	plafond_credits_jour	Nøglens daglige kreditgrænse er nået (plafond, depense, cout).
502	soumission_echouee, statut_echoue	En hændelse på render-siden: prøv igen om et par sekunder.
503	licence_inverifiable	Kontoen kan ikke tjekkes lige nu: prøv igen om et minut.

Fejlnavnene er de præcise strenge API'en returnerer. Match på dem frem for på beskeden, da den kan blive omformuleret.

God praksis

• Poll hvert 3. sekund, ikke hurtigere. Køen er delt, og at bombardere den hjælper ingen.
• Download så snart statusen er completed. Filen arkiveres ikke.
• Skriv prompts på engelsk, og beskriv til videoer bevægelsen frem for stilbilledet.
• Én nøgle per formål, og en daglig kreditgrænse på enhver nøgle der lever på en server. En lækket nøgle med en grænse koster dig én dag, ikke hele saldoen.
• Behandl en 429 som normalt, ikke som en fejl: vent på Retry-After og fortsæt.

Prompts logges på vores side, ligesom det sker i appen, af sikkerhedshensyn.