uncloth.app गाइड
uncloth.app API से बनाया गया नतीजा

एडल्ट फ़िल्टर
आपके ऐप्स के लिए

एक एंडपॉइंट। ग्यारह प्रीसेट। फोटो भेजें, तैयार नतीजा पाएँ — आपका प्लेटफ़ॉर्म जिस भी वॉल्यूम पर चलता हो।

एक्सेस माँगें API देखें

प्रोडक्शन में चलने के लिए बना

uncloth.app एक इमेज ट्रांसफ़ॉर्मेशन API है, उन प्लेटफ़ॉर्म्स के लिए जिन्हें जनरेट की गई इमेजरी अपने प्रोडक्ट के भरोसेमंद हिस्से के रूप में चाहिए, प्रयोग के तौर पर नहीं। आप एक फोटो और मनचाहा प्रीसेट भेजते हैं। हम तैयार नतीजा लौटाते हैं।

एंडपॉइंट के पीछे की हर चीज़ चलाना हमारा काम है — क्षमता, कतार, डिलीवरी और रिकवरी। आपका इंटीग्रेशन एक ऑथेंटिकेटेड HTTP कॉल है, और लाइव प्रोग्रेस चाहिए तो एक WebSocket कनेक्शन।

रिक्वेस्ट का व्यवहार इस पर निर्भर नहीं करता कि हम कितने व्यस्त हैं। वही कॉल आपके पहले दिन और पीक लोड पर एक जैसा ही काम करता है।

एक फोटो, हर प्रीसेट

नीचे का हर नतीजा उसी एक स्रोत फोटो से आया है; रिक्वेस्ट में प्रीसेट id के अलावा कुछ नहीं बदला गया।

ग्यारह प्रीसेट

जॉब के साथ feature=<id> भेजें। न भेजें तो रिक्वेस्ट undress पर लौट जाती है। अनजान id को वैध सूची के साथ अस्वीकार किया जाता है, ताकि टाइपो साफ़ तौर पर विफल हो, न कि गलत इमेज लौटाए।

01
बिकिनीfeature=bikini
02
ब्रेस्ट साइज़feature=breast_size
03
बनी सूटfeature=bunny_suit
04
लेस लॉन्जरीfeature=lace_lingerie
05
शिबारीfeature=shibari
06
स्टॉकिंगfeature=stocking
07
टैटूfeature=tattoo
08
अनड्रेसडिफ़ॉल्टfeature=undress
09
चियरलीडर पोशाकfeature=cheerleader_outfit
10
फ़ुटीfeature=footy
11
फ़्लैश टिट्सfeature=flash_tits

शुरू से अंत तक चार कॉल

01

फोटो भेजें

इमेज, प्रीसेट और सहमति की पुष्टि के साथ एक multipart POST। जॉब id तुरंत मिल जाती है।

02

उसे ट्रैक करें

जॉब एंडपॉइंट को पोल करें या WebSocket सब्सक्राइब करें और काम चलते समय लाइव प्रोग्रेस इवेंट पाएँ।

03

नतीजा लें

पूरी हुई जॉब में एक आर्टिफ़ैक्ट id होती है। उसी की से उसे फ़ेच करें और इमेज बाइट्स पाएँ।

04

मुफ़्त में दोबारा भेजें

उसी Idempotency-Key के साथ कॉल दोहराएँ और वही मूल जॉब वापस मिलेगी। रीट्राई कभी दूसरा नतीजा नहीं बनाती।

पूरा इंटीग्रेशन

एक हेडर हर कॉल को ऑथेंटिकेट करता है। हर रिस्पॉन्स उसी क्लाइंट तक सीमित है जिसके पास की है — जॉब, इवेंट और नतीजे सहित।

POST/api/v1/jobsजॉब बनाएँ। Multipart: image, feature, consent. Idempotency-Key हेडर।
GET/api/v1/jobs/:idजॉब की स्थिति, प्रोग्रेस और नतीजे की id।
GET/api/v1/artifacts/:idबनाई गई इमेज डाउनलोड करें।
GET/api/v1/featuresप्रीसेट की सूची। सार्वजनिक, की ज़रूरी नहीं।
WS/api/v1/wsऑथ मैसेज के बाद लाइव job.updated इवेंट।

आपका बेस URL आपकी की के साथ जारी किया जाता है।

जॉब बनाएँ
curl -X POST https://api.uncloth.app/api/v1/jobs \
  -H "X-API-Key: $UNCLOTH_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -F feature=bikini \
  -F consent=confirmed \
  -F image=@photo.jpg

# { "data": { "id": "job_...", "status": "queued" } }
नतीजा लें
curl -H "X-API-Key: $UNCLOTH_KEY" \
  https://api.uncloth.app/api/v1/jobs/JOB_ID

# { "data": { "status": "succeeded",
#     "outputs": [ { "id": "art_..." } ] } }

curl -H "X-API-Key: $UNCLOTH_KEY" \
  https://api.uncloth.app/api/v1/artifacts/ART_ID \
  -o result.png

जवाब देते रहने के लिए इंजीनियर किया गया

क्षमता, कतार और डिलीवरी पथ हम चलाते हैं, ताकि आपके प्लेटफ़ॉर्म को न चलाना पड़े। ये वादे इस बारे में हैं कि सेवा कैसे बनाई और संचालित की जाती है।

