最初のAPIリクエストを送信

キーを作成し、API契約を選択してリクエストを送り、レスポンスを理解します。

最初のAPI呼び出し

ダッシュボードにログインし、プランまたはパックを選んでAPIキーを作成します。キーは1回のみ表示されます。ソースコードに含めず、シークレット管理ツールまたは環境変数に保存してください。

本番環境のベースURL： https://api.shinrai.innovius.io

curl https://api.shinrai.innovius.io/v1/analyze \
  -H "Authorization: Bearer $SHINRAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Emma Weber, emma@example.com","tier":"standard"}'

出力例（シミュレーション）

上のコマンドに対応する、シミュレーションによるJSON応答の抜粋です。実際の検出結果、置換値、残高は異なる場合があります。

{
  "results": [
    {
      "entities": [
        {
          "text": "Emma Weber",
          "type": "PERSON",
          "startIndex": 0,
          "endIndex": 10,
          "confidence": 0.98
        },
        {
          "text": "emma@example.com",
          "type": "EMAIL",
          "startIndex": 12,
          "endIndex": 28,
          "confidence": 1.0
        }
      ]
    }
  ],
  "usage": {
    "records": 1,
    "weighted_records": 1.0,
    "tier": "standard",
    "balance_after": 9999.0
  }
}

レスポンスには検出されたエンティティとオフセット、さらに usage.weighted_records と残高が含まれます。この短いStandardリクエストは1レコードを消費します。検出結果と置換名はモデルと入力によって異なります。

好みのクライアントを使用

curl https://api.shinrai.innovius.io/v1/analyze \
  -H "Authorization: Bearer $SHINRAI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"text":"Emma Weber, emma@example.com"}'

import os, requests

response = requests.post(
    "https://api.shinrai.innovius.io/v1/analyze",
    headers={"Authorization": f"Bearer {os.environ['SHINRAI_API_KEY']}"},
    json={"text": "Emma Weber, emma@example.com"},
)
response.raise_for_status()
print(response.json())

const response = await fetch("https://api.shinrai.innovius.io/v1/analyze", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.SHINRAI_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ text: "Emma Weber, emma@example.com" }),
});
if (!response.ok) throw new Error(`ShinrAI HTTP ${response.status}`);
console.log(await response.json());