Referenz · Rate Limits
Photta API Rate Limits und wie man rücksichtsvoll pollt
In aller Kürze
Die Photta API erlaubt 600 Requests pro Minute pro API-Key in einem festen Zeitfenster. Ein 429 liefert Retry-After: 30. Pollen Sie einen Job alle 3 Sekunden; gleichzeitige Aufgaben sind je nach Tarif gedeckelt.
- Limits: 600 Anfragen/Min.
- Retry-After: Retry-After: 30s
- Verarbeitung: asynchron, Polling
Jeder Zahlenwert auf dieser Seite stammt aus der Photta-API-Dokumentation · geprüft
Die veröffentlichten Limits
Rate, Zeitfenster, Retry, Bildgröße und Formate, wie in der Dokumentation angegeben.
Limits
- 600 Anfragen pro Minute pro API-Schlüssel (Festes Zeitfenster; das Limit ist in jedem Tarif identisch)
- Ein 429 enthält Retry-After: 30 Sekunden
- Bis zu 10 MB pro Bild
- Formate: JPEG, PNG, WebP
- Gleichzeitige Batches pro Tarif: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
- Nur Polling — die API sendet keine Webhooks.
Gleichzeitige Aufgaben nach Tarif
Wie viele Batches gleichzeitig aktiv sein können, bevor ein Submit 409 zurückgibt.
Aktive Batches pro Tarif
Free
Gleichzeitig: 1
Hobby
Gleichzeitig: 2
Seller
Gleichzeitig: 3
Brand
Gleichzeitig: 4
Studio
Gleichzeitig: 6
Innerhalb der Limits bleiben
Ein festes Zeitfenster
Das Limit wird pro API-Key in einem festen Zeitfenster gezählt und ist bei jedem Tarif gleich. Zwei Keys bedeuten zwei Budgets.
Alle 3 Sekunden pollen
Polling ist das einzige Signal für die Fertigstellung — die API sendet keine Webhooks. Alle 3 Sekunden ist das dokumentierte Intervall; schnellere Abfragen verschwenden Ihr Budget für leere Antworten.
Exponentieller Backoff
Warten Sie nach einem 429 die Sekunden aus Retry-After ab und vergrößern Sie den Abstand bei jedem weiteren Fehlschlag, anstatt in festen Intervallen erneut anzufragen.
Batches sind separat gedeckelt
Das Rate-Limit zählt Requests; das Concurrency-Limit zählt laufende Aufträge. Ein Batch, der das Limit überschreitet, liefert 409, nicht 429.
Fragen zu Rate Limits
Wie hoch ist das Rate-Limit?
600 Requests pro Minute pro API-Key in einem festen Zeitfenster. Die Dokumentation gibt für jeden Endpoint dieselbe Zahl an.
Wie oft sollte ich einen Job pollen?
Alle 3 Sekunden. Es gibt keine Webhooks; Polling ist der dokumentierte Weg, um den Abschluss eines Jobs zu erkennen.
Wie viel kann gleichzeitig gerendert werden?
Laufende Batches sind nach Plan gedeckelt: Free 1, Hobby 2, Seller 3, Brand 4 und Studio 6. Bei Überschreitung des Limits liefert ein Submit 409.
Was tun bei einem 429?
Lesen Sie den Retry-After-Header aus, warten Sie diese Anzahl an Sekunden und versuchen Sie es dann mit exponentiellem Backoff erneut. Stellen Sie die Anfragen in eine Queue, statt sie zu verwerfen.
Endpoints und Referenzen
Funktionen
Virtuelle Try-on-API für Apparel
REST-API zur Platzierung von Bekleidung auf KI-Mannequins. Asynchron, 1.5–4 Minuten Generierungsdauer, 5 credits bei 2K, 6 bei 4K. Beispiele für cURL, Node.js und Python.
LesenFunktionen
Jewelry-Try-on-API für Halsketten, Ringe, Armbänder und Ohrringe
Halsketten, Ringe, Armbänder und Ohrringe via REST auf KI-Modellen platzieren. 5 credits bei 2K, integrierte Nahaufnahme-Mannequins, reflexionsbewusstes Rendering aus der Photta-Dokumentation.
LesenFunktionen
Ghost-Mannequin-API für Hollow-Man-Produktfotos
KI-Ghost-Mannequin-Endpoint. Entfernt die Puppe aus einem Kleidungsfoto und bewahrt Innendetails. 3D oder Flat-Lay, Batch-Verarbeitung, 4 Credits bei 2K.
LesenReferenz
Erstes Photta-Bild in unter 5 Minuten.
Registrieren, API-Key generieren, ersten cURL-Aufruf ausführen, pollen bis zum Abschluss, Ergebnis persistieren. 5 Schritte, durchgängig dokumentiert.
LesenReferenz
Photta API-Authentifizierung
So authentifizieren Sie sich an der Photta API: der Authorization-Header, das Key-Präfix, wo Keys erstellt werden und wie man sie sicher rotiert.
LesenReferenz
Photta-API-Preise
Was jeder Photta API-Endpoint in Credits bei 2K und 4K kostet, wie Abrechnung und Erstattungen funktionieren und welche Endpoints kostenlos sind. Kein Geldpreis pro Bild.
LesenReferenz
Photta API-Fehler
Die vollständige Liste der Photta API-Fehlertypen samt Statuscodes, das Format des Error-Bodys und welche Fehler sich für einen Retry eignen.
LesenReferenz
Ressourcen-Endpoints der Photta-API
Listen Sie Mannequins, Posen, Hintergründe, Schuhe und Markenlabels auf, laden Sie eigene hoch und rufen Sie Ihr Guthaben an Credits ab. Die Lookups hinter jeder Generierung.
Lesen
Jeder Zahlenwert auf dieser Seite stammt aus der Photta-API-Dokumentation · geprüft
Testen Sie die API in fünf Minuten
Generieren Sie einen Photta-API-Schlüssel, fügen Sie das obige cURL-Snippet ein, und Sie erhalten Ihr erstes Bild am Model, noch bevor der Kaffee fertig gebrüht ist.
- 600 Anfragen/Min.
- Retry-After: 30s
- asynchron, Polling