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')

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.

Quickstart

Von der Registrierung zum ersten Bild in fünf Minuten.

Jede Capability folgt demselben Muster: authentifizieren, übermitteln, pollen. Einmal lernen, überall anwenden.

  1. Schritt 1: Registrieren Sie sich unter ai.photta.app und generieren Sie einen Live-API-Schlüssel im Developers-Dashboard.

  2. Schritt 2: Senden Sie den Job per POST mit Ihrem Schlüssel im Authorization-Header — die API gibt sofort eine Generation-ID zurück.

  3. Schritt 3: Pollen Sie denselben Endpoint alle 3 Sekunden, bis der Status auf completed wechselt, und laden Sie dann die Ergebnis-URL herunter.

Schnellstart

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.

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