10 मिनट में हटा दिया जाता है

परिणाम मिलने के 10 मिनट बाद आपकी छवि हमारे सिस्टम से हटा दी जाती है। प्रशिक्षण, समीक्षा या किसी अन्य उद्देश्य के लिए कुछ भी नहीं रखा जाता।

99.9% उपलब्धता का लक्ष्य

वह सेवा स्तर जिसके अनुसार हम डिज़ाइन, संचालन और माप करते हैं, जिसे किसी एक कंपोनेंट पर नहीं बल्कि API एज पर ट्रैक किया जाता है।

वैश्विक इंफ़्रास्ट्रक्चर

रिक्वेस्ट वितरित क्षमता से पूरी होती हैं, इसलिए एक क्षेत्र की माँग बाकी सबके लिए कतार नहीं बनती।

स्वचालित स्केलिंग

क्षमता लोड के साथ चलती है। ट्रैफ़िक का उछाल थ्रूपुट बदलता है, API का स्वरूप या आपके कोड के कॉल करने का तरीका कभी नहीं।

डिफ़ॉल्ट रूप से फ़ेलओवर

कोई भी एक कंपोनेंट बिना ऐसी रुकावट के हटाया या बदला जा सकता है जिसे आपको संभालना पड़े। चल रहा काम खोता नहीं, वापस पा लिया जाता है।

प्रति-की आइसोलेशन

एक की को केवल अपनी जॉब, इवेंट और नतीजे दिखते हैं। रिस्पॉन्स कभी आंतरिक पहचानकर्ता या इंफ़्रास्ट्रक्चर विवरण उजागर नहीं करते।

अनुबंध से आइडेमपोटेंट

Idempotency-Key हेडर रीट्राई को सुरक्षित बनाता है। दोहराव काम दो बार करने के बजाय मूल जॉब लौटाता है।

टिकाऊ कतार

स्वीकार किया गया काम शुरू होने से पहले दर्ज होता है और बाद में वापस पाया जा सकता है। पथ में कहीं भी रीस्टार्ट आपकी जॉब नहीं गिराता।

सख़्त इनपुट सत्यापन

JPEG, PNG और WebP, 20 MiB तक, जिन्हें फ़ाइल के नाम या घोषित प्रकार से नहीं बल्कि सामग्री से जाँचा जाता है।

आम सवाल

ऑथेंटिकेशन कैसे करूँ?

REST कॉल पर X-API-Key हेडर। WebSocket पर की कनेक्ट होने के बाद पहले मैसेज में जाती है, इसलिए वह कभी किसी URL या प्रॉक्सी लॉग में नहीं आती।

अगर रिक्वेस्ट टाइम आउट हो जाए तो?

उसे उसी Idempotency-Key के साथ दोहराएँ। मूल जॉब वापस मिलती है और दूसरा नतीजा नहीं बनता।

कौन से फ़ॉर्मेट और आकार स्वीकार हैं?

JPEG, PNG और WebP, 20 MiB तक। फ़ाइल की असली सामग्री जाँची जाती है, इसलिए नाम बदली या गलत लेबल वाली फ़ाइल अस्वीकार हो जाती है।

क्या एक ही फोटो पर कई प्रीसेट चला सकता हूँ?

हाँ। हर प्रीसेट अपनी अलग जॉब है, इसलिए उसी स्रोत इमेज के साथ हर प्रीसेट के लिए एक जॉब भेजें और उन्हें अलग-अलग ट्रैक करें।

क्या पोलिंग करनी ज़रूरी है?

नहीं। WebSocket से जुड़ें, ऑथेंटिकेट करें, और आपको अपनी हाल की जॉब का स्नैपशॉट मिलेगा और उसके बाद लाइव अपडेट। पोलिंग फ़ॉलबैक के रूप में उपलब्ध रहती है।

क्या सहमति अनिवार्य है?

हाँ। consent=confirmed के बिना क्रिएट कॉल API सीमा पर ही अस्वीकार हो जाती है। यह एक अनिवार्य फ़ील्ड है और एक घोषणा है जिसके लिए आप जवाबदेह हैं।

इसकी लागत क्या है?

कीमत वॉल्यूम पर निर्भर करती है और एक्सेस के साथ बताई जाती है। अपने प्लेटफ़ॉर्म और अपेक्षित थ्रूपुट के बारे में बताएँ, हम आँकड़ों के साथ जवाब देंगे।

क्या आप मेरी इमेज रखते हैं?

स्रोत इमेज और नतीजे निजी स्टोरेज में रखे जाते हैं और केवल उसी की को दिए जाते हैं जिसने उन्हें बनाया। रिटेंशन की शर्तें एक्सेस के हिस्से के रूप में तय होती हैं।

बताइए आप क्या बना रहे हैं

एक्सेस हर इंटीग्रेशन के लिए अलग से दिया जाता है। अपने प्लेटफ़ॉर्म, अपेक्षित वॉल्यूम और यह बताएँ कि इमेज में मौजूद लोगों से सहमति कैसे लेते हैं — हम क्रेडेंशियल और बेस URL भेज देंगे।

कोई सार्वजनिक साइन-अप नहीं। कोई सेल्फ़-सर्व की नहीं।