Référence · Ressources
Endpoints de ressources de l'API Photta les identifiants requis par chaque génération
En une phrase
Les endpoints de ressources renvoient les identifiants requis par un appel de génération : mannequins, poses, arrière-plans, chaussures, attributs de vêtements et étiquettes de marque, ainsi que le solde et l'utilisation de votre compte. Les requêtes de liste sont gratuites.
- Endpoints de ressources: 13 endpoints de ressources
- Authentification: Clé Bearer
- Limites: 600 requêtes/min
Chaque chiffre sur cette page provient de la documentation de l'API Photta · vérifié
Chaque endpoint de ressource, avec l'appel permettant de le lire
Chaque section renvoie à la fonctionnalité qui consomme ces identifiants.
Mannequins
Liste les modèles disponibles pour le try-on de vêtements : les mannequins système de Photta, vos propres imports et ceux créés avec l'API de génération de mannequins. Envoyez un POST sur le même chemin pour importer un mannequin personnalisé, qui reste privé pour votre compte. L'identifiant se renseigne dans `mannequin_id` lors d'un appel de try-on.
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"]Mannequins pour bijoux
Importe une photo de modèle en gros plan pour le try-on de bijoux. Le travail sur les bijoux étant cadré sur un décolleté, une oreille, un poignet ou une main, il requiert son propre ensemble de mannequins plutôt que celui pour vêtements en corps entier.
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"]Poses
Liste les poses qu'un try-on peut demander, filtrables par catégorie et par type de produit correspondant. Passez l'identifiant via `pose_id` ; en son absence, l'API choisit une pose adaptée au vêtement.
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"]Longueur et coupe du vêtement
Renvoie les clés de longueur et de coupe acceptées par le try-on de vêtements. Transmettez la clé, et non une description en texte libre, afin que le même t-shirt s'affiche de manière identique sur l'ensemble d'un catalogue.
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"]Arrière-plans
Liste les arrière-plans système et vos propres imports pour le try-on de vêtements, avec pagination par curseur. Envoyez un POST sur le même chemin pour importer un arrière-plan personnalisé ; il reste privé pour votre compte.
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"]Étiquettes de marque
Importe une image d'étiquette réutilisable pour le traitement en mannequin fantôme et renvoie un identifiant à transmettre dans `brand_label_id`, pour les tâches unitaires comme pour les lots. GET liste vos éléments enregistrés ; DELETE en supprime un lorsque vous atteignez la limite du compte.
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"]Chaussures
Liste les options de chaussures pour le try-on de vêtements, filtrables par type et par genre, avec pagination par curseur. Utilisez-le pour chausser le modèle qui porte le vêtement.
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"]Compte
Renvoie votre solde de crédits ventilé par source, votre forfait actuel et le prochain renouvellement de crédits. Consultez-le avant un lot volumineux au lieu de constater le manque de crédits sur une 402.
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"]Utilisation
Nombre de générations et consommation de crédits pour la période de facturation du mois calendaire en cours, ventilés entre tâches réussies et échouées. C'est l'endpoint à intégrer dans vos graphiques, et non votre propre décompte de requêtes.
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"]Questions sur les endpoints de ressources
À quoi servent les endpoints de ressources ?
Ils renvoient les identifiants consommés par les appels de génération — un mannequin, une pose, un arrière-plan, une étiquette de marque — ainsi que l'état de votre compte. Aucun endpoint de ce groupe ne génère d'image.
Les appels de ressources consomment-ils des crédits ?
Non. Les listes sont gratuites, et les imports de ce groupe — un mannequin personnalisé, un arrière-plan, une étiquette de marque — sont également gratuits. Vous ne payez que pour les générations.
Comment paginer une liste volumineuse ?
Les endpoints de liste acceptent une limite et un curseur : transmettez le dernier identifiant reçu dans `starting_after` pour lire la page suivante. Mettez le résultat en cache plutôt que de lister à nouveau à chaque requête.
Puis-je importer mes propres mannequins et arrière-plans ?
Oui. POST `/api/v1/mannequins`, POST `/api/v1/mannequins/jewelry`, POST `/api/v1/backgrounds` et POST `/api/v1/brand-labels` acceptent tous vos propres images, et chaque fichier importé reste privé pour votre compte.
Où ces identifiants sont utilisés
Fonctionnalités
API de try-on virtuel pour les vêtements
API REST qui positionne des vêtements sur des mannequins générés par IA. Traitement asynchrone, génération en 1.5–4 minutes, 5 crédits en 2K, 6 en 4K. Exemples en cURL, Node.js et Python.
LireFonctionnalités
API de try-on de bijoux pour colliers, bagues, bracelets et boucles d'oreilles
Positionnez colliers, bagues, bracelets et boucles d'oreilles sur des modèles IA via REST. 5 crédits en 2K, mannequins gros plan intégrés, rendu gérant les reflets d'après la documentation de Photta.
LireFonctionnalités
API mannequin fantôme pour des photos de produits sur mannequin invisible
Endpoint AI de mannequin fantôme. Supprimez le mannequin d'une photo de vêtement et préservez les détails intérieurs. 3D ou flat-lay, traitement par lots, 4 crédits en 2K.
LireRéférence
Première image Photta en moins de cinq minutes.
Inscrivez-vous, générez une clé d'API, lancez votre premier appel cURL, effectuez le polling jusqu'à la complétion, persistez le résultat. Cinq étapes documentées de bout en bout.
LireRéférence
Authentification de l’API Photta
Comment s’authentifier auprès de l’API Photta : l’en-tête Authorization, le préfixe de clé, l’endroit où les clés sont créées et comment en effectuer la rotation en toute sécurité.
LireRéférence
Tarification de l'API Photta
Le coût en crédits de chaque endpoint de l’API Photta en 2K et 4K, le fonctionnement de la facturation et des remboursements, et les endpoints gratuits. Aucun prix monétaire par image.
LireRéférence
Rate limits de l'API Photta
La rate limit de l'API Photta, sa fenêtre, l'en-tête Retry-After, l'intervalle de polling et les plafonds de simultanéité par forfait, tels que documentés dans l'API.
LireRéférence
Erreurs de l’API Photta
La liste complète des types d’erreurs de l’API Photta avec leurs codes de statut, la structure du corps d’erreur et les échecs pouvant être réessayés.
Lire
Chaque chiffre sur cette page provient de la documentation de l'API Photta · vérifié
Testez l'API en cinq minutes
Générez une clé d'API Photta, collez le snippet cURL ci-dessus, et vous obtiendrez votre première photo portée sur modèle avant même que le café ait fini de couler.
- 13 endpoints de ressources
- Clé Bearer
- 600 requêtes/min