APIエンドポイント

利用可能なすべてのエンドポイントとパラメータを確認します。

ベースURL

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

/v1/palm/analyze

手のひら画像を分析し、感情線、知能線、生命線を検出します。Traceline APIの主要エンドポイントです。

リクエストヘッダー

ヘッダー必須Description
X-API-KeyはいTraclineの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"
}