Geliştirici API'si

HILIA API, otomasyon için gizli filigranlamayı ortaya çıkarır; dosyanızdaki her görüntüyü işaretleyin boru hattını yayınlayın veya işaretleriniz için gelen görüntüleri tarayın. Ücretli bir API anahtarlıdır web aracından ayrı olarak.

Kimlik doğrulama

Anahtarları şu adreste oluşturun ve yönetin: hilia.tyo.com.au/keys (oturum açmanız gerekir). Gönder Her iki durumda da her istekte anahtar:

Authorization: Bearer <your-api-key>

veya

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

Anahtarlar bir taşıyabilir aylık kota; anahtarlar sayfası kullanımı şu şekilde gösterir: calls used / quota. İptal edilen veya bilinmeyen bir anahtar 401; kotayı aşan bir anahtar elde edilir 429.

Uç noktalar

Tüm uç noktalar POST altında https://hilia.tyo.com.au/api/v1/ ve kabul et multipart/form-data.

Uç nokta	Amaç	Alanlar
`/api/v1/wm/embed`	Metin kimliği yerleştirme	`image`, `key`, `text` (≤32 bayt), `strength` (isteğe bağlı)
`/api/v1/wm/extract`	Metin kimliğini kurtar	`image`, `key`
`/api/v1/wm/detect`	Güvenle bir işaret olup olmadığını kontrol edin	`image`, `key`

key buradaki alan senin filigran anahtarı (işaretin kilitlendiği sır) — çağrının kimliğini doğrulayan API anahtarından farklıdır.

Örnek

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

Daha sonra bir görselin sizin işaretinizi taşıdığını doğrulayın:

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"

Yanıtlar

Göm işaretli görüntü baytlarını döndürür (girişle aynı içerik türü).
Çıkart ve Algıla JSON'u döndür — gömülü metin veya iletişim durumu artı bir güven puanı.
Hatalar: 401 geçersiz anahtar · 429 kota aşıldı · 4xx kötü hizmetten girişler (desteklenmeyen format, büyük boyutlu yükleme).

Tip

Operasyonların semantiği (güç, hayatta kalma, Yerleştirme ve Algılama) web aracındakiyle aynı: bkz. Gizli filigran.