API 端点

浏览所有可用端点及其参数。

基础URL

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

/v1/palm/analyze

分析手掌图像，检测感情线、智慧线和生命线。这是Traceline API的主要端点。

请求标头

标头必需Description
X-API-Key是您的Traceline API密钥
Content-Type是必须为application/json

请求体

{
  "image": "<base64-encoded-image>"
}
  • image (必需) — Base64编码的JPEG或PNG图像。最大大小：5MB。

请求示例

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

响应

成功响应返回包含分析结果的JSON对象。

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

响应字段

  • id — 唯一请求标识符
  • object — 始终为"palm.analysis"
  • created — 请求的Unix时间戳
  • model — 用于分析的模型版本
  • results.overlay — 带有检测线条的Base64编码JPEG
  • results.masks — 每条检测线的单独PNG掩码
  • results.stats — 每条线的检测统计（覆盖率和检测标志）
  • usage — 当前方案和配额信息

响应标头

  • X-Monthly-Quota-Limit — 您的月度总配额
  • X-Monthly-Quota-Remaining — 本月剩余请求数
GET

/v1/palm/health

检查API服务是否运行。无需认证。

请求示例

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

响应

{
  "status": "ok"
}