Referenz · Ressourcen
Ressourcen-Endpoints der Photta-API die IDs, die jede Generierung benötigt
In aller Kürze
Ressourcen-Endpoints liefern die IDs zurück, die ein Generierungsaufruf erfordert: Mannequins, Posen, Hintergründe, Schuhe, Kleidungsattribute und Markenlabels, plus Ihren Account-Stand und Verbrauch. Das Auflisten kostet nichts.
- Ressourcen-Endpoints: 13 Ressourcen-Endpoints
- Authentifizierung: Bearer-Key
- Limits: 600 Anfragen/Min.
Jeder Zahlenwert auf dieser Seite stammt aus der Photta-API-Dokumentation · geprüft
Jeder Ressourcen-Endpoint mit dem zugehörigen Leseaufruf
Jeder Abschnitt verlinkt die Funktion, die diese IDs verarbeitet.
Mannequins
Listet die für Bekleidungs-Try-ons verfügbaren Models auf: Phottas System-Mannequins, Ihre eigenen Uploads und die mit der Mannequin-Generierungs-API erstellten. Senden Sie einen POST an denselben Pfad, um ein benutzerdefiniertes Mannequin hochzuladen, das für Ihren Account privat bleibt. Die ID wird als `mannequin_id` bei einem Try-on-Aufruf übergeben.
curl https://api.photta.app/api/v1/mannequins \
-H "Authorization: Bearer $PHOTTA_API_KEY"const res = await fetch("https://api.photta.app/api/v1/mannequins", {
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();import os, requests
res = requests.get(
"https://api.photta.app/api/v1/mannequins",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]Schmuck-Mannequins
Lädt ein Nahaufnahme-Modelfoto für Schmuck-Try-ons hoch. Schmuckaufnahmen sind auf Ausschnitt, Ohr, Handgelenk oder Hand fokussiert und erfordern daher ein eigenes Mannequin-Set anstelle des Ganzkörper-Sets für Bekleidung.
RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/mannequins/jewelry \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"image": "https://cdn.yourstore.com/models/emma-neck.jpg",
"jewelry_type": "necklace",
"gender": "female",
"name": "Emma"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')const res = await fetch("https://api.photta.app/api/v1/mannequins/jewelry", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
"image": "https://cdn.yourstore.com/models/emma-neck.jpg",
"jewelry_type": "necklace",
"gender": "female",
"name": "Emma"
}),
});
const { data } = await res.json(); // data.id, data.statusimport os, requests
res = requests.post(
"https://api.photta.app/api/v1/mannequins/jewelry",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
json={
"image": "https://cdn.yourstore.com/models/emma-neck.jpg",
"jewelry_type": "necklace",
"gender": "female",
"name": "Emma"
},
)
data = res.json()["data"] # data["id"], data["status"]Posen
Listet die Posen auf, die ein Try-on anfordern kann, filterbar nach Kategorie und passendem Produkttyp. Übergeben Sie die ID als `pose_id`; lassen Sie sie weg, wählt die API eine zum Kleidungsstück passende Pose.
curl https://api.photta.app/api/v1/poses \
-H "Authorization: Bearer $PHOTTA_API_KEY"const res = await fetch("https://api.photta.app/api/v1/poses", {
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();import os, requests
res = requests.get(
"https://api.photta.app/api/v1/poses",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]Kleidungslänge und Passform
Gibt die Längen- und Passform-Schlüssel zurück, die Bekleidungs-Try-ons akzeptieren. Senden Sie den Schlüssel statt einer Freitextbeschreibung, damit dasselbe Hemd im gesamten Katalog einheitlich gerendert wird.
curl https://api.photta.app/api/v1/garment-attributes \
-H "Authorization: Bearer $PHOTTA_API_KEY"const res = await fetch("https://api.photta.app/api/v1/garment-attributes", {
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();import os, requests
res = requests.get(
"https://api.photta.app/api/v1/garment-attributes",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]Hintergründe
Listet Systemhintergründe und Ihre eigenen Uploads für Bekleidungs-Try-ons auf, mit Cursor-Paginierung. Senden Sie einen POST an denselben Pfad, um einen eigenen Hintergrund hochzuladen; er bleibt für Ihren Account privat.
curl https://api.photta.app/api/v1/backgrounds \
-H "Authorization: Bearer $PHOTTA_API_KEY"const res = await fetch("https://api.photta.app/api/v1/backgrounds", {
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();import os, requests
res = requests.get(
"https://api.photta.app/api/v1/backgrounds",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]Markenlabels
Lädt ein wiederverwendbares Label-Bild für Ghost-Mannequin-Aufgaben hoch und gibt eine ID zurück, die Sie als `brand_label_id` übergeben – sowohl bei Einzeljobs als auch bei Batches. GET listet Ihre gespeicherten Labels auf; DELETE entfernt eines, wenn Sie das Account-Limit erreichen.
RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/brand-labels \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"file": "@/path/to/pribrand-label.png",
"name": "Pribrand Collar Label"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')const res = await fetch("https://api.photta.app/api/v1/brand-labels", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
"file": "@/path/to/pribrand-label.png",
"name": "Pribrand Collar Label"
}),
});
const { data } = await res.json(); // data.id, data.statusimport os, requests
res = requests.post(
"https://api.photta.app/api/v1/brand-labels",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
json={
"file": "@/path/to/pribrand-label.png",
"name": "Pribrand Collar Label"
},
)
data = res.json()["data"] # data["id"], data["status"]Schuhe
Listet Schuhoptionen für Bekleidungs-Try-ons auf, filterbar nach Typ und Geschlecht, mit Cursor-Paginierung. Nutzen Sie dies, um demselben Model, das das Kleidungsstück trägt, Schuhe anzuziehen.
curl https://api.photta.app/api/v1/footwear \
-H "Authorization: Bearer $PHOTTA_API_KEY"const res = await fetch("https://api.photta.app/api/v1/footwear", {
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();import os, requests
res = requests.get(
"https://api.photta.app/api/v1/footwear",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]Account
Gibt Ihren Guthabenstand an Credits aufgeschlüsselt nach Quelle, Ihren aktuellen Plan und die nächste Credit-Erneuerung zurück. Rufen Sie ihn vor einem großen Batch ab, statt den Engpass erst durch einen 402 festzustellen.
curl https://api.photta.app/api/v1/account \
-H "Authorization: Bearer $PHOTTA_API_KEY"const res = await fetch("https://api.photta.app/api/v1/account", {
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();import os, requests
res = requests.get(
"https://api.photta.app/api/v1/account",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]Verbrauch
Generierungsanzahl und Credit-Ausgaben für das Abrechnungsfenster des aktuellen Kalendermonats, aufgeteilt in erfolgreiche und fehlgeschlagene Jobs. Dies ist der Endpoint für Auswertungen, nicht Ihre eigene Zählung von Requests.
curl https://api.photta.app/api/v1/account/usage \
-H "Authorization: Bearer $PHOTTA_API_KEY"const res = await fetch("https://api.photta.app/api/v1/account/usage", {
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();import os, requests
res = requests.get(
"https://api.photta.app/api/v1/account/usage",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]Fragen zu den Ressourcen-Endpoints
Wozu dienen die Ressourcen-Endpoints?
Sie liefern die IDs zurück, die Generierungsaufrufe benötigen – ein Mannequin, eine Pose, ein Hintergrund, ein Markenlabel – plus Ihren Account-Status. Nichts in dieser Gruppe generiert ein Bild.
Kosten Ressourcenaufrufe Credits?
Nein. Das Auflisten ist kostenlos, und auch die Uploads in dieser Gruppe – ein benutzerdefiniertes Mannequin, ein Hintergrund, ein Markenlabel – sind kostenlos. Sie zahlen nur für Generierungen.
Wie paginiere ich durch eine lange Liste?
Die Listen-Endpoints akzeptieren ein Limit und einen Cursor: Übergeben Sie die zuletzt gesehene ID als `starting_after` und rufen Sie die nächste Seite ab. Cachen Sie die Ergebnisse, statt sie bei jedem Request erneut aufzulisten.
Kann ich eigene Mannequins und Hintergründe hochladen?
Ja. POST `/api/v1/mannequins`, POST `/api/v1/mannequins/jewelry`, POST `/api/v1/backgrounds` und POST `/api/v1/brand-labels` akzeptieren alle Ihre eigenen Bilder, und alles, was Sie hochladen, bleibt für Ihren Account privat.
Wo diese IDs verwendet werden
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 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.
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.
- 13 Ressourcen-Endpoints
- Bearer-Key
- 600 Anfragen/Min.