빠른 시작

5분 만에 Traceline API를 시작하세요.

1. 가입하고 API 키 받기

무료 Traceline 계정을 만들고 대시보드에서 API 키를 생성하세요.

회원가입

2. 첫 번째 요청 보내기

손바닥 이미지를 API에 전송하고 감지 결과를 받으세요. 다양한 언어의 예시:

cURL

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

Python

import requests
import base64

# Read and encode the image
with open("palm.jpg", "rb") as f:
    image_b64 = base64.b64encode(f.read()).decode()

response = requests.post(
    "https://api.trace-line.site/v1/palm/analyze",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={"image": image_b64},
)

data = response.json()
print(data["lines"])
# {'heart': {'pixels': 1842, 'confidence': 0.94}, ...}

JavaScript

import { readFileSync } from "fs";

const image = readFileSync("palm.jpg").toString("base64");

const res = await fetch(
  "https://api.trace-line.site/v1/palm/analyze",
  {
    method: "POST",
    headers: {
      "X-API-Key": "YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ image }),
  }
);

const data = await res.json();
console.log(data.lines);
// { heart: { pixels: 1842, confidence: 0.94 }, ... }

3. 응답 분석

API는 오버레이 이미지, 개별 선 마스크, 각 감지된 선의 통계를 반환합니다.

{
  "overlay": "<base64-overlay-image>",
  "masks": {
    "heart": "<base64-mask>",
    "head": "<base64-mask>",
    "life": "<base64-mask>"
  },
  "lines": {
    "heart": {
      "pixels": 1842,
      "confidence": 0.94
    },
    "head": {
      "pixels": 1567,
      "confidence": 0.91
    },
    "life": {
      "pixels": 2103,
      "confidence": 0.96
    }
  }
}

응답 필드

  • overlay — 감지된 선이 그려진 Base64 인코딩 오버레이 이미지.
  • masks — 각 감지된 선의 개별 바이너리 마스크 (감정선, 두뇌선, 생명선).
  • lines — 각 선의 통계: 픽셀 수와 모델 신뢰도 점수.