Endpoint API

Khám phá tất cả endpoint và tham số.

URL gốc

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

POST

/v1/palm/analyze

Phân tích ảnh bàn tay và phát hiện đường tình cảm, trí tuệ và sinh mệnh.

Header yêu cầu

Header	Bắt buộc	Description
`X-API-Key`	Có	API key Traceline của bạn
`Content-Type`	Có	Phải là application/json

Nội dung yêu cầu

{
  "image": "<base64-encoded-image>"
}

image (bắt buộc) — Ảnh JPEG hoặc PNG mã hóa Base64. Kích thước tối đa: 5MB.

Ví dụ yêu cầu

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

Phản hồi

Phản hồi thành công trả về đối tượng JSON với kết quả phân tích.

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

Trường phản hồi

id — Mã nhận dạng yêu cầu duy nhất
object — Luôn là "palm.analysis"
created — Unix timestamp của yêu cầu
model — Phiên bản mô hình được sử dụng
results.overlay — JPEG Base64 với các đường phát hiện
results.masks — Mặt nạ PNG riêng cho mỗi đường
results.stats — Thống kê phát hiện mỗi đường
usage — Thông tin gói và hạn mức hiện tại

Header phản hồi

X-Monthly-Quota-Limit — Tổng hạn mức hàng tháng
X-Monthly-Quota-Remaining — Yêu cầu còn lại tháng này

GET

/v1/palm/health

Kiểm tra dịch vụ API đang chạy. Không cần xác thực.

Ví dụ yêu cầu

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

Phản hồi

{
  "status": "ok"
}