Bắt đầu nhanh

Bắt đầu sử dụng Traceline API trong 5 phút.

1. Đăng ký và nhận API key

Tạo tài khoản Traceline miễn phí, sau đó tạo API key từ bảng điều khiển.

Đăng ký

2. Gửi yêu cầu đầu tiên

Gửi ảnh lòng bàn tay đến API và nhận kết quả nhận diện. Ví dụ bằng các ngôn ngữ khác nhau:

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. Phân tích phản hồi

API trả về ảnh chồng, mặt nạ từng đường và thống kê cho mỗi đường được nhận diện.

{
  "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
    }
  }
}

Trường phản hồi

  • overlay — Ảnh Base64 với các đường phát hiện được vẽ lên ảnh bàn tay gốc.
  • masks — Mặt nạ nhị phân riêng cho mỗi đường phát hiện.
  • lines — Thống kê mỗi đường: số pixel và điểm tin cậy của mô hình.