API per sviluppatori

L'API HILIA espone la filigrana nascosta per l'automazione: contrassegna ogni immagine nel tuo pipeline di pubblicazione o scansiona le immagini in arrivo per i tuoi segni. È un'API a pagamento con chiave separatamente dallo strumento web.

Autenticazione

Crea e gestisci le chiavi su hilia.tyo.com.au/keys (è richiesto l'accesso). Invia la chiave per ogni richiesta, in ogni caso:

Authorization: Bearer <your-api-key>

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

Le chiavi possono contenere a quota mensile; la pagina delle chiavi mostra l'utilizzo come calls used / quota. Viene ottenuta una chiave revocata o sconosciuta 401; viene ottenuta una chiave oltre la quota 429.

Endpoint

Tutti gli endpoint lo sono POST sotto https://hilia.tyo.com.au/api/v1/ e accettare multipart/form-data.

Punto finale	Scopo	Campi
`/api/v1/wm/embed`	Incorpora un ID di testo	`image`, `key`, `text` (≤32 byte), `strength` (facoltativo)
`/api/v1/wm/extract`	Recupera l'ID del testo	`image`, `key`
`/api/v1/wm/detect`	Controlla la presenza di un segno, con sicurezza	`image`, `key`

Il key il campo ecco il tuo chiave filigrana (il segreto su cui è bloccato il marchio) — distinto dalla chiave API che autentica la chiamata.

Esempio

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

Quindi, in seguito, conferma che un'immagine porta il tuo segno:

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"

Risposte

Incorpora restituisce i byte dell'immagine contrassegnati (stesso tipo di contenuto dell'input).
Estratto e Rileva return JSON: il testo incorporato o la presenza più a punteggio di fiducia.
Errori: 401 chiave non valida · 429 quota superata · 4xx dal servizio per male input (formato non supportato, caricamento di grandi dimensioni).

Tip

La semantica delle operazioni (forza, sopravvivenza, incorporamento vs rilevamento) è il come nello strumento web: vedi Filigrana nascosta.