प्रमाणीकरण
एक API कुंजी बनाएं और पूर्ण गुप्त को बियरर प्रमाण के रूप में भेजें। गुप्त केवल एक बार प्रदर्शित की जाती है।
Authorization: Bearer fd_live_xxxएक वर्चुअल ट्राई-ऑन कार्य जमा करें
एक वस्त्र छवि और एक मॉडल छवि जमा करें। सफल अनुरोध HTTP 202 के साथ कार्य ID लौटाता है।
curl -X POST \
"https://www.fashiondiffusion.ai/api/public/v1/virtual-try-on/tasks" \
-H "Authorization: Bearer fd_live_xxx" \
-H "Content-Type: application/json" \
--data-raw '{
"garmentImageUrl": "https://cdn.example.com/garment.jpg",
"modelImageUrl": "https://cdn.example.com/model.jpg",
"imageCount": 1,
"resolution": "2K",
"ratio": "3:4",
"mode": "FAST",
"prompt": "Keep the garment shape and fabric texture"
}'| पैरामीटर | समर्थित मान | डिफ़ॉल्ट |
|---|---|---|
| imageCount | 1, 2, 4 | 1 |
| resolution | 2K, 4K | 2K |
| ratio | 1:1, 3:4, 4:3, 9:16, 16:9 | 3:4 |
| mode | FAST, REFINE | FAST |
दोनों छवियाँ सार्वजनिक HTTPS URL होनी चाहिए, छवि सामग्री प्रकार लौटानी चाहिए, और 20 MB से अधिक नहीं होनी चाहिए।
प्रत्येक स्वीकृत अनुरोध एक नया कार्य बनाता है और इसके लिए शुल्क लगाता है। इस संस्करण में कोई अवरोधन सुरक्षा नहीं है, इसलिए डुप्लिकेट शुल्क स्वीकार्य नहीं होने पर समय समाप्त होने पर स्वचालित रूप से पुनः प्रयास न करें।
एक कार्य की जांच करें
जमा अंतबिंदु द्वारा लौटाए गए कार्य ID का उपयोग करें। कोई भी API कुंजी केवल अपने उपयोगकर्ता और वर्तमान टीम द्वारा स्वामित्व वाले कार्यों को पढ़ सकती है।
curl \
-H "Authorization: Bearer fd_live_xxx" \
"https://www.fashiondiffusion.ai/api/public/v1/tasks/{taskId}"कार्य की स्थितियाँ QUEUED, RUNNING, SUCCEEDED, और FAILED हैं। सफल आउटपुट छवि URL को outputs में लौटाया जाता है।
कार्यों की सूची बनाएं
वर्तमान उपयोगकर्ता द्वारा सार्वजनिक API के माध्यम से जमा किए गए वर्चुअल ट्राई-ऑन कार्यों की सूची बनाएं। उपयोगकर्ता की किसी भी API कुंजी के साथ जमा किए गए कार्य शामिल हैं।
curl \
-H "Authorization: Bearer fd_live_xxx" \
"https://www.fashiondiffusion.ai/api/public/v1/tasks?limit=20&createdAfter=2026-08-01T00%3A00%3A00Z"limit 1 से 100 के बीच स्वीकार करता है और डिफ़ॉल्ट रूप से 20 है। अगले अनुरोध में cursor के रूप में nextCursor का उपयोग करें। createdAfter एक वैकल्पिक ISO 8601 टाइमस्टैम्प है।
त्रुटियाँ
त्रुटियाँ एक सुसंगत एन्वलप का उपयोग करती हैं। अनुरोध ID को X-Request-Id प्रतिक्रिया हेडर में भी लौटाया जाता है।
{
"error": {
"code": "VALIDATION_ERROR",
"message": "garmentImageUrl: Invalid url",
"requestId": "request-uuid"
}
}