API de développeur

L'API HILIA expose le filigrane caché pour l'automatisation : marquez chaque image de votre pipeline de publication ou numérisez les images entrantes pour vos marques. C'est une API payante séparément de l’outil Web.

Authentification

Créez et gérez des clés sur hilia.tyo.com.au/keys (Connexion requise). Envoyer la clé à chaque demande, dans tous les cas :

Authorization: Bearer <your-api-key>

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

Les clés peuvent porter un quota mensuel; la page des clés montre l'utilisation comme calls used / quota. Une clé révoquée ou inconnue obtient 401; une clé sur quota obtient 429.

Points de terminaison

Tous les points de terminaison sont POST sous https://hilia.tyo.com.au/api/v1/ et accepter multipart/form-data.

Point de terminaison	Objectif	Champs
`/api/v1/wm/embed`	Intégrer un identifiant texte	`image`, `key`, `text` (≤32 octets), `strength` (facultatif)
`/api/v1/wm/extract`	Récupérer l'identifiant du texte	`image`, `key`
`/api/v1/wm/detect`	Recherchez une marque en toute confiance	`image`, `key`

Le key champ, voici votre clé de filigrane (le secret sur lequel la marque est verrouillée) — distinct de la clé API qui authentifie l’appel.

Exemple

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

Puis, plus tard, confirmez qu'une image porte votre marque :

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"

Réponses

Intégrer renvoie les octets d'image marqués (même type de contenu que l'entrée).
Extrait et Détecter return JSON - le texte intégré, ou la présence plus un score de confiance.
Erreurs : 401 clé invalide · 429 quota dépassé · 4xx du service pour le mal entrées (format non pris en charge, téléchargement surdimensionné).

Tip

La sémantique des opérations – force, capacité de survie, Embed vs Detect – est la idem que dans l'outil web : voir Filigrane caché.