Photta API
Photta API Virtuelles Try-on, Ghost Mannequin und Produktfotografie per REST
In aller Kürze
Die Photta-API ist eine credit-basierte REST-API: Senden Sie ein Produktfoto per POST an einen Capability-Endpoint, pollen Sie dessen Status-Endpoint alle paar Sekunden und laden Sie das fertige Bild herunter. Acht Capabilities, ein Schlüssel, ein credit-Guthaben.
- Funktionen: 8 Funktionen
- Rate Limit: 600 Anfragen/Min.
- Authentifizierung: Bearer-Key
- Muster: asynchron, Polling
Jeder Zahlenwert auf dieser Seite stammt aus der Photta-API-Dokumentation · geprüft
RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/tryon/apparel \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"product_type": "top",
"product_images": [
"https://cdn.yourstore.com/products/shirt-front.jpg"
],
"product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
"product_category": "t_shirt",
"mannequin_id": "mnk_f3a9b1",
"pose_id": "pose_c2d4e5",
"background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
"lock_background": true,
"resolution": "2K",
"aspect_ratio": "3:4",
"body_size": "M",
"expression": "neutral",
"user_instruction": "Keep the collar pattern crisp and centered."
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')const res = await fetch("https://api.photta.app/api/v1/tryon/apparel", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
"product_type": "top",
"product_images": [
"https://cdn.yourstore.com/products/shirt-front.jpg"
],
"product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
"product_category": "t_shirt",
"mannequin_id": "mnk_f3a9b1",
"pose_id": "pose_c2d4e5",
"background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
"lock_background": true,
"resolution": "2K",
"aspect_ratio": "3:4",
"body_size": "M",
"expression": "neutral",
"user_instruction": "Keep the collar pattern crisp and centered."
}),
});
const { data } = await res.json(); // data.id, data.statusimport os, requests
res = requests.post(
"https://api.photta.app/api/v1/tryon/apparel",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
json={
"product_type": "top",
"product_images": [
"https://cdn.yourstore.com/products/shirt-front.jpg"
],
"product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
"product_category": "t_shirt",
"mannequin_id": "mnk_f3a9b1",
"pose_id": "pose_c2d4e5",
"background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
"lock_background": True,
"resolution": "2K",
"aspect_ratio": "3:4",
"body_size": "M",
"expression": "neutral",
"user_instruction": "Keep the collar pattern crisp and centered."
},
)
data = res.json()["data"] # data["id"], data["status"]Funktionen
Jeder Endpoint, nach Capability
Methode, Pfad, credits und typische Dauer, direkt aus der API-Dokumentation. Die Angaben auf dieser Seite werden mit der Dokumentation an dem unten angegebenen Datum abgeglichen.
- POST/api/v1/tryon/apparel
Virtuelles Try-on (Bekleidung)
Platzieren Sie ein Flat-Lay-Kleidungsstück auf einer KI-Schneiderpuppe mit dem gewünschten Gesichtsausdruck und der passenden Körpergröße. Vier Produkttypen, fünf Seitenverhältnisse.
5 Credits bei 2K · 6 Credits bei 4K1.5–4 min
Zum Endpoint - POST/api/v1/tryon/jewelry
Schmuck-Try-on
Nahaufnahmen von Halsketten, Ringen, Armbändern und Ohrringen auf speziell entwickelten Schmuck-Mannequins – Reflexionen und feine Oberflächen werden präzise verarbeitet.
5 Credits bei 2K · 6 Credits bei 4K1.5–4 min
Zum Endpoint - POST/api/v1/ghost-mannequin
Ghost Mannequin
Entfernen Sie die Schneiderpuppe aus einem Kleidungsfoto, während die innere Struktur vollständig erhalten bleibt. 3D- oder Flat-Lay-Finish, für Batch-Verarbeitung geeignet.
4 Credits bei 2K · 5 Credits bei 4K1.5–4 min
Zum Endpoint - POST/api/v1/ghost-mannequin/batch
Batch Ghost Mannequin
Übertragen Sie eine komplette Serie von Kleidungsfotos in einem einzigen Aufruf und fragen Sie eine Batch-ID per Polling ab; jedes Bild wird separat abgerechnet und getrackt.
4 Credits bei 2K · 5 Credits bei 4K1.5–4 min per image
Zum Endpoint - POST/api/v1/eyewear-studio
Eyewear Studio
Brillen und Sonnenbrillen auf Nahaufnahme-Modellen gerendert – das Gestell bleibt exakt wie auf Ihrem Produktfoto.
5 Credits bei 2K · 6 Credits bei 4K20–60 sec
Zum Endpoint - POST/api/v1/detail-photos
Detailaufnahmen
Nahaufnahmen von Nähten, Stoffen, Beschlägen und Etiketten aus einem einzigen Produktfoto; ein Analyzer schlägt vor, welche Bereiche aufgenommen werden sollten.
3 Credits20–60 sec
Zum Endpoint - POST/api/v1/mannequins/generate
Mannequin-Generierung
Generieren Sie eigene Schneiderpuppen für Kleidung oder Schmuck anhand von Optionen und verwenden Sie deren IDs in jedem Try-on-Aufruf wieder.
4 Credits30-60s
Zum Endpoint - POST/api/v1/workflows/{workflow_id}
Workflows
Führen Sie einen vordefinierten Workflow – beispielsweise einen Hero-Shot für Schmuck – mit einem einzigen Aufruf aus und erhalten Sie ein fertiges Set an Bildern.
4 Credits bei 2K · 5 Credits bei 4K20–60 sec / image
Zum Endpoint
Sprachen
Noch kein SDK — und Sie brauchen auch keins.
Drei Walkthroughs zum direkten Einfügen, die exakt den aktuellen Empfehlungen der Photta-Dokumentation entsprechen.
Node.js
Node.js
Natives fetch in Node 18+, 20-zeiliger Helper, bereit für Next.js Server Actions.
LesenPython
Python
requests-Bibliothek + ein 30-zeiliger Wrapper. Funktioniert in Django, FastAPI, Celery, Lambda.
LesencURL
cURL
Zwei-Minuten-Smoketest für jeden Endpoint. Lässt sich mit jq für Shell-Pipelines kombinieren.
Lesen
Quickstart
Von der Registrierung zum ersten Bild in fünf Minuten.
Jede Capability folgt demselben Muster: authentifizieren, übermitteln, pollen. Einmal lernen, überall anwenden.
Schritt 1: Registrieren Sie sich unter ai.photta.app und generieren Sie einen Live-API-Schlüssel im Developers-Dashboard.
Schritt 2: Senden Sie den Job per POST mit Ihrem Schlüssel im Authorization-Header — die API gibt sofort eine Generation-ID zurück.
Schritt 3: Pollen Sie denselben Endpoint alle 3 Sekunden, bis der Status auf completed wechselt, und laden Sie dann die Ergebnis-URL herunter.
Fragen
Was Entwickler vor der Registrierung fragen
Was ist die Photta-API?
Die API von Photta ist ein credit-basierter REST-Service, der aus Ihren Produktfotos professionelle Modefotografie generiert. Es ist dieselbe Pipeline, die auch Phottas Endanwender-Apps antreibt — virtuelles Apparel-Try-on, Schmuck-Try-on und Ghost-Mannequin-Freistellung —, bereitgestellt als acht Capabilities, auf denen Entwickler eigene Tools aufbauen können.
Wie erhalte ich einen API-Schlüssel?
Registrieren Sie sich unter ai.photta.app, öffnen Sie den Bereich Developers im Dashboard und klicken Sie auf Generate API key. Ihr Live-Schlüssel beginnt mit `photta_live_`, gefolgt von 32 Hex-Zeichen. Speichern Sie ihn in einer Umgebungsvariablen — niemals in die Versionsverwaltung committen, niemals an den Browser ausliefern.
Gibt es ein kostenloses Kontingent?
Neue Konten erhalten Test-credits, die Sie für jede Capability nutzen können. Sobald Sie produktiv gehen möchten, abonnieren Sie einen Tarif mit höherem monatlichen credit-Guthaben. Das Rate Limit ist in jedem Tarif identisch: 600 Requests pro Minute pro API-Schlüssel. Keine Mindestabnahmemengen pro Aufruf.
Wie schnell ist die Generierung?
Try-on- und Ghost-Mannequin-Jobs dauern in der Regel 1.5 bis 4 Minuten; Brillenaufnahmen, Detailfotos und Workflow-Bilder 20 bis 60 Sekunden; Mannequin-Generierungen 30 bis 60 Sekunden. Jeder Generierungs-Endpoint arbeitet asynchron: POST gibt umgehend eine Generation-ID zurück, und Sie pollen alle 3 bis 5 Sekunden, bis der Job abgeschlossen ist. Es muss keine dauerhafte HTTP-Verbindung aufrechterhalten werden.
Gibt es ein offizielles Photta-SDK?
Noch nicht. Der unterstützte Integrationsweg ist reines REST über cURL, Nodes natives fetch oder Pythons requests-Bibliothek — alle drei sind auf dieser Seite für jede Capability lückenlos dokumentiert.
Referenz
Die Abschnitte der Dokumentation, die Sie mehr als einmal öffnen werden.
Referenz
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 Rate Limits
Das Photta API Rate Limit, sein Zeitfenster, der Retry-After-Header, das Polling-Intervall und die tarifbasierten Concurrency-Limits, alles direkt aus der API-Dokumentation.
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.
LesenAnleitungen
Was ist eine Virtual-Try-On-API?
Eine Virtual-Try-On-API rendert ein Kleidungsstück anhand eines einzelnen Produktfotos auf ein Model. Was sie erwartet, was sie zurückgibt, was sie kostet und wie lange sie läuft.
LesenAnleitungen
Was ist eine Ghost-Mannequin-API?
Eine Ghost-Mannequin-API entfernt die Puppe aus einem Kleidungsstückfoto und rekonstruiert das Innenleben. Input-Anforderungen, Rückgabeformat und Kosten.
LesenAnleitungen
Migration von FASHN zu Photta
Was sich ändert, wenn Sie eine Virtual-Try-on-Integration von FASHN zu Photta migrieren: Authentifizierung, Request-Body, Polling und die Abrechnung der Credits.
LesenBuild
Bauen mit der Photta-API
Acht End-to-End-Rezepte für die Photta-API: eine Try-on-App, eine Shopify-App, ein WooCommerce-Plugin, ein Django-Worker, Batch-Kataloge und No-Code-Automatisierung.
LesenVergleich
Beste Virtual-Try-On-APIs
Wie fünf Virtual-Try-On-APIs funktionieren — Photta, FASHN, FitRoom, Pixazo und Ayna. Was jeder Anbieter veröffentlicht, was nicht und wo Sie die Details nachlesen können.
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.
- 8 Funktionen
- 600 Anfragen/Min.
- Bearer-Key
- asynchron, Polling