クイックスタート

Traceline APIを5分で使い始めましょう。

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 — 各線の統計情報：ピクセル数とモデルの信頼度スコア。