فلاتر للبالغين
لتطبيقاتك

نقطة وصول واحدة. 11 نمطًا. أرسل صورة واستلم النتيجة النهائية، مهما كان حجم التشغيل في منصتك.

مبنية للعمل في الإنتاج

uncloth.app واجهة برمجية لتحويل الصور، موجهة للمنصات التي تحتاج إلى صور مولّدة كجزء موثوق من منتجها لا كتجربة. ترسل صورة والنمط الذي تريده، ونعيد لك النتيجة النهائية.

كل ما خلف نقطة الوصول نتولى تشغيله: السعة والطوابير والتسليم والاسترداد. تكاملك هو استدعاء HTTP واحد موثّق، وإن أردت متابعة التقدم مباشرة فاتصال WebSocket واحد.

لا شيء في الطلب يتوقف على مقدار الحمل لدينا. الاستدعاء نفسه يتصرف بالطريقة نفسها في يومك الأول وفي ذروة الحمل.

صورة واحدة وكل الأنماط

كل نتيجة أدناه جاءت من الصورة المصدر نفسها، مع تغيير معرّف النمط في الطلب فقط.

نتيجة مولّدة بالنمط بيكيني — بيكينيfeature=bikini

نتيجة مولّدة بالنمط ملابس داخلية دانتيل — ملابس داخلية دانتيلfeature=lace_lingerie

نتيجة مولّدة بالنمط زي الأرنب — زي الأرنبfeature=bunny_suit

نتيجة مولّدة بالنمط جوارب طويلة — جوارب طويلةfeature=stocking

نتيجة مولّدة بالنمط زي مشجعة — زي مشجعةfeature=cheerleader_outfit

نتيجة مولّدة بالنمط شيباري — شيباريfeature=shibari

11 نمطًا

مرّر feature=<id> مع المهمة. إن أغفلته يعود الطلب إلى undress. أي معرّف غير معروف يُرفض مع إرجاع القائمة الصالحة، فيفشل الخطأ المطبعي بوضوح بدل إعادة صورة خاطئة.

بيكينيfeature=bikini

حجم الصدرfeature=breast_size

زي الأرنبfeature=bunny_suit

ملابس داخلية دانتيلfeature=lace_lingerie

شيباريfeature=shibari

جوارب طويلةfeature=stocking

وشمfeature=tattoo

تعريةالافتراضيfeature=undress

زي مشجعةfeature=cheerleader_outfit

زي كرة القدمfeature=footy

كشف الصدرfeature=flash_tits

أربعة استدعاءات من البداية إلى النهاية

أرسل الصورة

طلب POST من نوع multipart يحمل الصورة والنمط وتأكيد الموافقة. تستلم معرّف المهمة فورًا.

تابع المهمة

استعلم عن نقطة وصول المهمة أو اشترك عبر WebSocket لتصلك أحداث التقدم مباشرة أثناء التنفيذ.

استلم النتيجة

المهمة المكتملة تحمل معرّف ناتج. اطلبه بالمفتاح نفسه لتحصل على بايتات الصورة.

أعد المحاولة مجانًا

كرّر الاستدعاء بالقيمة نفسها في Idempotency-Key لتستعيد المهمة الأصلية. إعادة المحاولة لا تنتج نتيجة ثانية أبدًا.

التكامل كاملًا

ترويسة واحدة توثّق كل استدعاء. وكل استجابة محصورة بالعميل المالك للمفتاح، بما في ذلك المهام والأحداث والنتائج.

POST/api/v1/jobsإنشاء مهمة. Multipart: image وfeature وconsent. مع ترويسة Idempotency-Key.

GET/api/v1/jobs/: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%

مستوى الخدمة الذي نصمم ونشغّل ونقيس عليه، ويُتابع عند حافة الواجهة البرمجية لا عند أي مكوّن بعينه.

بنية تحتية عالمية

تُخدَم الطلبات من سعة موزعة، فلا يتحول الطلب المرتفع في منطقة واحدة إلى طابور على الجميع.

توسّع تلقائي

السعة تتبع الحمل. ارتفاع مفاجئ في حركة الطلبات يغيّر معدل المعالجة، لا شكل الواجهة ولا طريقة استدعاء شفرتك لها.

تجاوز الأعطال افتراضيًا

يمكن تفريغ أي مكوّن أو استبداله دون انقطاع تضطر إلى معالجته. العمل الجاري يُسترد ولا يضيع.

عزل لكل مفتاح

لا يرى المفتاح سوى مهامه وأحداثه ونتائجه. والاستجابات لا تكشف معرّفات داخلية أو تفاصيل بنية تحتية.

تكرار آمن بحكم العقد

ترويسة Idempotency-Key تجعل إعادة المحاولة آمنة. التكرار يعيد المهمة الأصلية بدل تنفيذ العمل مرتين.

طوابير معمّرة

العمل المقبول يُسجَّل قبل أن يبدأ ويُسترد بعد ذلك. وإعادة تشغيل أي جزء من المسار لا تُسقط مهمتك.

تحقق صارم من المدخلات

JPEG وPNG وWebP حتى 20 MiB، ويُتحقق منها بالمحتوى لا بالاسم أو بالنوع المعلن للملف فقط.

أسئلة شائعة

كيف أوثّق الطلبات؟

بترويسة X-API-Key في استدعاءات REST. أما في WebSocket فيُرسل المفتاح في أول رسالة بعد الاتصال، فلا يظهر في عنوان URL ولا في سجل وسيط.

ماذا يحدث إذا انتهت مهلة الطلب؟

كرّره بالقيمة نفسها في Idempotency-Key. تستعيد المهمة الأصلية ولا تُنتج نتيجة ثانية.

ما الصيغ والأحجام المقبولة؟

JPEG وPNG وWebP حتى 20 MiB. يُتحقق من محتوى الملف الفعلي، فيُرفض أي ملف أُعيدت تسميته أو وُسم بنوع خاطئ.

هل أستطيع تشغيل عدة أنماط على صورة واحدة؟

نعم. كل نمط مهمة مستقلة، فأرسل مهمة لكل نمط بالصورة المصدر نفسها وتابع كلًا منها على حدة.

هل يلزمني الاستعلام الدوري؟

لا. اتصل عبر WebSocket ووثّق نفسك لتستلم لقطة من مهامك الأخيرة يتبعها تحديثات مباشرة. ويبقى الاستعلام الدوري متاحًا كبديل.

هل تُفرض الموافقة؟

نعم. أي استدعاء إنشاء بدون consent=confirmed يُرفض عند حدود الواجهة البرمجية. فهو حقل إلزامي وإقرار تتحمل مسؤوليته.

كم التكلفة؟

التسعير يعتمد على الحجم ويُعرض مع الوصول. أخبرنا عن منصتك ومعدل الاستخدام المتوقع وسنعود إليك بالأرقام.

هل تحتفظون بصوري؟

تُحفظ الصور المصدر والنتائج في تخزين خاص وتُقدَّم للمفتاح الذي أنشأها فقط. وتُتفق شروط الاحتفاظ ضمن ترتيبات الوصول.

أخبرنا بما تبنيه

يُمنح الوصول لكل تكامل على حدة. صف منصتك والحجم المتوقع وكيف تجمع الموافقة من الأشخاص الظاهرين في الصور، وسنرسل لك بيانات الاعتماد وعنوان URL الأساسي.

لا تسجيل عام. ولا مفاتيح ذاتية الخدمة.

فلاتر للبالغينلتطبيقاتك