API d'essayage virtuel

Authentification

Envoyez la clé dans l'en-tête Authorization. Les clés de test commencent par hk_test_, les clés live par hk_live_.

Authorization: Bearer hk_live_xxxxxxxxxxxxxxxx

Créer un essayage

POST https://houshstyle.ir/api/v1/try-on/ — multipart/form-data, ou JSON avec des URL d'images

curl -X POST https://houshstyle.ir/api/v1/try-on/ \
  -H "Authorization: Bearer $HUSH_KEY" \
  -F person_image=@person.jpg \
  -F garment_image=@dress.jpg \
  -F garment_type=w_gown \
  -F garment_image_2=@heels.jpg \
  -F garment_type_2=w_heels \
  -F resolution=hd \
  -F webhook_url=https://your-app.com/hooks/tryon

Réponse (202) :

{"id": "8b1c…", "status": "queued", "result_url": null, "credits_charged": 2, ...}

Récupérer le résultat

GET https://houshstyle.ir/api/v1/try-on/{id}/

Statuts : queued, processing, completed, failed. En completed, result_url est l'image finale. En cas d'échec, le crédit est remboursé automatiquement (refunded=true).

Exemple Python

import requests, time
H = {"Authorization": "Bearer hk_live_..."}
r = requests.post("https://houshstyle.ir/api/v1/try-on/", headers=H,
    files={"person_image": open("me.jpg", "rb"), "garment_image": open("dress.jpg", "rb")},
    data={"garment_type": "w_cocktail"})
job = r.json()
while job["status"] in ("queued", "processing"):
    time.sleep(2)
    job = requests.get(f"https://houshstyle.ir/api/v1/try-on/{job['id']}/", headers=H).json()
print(job["result_url"])

Exemple JavaScript (Node)

const fd = new FormData();
fd.append("person_image_url", "https://cdn.example.com/u/123.jpg");
fd.append("garment_id", "42");
const res = await fetch("https://houshstyle.ir/api/v1/try-on/", {
  method: "POST", headers: { Authorization: `Bearer ${process.env.HUSH_KEY}` }, body: fd });
console.log(await res.json());

Exemple PHP

$ch = curl_init("https://houshstyle.ir/api/v1/try-on/");
curl_setopt_array($ch, [CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("HUSH_KEY")],
  CURLOPT_POSTFIELDS => ["person_image" => new CURLFile("me.jpg"), "garment_image" => new CURLFile("coat.jpg"),
                         "garment_type" => "m_blazer"]]);
echo curl_exec($ch);

Webhook

À la fin du traitement, un POST JSON avec les en-têtes suivants est envoyé à webhook_url :

X-Hush-Timestamp: 1760780000
X-Hush-Signature: sha256=HMAC_SHA256(webhook_secret, timestamp + "." + raw_body)

{"event": "tryon.completed", "data": {"id": "...", "status": "completed", "result_url": "..."}}

# Python verify
import hmac, hashlib
expected = hmac.new(SECRET.encode(), ts.encode() + b"." + body, hashlib.sha256).hexdigest()
assert hmac.compare_digest("sha256=" + expected, signature)

Autres endpoints

• GET /api/v1/usage/ — Crédit restant et consommation du mois
• GET /api/v1/garments/ — Vêtements disponibles (publics + vos produits)
• GET /api/v1/try-on/list/ — 50 derniers essayages

Codes d'erreur

Types de vêtements et d'accessoires (garment_type)

Les clés u_ sont unisexes. Les anciens noms anglais (comme cocktail dress) sont toujours acceptés.

Vêtements — Femme

Vêtements — Homme

Ensembles & combinaisons — Femme

Ensembles & combinaisons — Homme

Ensembles & combinaisons — Unisexe

Accessoires — Femme

Accessoires — Homme

Accessoires — Unisexe