البدء السريع

ابدأ باستخدام واجهة Traceline البرمجية في 5 دقائق.

1. سجّل واحصل على مفتاح API

أنشئ حساب Traceline مجاني، ثم أنشئ مفتاح API من لوحة التحكم.

إنشاء حساب

2. أرسل طلبك الأول

أرسل صورة الكف إلى الواجهة البرمجية واستلم نتائج الكشف. أمثلة بلغات مختلفة:

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. حلّل الاستجابة

تُرجع الواجهة البرمجية صورة مركبة وأقنعة فردية وإحصائيات لكل خط مكتشف.

{
  "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 إحصائيات لكل خط: عدد البكسل ودرجة ثقة النموذج.