Schmuck · Funktion

Schmuck-Anprobe API — Photta

Halsketten, Ringe, Armbänder und Ohrringe auf KI-Modellen in Nahaufnahme, optimiert für kleinste, hochreflektierende Oberflächen. Gleiches 2K/4K-Pricing wie bei Bekleidung, gleiches Async-Muster.

Kurz zusammengefasst

Die Schmuck-Anprobe API von Photta akzeptiert ein Schmuckfoto sowie einen `jewelry_type` (necklace, ring, bracelet oder earrings) und liefert ein Close-Up-On-Model-Foto zurück. POST an `/api/v1/tryon/jewelry` mit `Authorization: Bearer photta_live_xxx`, pollen Sie die ID alle 3 Sekunden und laden Sie das Ergebnis herunter, wenn der Status `completed` ist.

API-Key erhalten→Dokumentation lesen
POST/api/v1/tryon/jewelry
cURL
curl -X POST https://ai.photta.app/api/v1/tryon/jewelry \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jewelry_type": "necklace",
    "jewelry_images": ["https://example.com/necklace.jpg"],
    "mannequin_id": "mnq_jewelry_close_01",
    "resolution": "2K",
    "aspect_ratio": "1:1"
  }'

Was Sie erwartet

Typical completion

1.5–4min

2K / 4K credits

5 / 7

Jewelry types

4

Close-up mannequins

built-in

Code, End-to-End

Wählen Sie Ihre Sprache

Dieselben drei Anleitungen — Endpunkt und Request-Body anpassen.

SDK

→

Node.js

Native fetch · Ersetzen Sie `/tryon/apparel` durch `/tryon/jewelry` und fertig

SDK

→

Python

requests + derselbe photta.py Wrapper · keine extra Abhängigkeiten

SDK

→

cURL

Zwei-Minuten-Smoke-Test · perfekt zur Verifizierung von Schmucktypen

Funktionsweise

Der Apparel-Flow, optimiert für kleine, hochreflektierende Objekte

Nahaufnahme-Mannequin wählen, senden, pollen, herunterladen.

  1. 01

    Schritt 1

    API-Key generieren

    Gleicher Flow wie bei Bekleidung — ai.photta.app → Developers → Generate API key. Ein Key funktioniert für jeden Endpunkt; ein Credit-Guthaben deckt jede Funktion ab.

  2. 02

    Schritt 2

    Nahaufnahme-Mannequin wählen

    Filtern Sie `/api/v1/mannequins?jewelry_type=necklace` (oder ring / bracelet / earrings) — Photta bietet spezialisierte Close-Up-Mannequins mit Hauttexturen, die für feines Metall und Stein optimiert sind.

  3. 03

    Schritt 3

    Schmuck-Job POSTen

    POST an `/api/v1/tryon/jewelry` mit `jewelry_type`, `jewelry_images`, `mannequin_id`, `resolution`, `aspect_ratio`. Der Service skaliert die Platzierung automatisch für die jeweilige Schmuckkategorie.

  4. 04

    Schritt 4

    Pollen bis zum Abschluss

    GET `/api/v1/tryon/jewelry/:id` alle 3 Sekunden. Die Antwortstruktur ist identisch mit Apparel — `data.status`, `data.output_url`, `data.thumbnail_url`.

  5. 05

    Schritt 5

    Herunterladen und persistieren

    Ein 1:1-Zuschnitt eignet sich am besten für PDP-Thumbnails; breitere Formate für Editorials. Speichern Sie die Bilddaten selbst, statt das CDN direkt zu verlinken.

Fragen anderer Entwickler

Fragen, die Entwickler vor dem Einsatz von Schmuck-Anprobe stellen

Welche Schmucktypen werden unterstützt?+

Vier explizite Kategorien: necklace, ring, bracelet, earrings. Jede Kategorie verfügt über eigene Close-Up-Mannequins und eine auf diesen Formfaktor abgestimmte Platzierungs-Heuristik. Ringe und Ohrringe profitieren meist von 1:1-Seitenverhältnissen; Ketten wirken gut in 3:4.

Was kostet eine Schmuck-Anprobe?+

Gleich wie Bekleidung: 5 Credits bei 2K, 7 Credits bei 4K. Fehlgeschlagene Jobs werden automatisch erstattet. Kein Aufpreis für die Close-Up-Mannequin-Bibliothek.

Wie unterscheidet sich der Schmuck-Endpunkt von Bekleidung?+

Gleiche Authentifizierung, gleiches Polling-Muster, gleiche Antwortstruktur — die Unterschiede liegen im Request-Body. Sie senden `jewelry_type` und `jewelry_images` statt `product_type` und `product_images` und wählen Mannequins, die nach Schmuckkategorien gefiltert sind. Alles andere (2K/4K, Seitenverhältnisse, Credits) ist identisch.

Kann ich mein eigenes Schmuck-Modell hochladen?+

Ja — `/api/v1/jewelry-mannequins/upload` akzeptiert eine eigene Close-Up-Referenz, `/api/v1/jewelry-mannequins/generate` erstellt eine neue per Prompt. Beide liefern eine ID für den Try-On-Request.

Wie werden reflektierende Metalle und Edelsteine verarbeitet?+

Die Close-Up-Pipeline verarbeitet Metadaten zu Glanzlichtern und Mikrogeometrie. Gold, Silber und poliertes Platin werden korrekt gerendert, ohne das Ghosting oder die chromatischen Schlieren allgemeiner Try-On-Pipelines. Sehr saubere Studiohintergründe werden für beste Ergebnisse empfohlen.

Wie frage ich das Ergebnis ab?+

GET `/api/v1/tryon/jewelry/:id` alle 3 bis 5 Sekunden. Gleicher Status-Lebenszyklus wie bei Apparel: `processing` → `completed` oder `failed`. Ein Fenster von 1.5 bis 4 Minuten deckt fast alle Jobs ab.

Verwandte Themen

Verwandte Funktionen

/api/virtual-try-on-api

virtual-try-on

5–7 credits · ~3 min

View capability →

Schmuck · Funktion

Account erstellen und API-Key erhalten

Die Schmuck-Anprobe API von Photta akzeptiert ein Schmuckfoto sowie einen `jewelry_type` (necklace, ring, bracelet oder earrings) und liefert ein Close-Up-On-Model-Foto zurück. POST an `/api/v1/tryon/jewelry` mit `Authorization: Bearer photta_live_xxx`, pollen Sie die ID alle 3 Sekunden und laden Sie das Ergebnis herunter, wenn der Status `completed` ist.

API-Key erhalten →Preise ansehen
Schmuck-Anprobe API | Photta | Photta