개발자 API
HILIA API는 자동화를 위해 은밀한 워터마킹을 노출합니다. 파이프라인을 게시하거나 수신 이미지를 스캔하여 마크를 찾으세요. 유료 API 키입니다. 웹 도구와 별도로.
인증
키 생성 및 관리: hilia.tyo.com.au/keys (로그인 필요). 보내기 어느 쪽이든 모든 요청의 키:
Authorization: Bearer <your-api-key>
또는
X-Api-Key: <your-api-key>
열쇠는 월별 할당량; 키 페이지에 사용법이 다음과 같이 표시됩니다. calls used / quota.
취소되었거나 알 수 없는 키는 401; 할당량을 초과하는 키를 얻습니다. 429.
엔드포인트
모든 엔드포인트는 POST 아래 https://hilia.tyo.com.au/api/v1/ 그리고 받아들이다
multipart/form-data.
| 엔드포인트 | 목적 | 필드 |
|---|---|---|
/api/v1/wm/embed | 텍스트 ID 삽입 | image, key, text (32바이트 이하), strength (선택사항) |
/api/v1/wm/extract | 텍스트 ID를 복구하세요 | image, key |
/api/v1/wm/detect | 자신있게 마크를 확인하세요 | image, key |
는 key 여기 필드는 당신의 것입니다 워터마크 키 (마크가 잠겨 있는 비밀) —
호출을 인증하는 API 키와 다릅니다.
예
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
그런 다음 나중에 이미지에 표시가 있는지 확인하세요.
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"
응답
- 삽입 표시된 이미지 바이트를 반환합니다(입력과 동일한 콘텐츠 유형).
- 추출 그리고 감지 return JSON — 포함된 텍스트 또는 현재 상태와 자신감 점수.
- 오류:
401잘못된 키 ·429할당량 초과 ·4xx나쁜 서비스에서 입력(지원되지 않는 형식, 대용량 업로드).
Tip
작업의 의미(강도, 생존 가능성, 삽입 및 감지)는 웹 도구와 동일: 참조 은밀한 워터마킹.