API 엔드포인트

사용 가능한 모든 엔드포인트와 매개변수를 확인하세요.

기본 URL

https://api.trace-line.site/v1
POST

/v1/palm/analyze

손바닥 이미지를 분석하고 감정선, 두뇌선, 생명선을 감지합니다.

요청 헤더

헤더필수Description
X-API-Key예Traceline API 키
Content-Type예application/json이어야 합니다

요청 본문

{
  "image": "<base64-encoded-image>"
}
  • image (필수) — Base64 인코딩된 JPEG 또는 PNG 이미지. 최대 크기: 5MB.

요청 예시

curl -X POST https://api.trace-line.site/v1/palm/analyze \
  -H "X-API-Key: trl_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"image": "<base64-encoded-image>"}'

응답

성공 응답은 분석 결과를 포함하는 JSON 객체를 반환합니다.

{
  "id": "req_abc123",
  "object": "palm.analysis",
  "created": 1700000000,
  "model": "traceline-v1",
  "results": {
    "overlay": "<base64-overlay-image>",
    "masks": {
      "heart": "<base64-mask>",
      "head": "<base64-mask>",
      "life": "<base64-mask>"
    },
    "stats": {
      "heart": {
        "pixels": 1842,
        "confidence": 0.94
      },
      "head": {
        "pixels": 1567,
        "confidence": 0.91
      },
      "life": {
        "pixels": 2103,
        "confidence": 0.96
      }
    }
  },
  "usage": {
    "requests_used": 42,
    "requests_limit": 100
  }
}

응답 필드

  • id — 고유 요청 식별자
  • object — 항상 "palm.analysis"
  • created — 요청의 Unix 타임스탬프
  • model — 분석에 사용된 모델 버전
  • results.overlay — 감지된 선이 그려진 Base64 인코딩 JPEG
  • results.masks — 각 감지된 선의 개별 PNG 마스크
  • results.stats — 각 선의 감지 통계 (커버리지 비율 및 감지 플래그)
  • usage — 현재 플랜 및 쿼터 정보

응답 헤더

  • X-Monthly-Quota-Limit — 월간 총 쿼터
  • X-Monthly-Quota-Remaining — 이번 달 남은 요청 수
GET

/v1/palm/health

API 서비스가 실행 중인지 확인합니다. 인증 불필요.

요청 예시

curl https://api.trace-line.site/v1/palm/health

응답

{
  "status": "ok"
}