واجهة برمجة تطبيقات المطور

تكشف واجهة برمجة تطبيقات HILIA عن علامات مائية سرية للتشغيل الآلي - ضع علامة على كل صورة في صورتك خط أنابيب النشر، أو مسح الصور الواردة لعلاماتك. إنها واجهة برمجة تطبيقات مدفوعة بشكل منفصل عن أداة الويب.

المصادقة

إنشاء وإدارة المفاتيح في hilia.tyo.com.au/keys (تسجيل الدخول مطلوب). أرسل المفتاح على كل طلب، في كلتا الحالتين:

Authorization: Bearer <your-api-key>

أو

X-Api-Key: <your-api-key>

يمكن أن تحمل المفاتيح أ الحصة الشهرية; تعرض صفحة المفاتيح الاستخدام كـ calls used / quota. يحصل على مفتاح ملغى أو غير معروف 401; يحصل على مفتاح على الحصة النسبية 429.

نقاط النهاية

جميع نقاط النهاية هي POST تحت https://hilia.tyo.com.au/api/v1/ وقبول multipart/form-data.

نقطة النهاية	الغرض	الحقول
`/api/v1/wm/embed`	تضمين معرف النص	`image`, `key`, `text` (≥32 بايت)، `strength` (اختياري)
`/api/v1/wm/extract`	استعادة معرف النص	`image`, `key`
`/api/v1/wm/detect`	تحقق من وجود علامة، بثقة	`image`, `key`

ال key المجال هنا هو الخاص بك مفتاح العلامة المائية (السر الذي تم قفل العلامة عليه) - يختلف عن مفتاح API الذي يقوم بتوثيق المكالمة.

مثال

curl -X POST https://hilia.tyo.com.au/api/v1/wm/embed \
  -H "Authorization: Bearer $HILIA_API_KEY" \
  -F "[email protected]" \
  -F "key=$WATERMARK_KEY" \
  -F "text=order-8841" \
  -o product-shot-marked.jpg

وبعد ذلك، قم بتأكيد أن الصورة تحمل علامتك:

curl -X POST https://hilia.tyo.com.au/api/v1/wm/detect \
  -H "Authorization: Bearer $HILIA_API_KEY" \
  -F "[email protected]" \
  -F "key=$WATERMARK_KEY"

الردود

تضمين تقوم بإرجاع بايتات الصورة المميزة (نفس نوع محتوى الإدخال).
استخراج و كشف إرجاع JSON - النص المضمن، أو التواجد بالإضافة إلى أ درجة الثقة.
الأخطاء: 401 مفتاح غير صالح · 429 تم تجاوز الحصة · 4xx من الخدمة السيئة المدخلات (تنسيق غير مدعوم، تحميل كبير الحجم).

Tip

دلالات العمليات - القوة، والقدرة على البقاء، والتضمين مقابل الكشف - هي كما هو الحال في أداة الويب: انظر العلامة المائية السرية.