Bijoux · Fonctionnalité
API d'essayage de bijoux — Photta
Colliers, bagues, bracelets et boucles d'oreilles placés sur des modèles IA en gros plan, avec un traitement optimisé pour les micro-surfaces hautement réfléchissantes. Même tarification 2K/4K que les vêtements, même modèle asynchrone.
En une phrase
L'API d'essayage de bijoux de Photta accepte une photo de bijou ainsi qu'un `jewelry_type` (collier, bague, bracelet ou boucles d'oreilles) et renvoie une photo gros plan sur mannequin. Effectuez un POST sur `/api/v1/tryon/jewelry` avec `Authorization: Bearer photta_live_xxx`, interrogez l'ID retourné toutes les 3 secondes, et téléchargez le résultat quand le statut passe à `completed`.
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"
}'À quoi s'attendre
Typical completion
1.5–4min
2K / 4K credits
5 / 7
Jewelry types
4
Close-up mannequins
built-in
Code, de bout en bout
Choisissez votre langage
Mêmes trois guides — changez l'endpoint, changez le corps de la requête.
Comment ça marche
Le flux vêtement, réoptimisé pour les petits articles très réfléchissants
Choisissez un mannequin gros plan, soumettez, interrogez, téléchargez.
- 01
Étape 1
Générer une clé API
Même flux que pour les vêtements — ai.photta.app → Développeurs → Générer une clé API. Une seule clé fonctionne pour tous les endpoints ; un seul solde de crédits couvre toutes les fonctionnalités.
- 02
Étape 2
Choisir un mannequin gros plan
Filtrez `/api/v1/mannequins?jewelry_type=necklace` (ou bague / bracelet / boucles d'oreilles) — Photta propose un ensemble de mannequins gros plan avec des textures de peau optimisées pour les métaux et les pierres précieuses.
- 03
Étape 3
Soumettre la tâche bijou
POST sur `/api/v1/tryon/jewelry` avec `jewelry_type`, `jewelry_images`, `mannequin_id`, `resolution`, `aspect_ratio`. Le service ajuste automatiquement le placement selon la catégorie du bijou.
- 04
Étape 4
Interroger jusqu'à la fin de la tâche
GET sur `/api/v1/tryon/jewelry/:id` toutes les 3 secondes. La structure de réponse est identique aux vêtements — `data.status`, `data.output_url`, `data.thumbnail_url`.
- 05
Étape 5
Télécharger et stocker
Le format carré 1:1 fonctionne mieux pour les vignettes de fiches produits ; les formats larges pour l'éditorial. Stockez les octets vous-même plutôt que d'utiliser des liens directs vers le CDN.
Questions fréquentes des développeurs
Questions des développeurs avant de déployer l'essayage de bijoux
Quels types de bijoux sont supportés ?+
Quatre catégories explicites : collier, bague, bracelet, boucles d'oreilles. Chaque catégorie possède ses propres mannequins gros plan et une heuristique de placement optimisée. Les bagues et boucles d'oreilles profitent du ratio 1:1 ; les colliers s'affichent mieux en 3:4.
Combien coûte un essayage de bijou ?+
Même prix que pour les vêtements : 5 crédits en 2K, 7 crédits en 4K. Les tâches échouées sont remboursées automatiquement. Aucun supplément pour l'accès à la bibliothèque de mannequins gros plan.
En quoi l'endpoint bijou diffère-t-il de celui des vêtements ?+
Même authentification, même modèle de polling, même structure de réponse — les différences résident dans le corps de la requête. Vous envoyez `jewelry_type` et `jewelry_images` au lieu de `product_type` et `product_images`, et vous choisissez des mannequins filtrés par catégorie de bijoux. Tout le reste (2K/4K, ratios d'aspect, crédits) est partagé.
Puis-je télécharger mon propre modèle de bijou ?+
Oui — `/api/v1/jewelry-mannequins/upload` accepte une référence gros plan personnalisée, `/api/v1/jewelry-mannequins/generate` en produit une nouvelle à partir de prompts. Les deux renvoient un ID à injecter dans la requête d'essayage.
Comment sont gérés les métaux réfléchissants et les pierres ?+
Le pipeline gros plan intègre des métadonnées sur les reflets spéculaires et la micro-géométrie. L'or, l'argent et le platine poli miroir sont rendus correctement sans les effets de ghosting ou de bavure chromatique des pipelines d'essayage génériques. Des fonds studio ultra-propres sont recommandés.
Comment interroger le résultat ?+
GET sur `/api/v1/tryon/jewelry/:id` toutes les 3 à 5 secondes. Même cycle de statut que les vêtements : `processing` → `completed` ou `failed`. Une fenêtre de 1.5 à 4 minutes couvre la grande majorité des tâches.
Contenu lié
Fonctionnalités liées
Bijoux · Fonctionnalité
Créer un compte et obtenir une clé API
L'API d'essayage de bijoux de Photta accepte une photo de bijou ainsi qu'un `jewelry_type` (collier, bague, bracelet ou boucles d'oreilles) et renvoie une photo gros plan sur mannequin. Effectuez un POST sur `/api/v1/tryon/jewelry` avec `Authorization: Bearer photta_live_xxx`, interrogez l'ID retourné toutes les 3 secondes, et téléchargez le résultat quand le statut passe à `completed`.