Pro API: Limits, Fehlercodes und Best Practices

Limits

Jeder Key hat drei: gleichzeitige Renders (standardmäßig 2), Anfragen pro Minute (standardmäßig 60) und, falls du eines festlegst, ein tägliches Credit-Limit.

Wird ein Limit überschritten, lautet die Antwort 429 mit einem Retry-After-Header in Sekunden. Ein abgelehnter Aufruf kostet nichts. Der für die Limits verwendete Tag ist der UTC-Tag.

Unsere eigene Karte wird mit den Nutzern der App geteilt. Wenn sie ausgelastet ist, werden deine Renders an gemietete GPUs weitergeleitet, zum gleichen Preis und über dieselbe API, mit einigen Dutzend Sekunden mehr beim Start.

Fehlercodes

Code	error	Bedeutung und Lösung
400	champ prompt requis	Füge einen Prompt hinzu.
400	contenu_interdit	Der Inhaltsfilter hat den Prompt abgelehnt.
400	image_requise, inpaint_images_requises	Der Modus benötigt image_b64, und mask_b64 für inpaint.
401	cle_requise, cle_invalide	Header fehlt oder unbekannter Key.
402	credits_insuffisants	Nicht genug Guthaben für diesen Render (cost wird angegeben). Lade dein Konto auf der Website auf.
403	cle_desactivee, cle_revoquee, cle_expiree	Key deaktiviert, widerrufen oder abgelaufen: Erstelle einen neuen in der App.
403	licence_revoquee, licence_non_pro	Lizenz widerrufen oder kein Pro-Konto.
403	portee_manquante	Dem Key fehlt die angeforderte Berechtigung, angegeben in portee.
403	lora_inconnu	Ein Charakter, der nicht zu diesem Konto gehört.
404	media_indisponible	Die Datei ist nicht mehr vorhanden: Sende die Anfrage erneut.
413	image_trop_lourde	Quellbild oder Maske überschreitet 12 MB dekodiert.
429	trop_de_rendus_simultanes, cadence_minute, plafond_jour	Ein Limit wurde erreicht, siehe Retry-After.
429	plafond_credits_jour	Das tägliche Credit-Limit des Keys wurde erreicht (plafond, depense, cout).
502	soumission_echouee, statut_echoue	Ein Vorfall auf der Render-Seite: Versuche es in einigen Sekunden erneut.
503	licence_inverifiable	Das Konto kann gerade nicht überprüft werden: Versuche es in einer Minute erneut.

Die Fehlernamen sind die genauen Zeichenketten, die die API zurückgibt. Gleiche sie statt der Nachricht ab, da diese möglicherweise umformuliert wird.

Best Practices

• Alle 3 Sekunden pollen, nicht häufiger. Die Warteschlange ist gemeinsam genutzt, und zu viele Anfragen helfen niemandem.
• Lade die Datei sofort herunter, sobald der Status completed ist. Die Datei wird nicht archiviert.
• Schreibe Prompts auf Englisch, und beschreibe bei Videos die Bewegung statt des Standbilds.
• Ein Key pro Verwendungszweck und ein tägliches Credit-Limit für jeden Key, der auf einem Server läuft. Ein geleakter Key mit Limit kostet dich einen Tag, nicht dein gesamtes Guthaben.
• Behandle eine 429 als normal, nicht als Fehler: Warte auf Retry-After und mache weiter.

Prompts werden auf unserer Seite protokolliert, wie auch in der App, aus Sicherheitsgründen.