API do desenvolvedor

A API HILIA expõe marcas d'água secretas para automação - marque todas as imagens em seu pipeline de publicação ou digitalize imagens recebidas em busca de suas marcas. É uma API paga com chave separadamente da ferramenta web.

Autenticação

Crie e gerencie chaves em hilia.tyo.com.au/keys (é necessário fazer login). Enviar a chave em cada solicitação, de qualquer maneira:

Authorization: Bearer <your-api-key>

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

As chaves podem carregar um cota mensal; a página de chaves mostra o uso como calls used / quota. Uma chave revogada ou desconhecida é 401; uma chave acima da cota é obtida 429.

Pontos finais

Todos os pontos finais são POST sob https://hilia.tyo.com.au/api/v1/ e aceitar multipart/form-data.

Ponto final	Objetivo	Campos
`/api/v1/wm/embed`	Incorporar um ID de texto	`image`, `key`, `text` (≤32 bytes), `strength` (opcional)
`/api/v1/wm/extract`	Recuperar o ID do texto	`image`, `key`
`/api/v1/wm/detect`	Verifique se há uma marca, com confiança	`image`, `key`

O key campo aqui é o seu chave de marca d'água (o segredo ao qual a marca está bloqueada) — distinto da chave de API que autentica a chamada.

Exemplo

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

Então, mais tarde, confirme se uma imagem carrega sua marca:

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"

Respostas

Incorporar retorna os bytes de imagem marcados (mesmo tipo de conteúdo da entrada).
Extrair e Detectar return JSON - o texto incorporado ou presença mais um pontuação de confiança.
Erros: 401 chave inválida · 429 cota excedida · 4xx do serviço para mal entradas (formato não suportado, upload superdimensionado).

Tip

A semântica das operações – força, capacidade de sobrevivência, Incorporação versus Detecção – é a igual à ferramenta web: veja Marca d’água oculta.