Ontwikkelaar-API

De HILIA API maakt verborgen watermerken zichtbaar voor automatisering: markeer elke afbeelding in uw publicatiepijplijn of scan binnenkomende afbeeldingen op uw markeringen. Het is een betaalde API-sleutel afzonderlijk van de webtool.

Authenticatie

Sleutels maken en beheren op hilia.tyo.com.au/keys (aanmelding vereist). Verzenden de sleutel bij elk verzoek, hoe dan ook:

Authorization: Bearer <your-api-key>

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

Sleutels kunnen een maandelijks quotum; de toetsenpagina toont het gebruik als calls used / quota. Een ingetrokken of onbekende sleutel krijgt 401; een sleutel boven het quotum krijgt 429.

Eindpunten

Alle eindpunten zijn dat POST onder https://hilia.tyo.com.au/api/v1/ en accepteren multipart/form-data.

Eindpunt	Doel	Velden
`/api/v1/wm/embed`	Sluit een tekst-ID in	`image`, `key`, `text` (≤32 bytes), `strength` (optioneel)
`/api/v1/wm/extract`	Herstel de tekst-ID	`image`, `key`
`/api/v1/wm/detect`	Controleer met vertrouwen of er een merkteken is	`image`, `key`

De key veld hier is jouw watermerk sleutel (het geheim waaraan het merkteken is gekoppeld) — verschillend van de API-sleutel die de oproep verifieert.

Voorbeeld

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

Bevestig vervolgens later dat een afbeelding uw merkteken draagt:

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"

Reacties

Insluiten retourneert de gemarkeerde afbeeldingsbytes (hetzelfde inhoudstype als de invoer).
Uittreksel en Detecteer return JSON — de ingesloten tekst, of aanwezigheid plus a vertrouwensscore.
Fouten: 401 ongeldige sleutel · 429 quotum overschreden · 4xx van de dienst ten kwade invoer (niet-ondersteund formaat, te grote upload).

Tip

De semantiek van de operaties – kracht, overlevingskansen, Embed vs Detect – is de hetzelfde als in de webtool: zie Verborgen watermerken.