API Pengembang

HILIA API memperlihatkan watermarking terselubung untuk otomatisasi — tandai setiap gambar di gambar Anda saluran penerbitan, atau pindai gambar yang masuk untuk mencari tanda Anda. Ini adalah kunci API berbayar terpisah dari alat web.

Otentikasi

Membuat dan mengelola kunci di hilia.tyo.com.au/keys (perlu masuk). Kirim kunci pada setiap permintaan, apa pun caranya:

Authorization: Bearer <your-api-key>

atau

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

Kunci dapat membawa a kuota bulanan; halaman kunci menunjukkan penggunaan sebagai calls used / quota. Kunci yang dicabut atau tidak diketahui didapat 401; kunci melebihi kuota yang didapat 429.

Titik akhir

Semua titik akhir adalah POST di bawah https://hilia.tyo.com.au/api/v1/ dan menerima multipart/form-data.

Itu key bidang ini milikmu kunci tanda air (rahasia tempat tanda itu dikunci) — berbeda dari kunci API yang mengautentikasi panggilan.

Contoh

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

Lalu, nanti, konfirmasikan bahwa gambar tersebut membawa tanda Anda:

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"

Tanggapan

• Sematkan mengembalikan byte gambar yang ditandai (tipe konten yang sama dengan input).
• Ekstrak dan Deteksi return JSON — teks yang disematkan, atau kehadiran ditambah a skor kepercayaan diri.
• Kesalahan: 401 kunci tidak valid · 429 kuota terlampaui · 4xx dari layanan untuk buruk masukan (format tidak didukung, unggahan terlalu besar).