メインコンテンツへスキップ
ID によって完了した生成の詳細なメタデータを取得します。このエンドポイントを使用して、過去のリクエストのコストと使用量を確認できます。

エンドポイント

GET /api/v1/generation

クエリパラメータ

パラメータ必須説明
idstringはいチャット補完レスポンスの id フィールドからの生成 ID

リクエスト例

curl "https://api.arouter.ai/api/v1/generation?id=gen-1775226820-719aea642d4b4d279c897793" \
  -H "Authorization: Bearer lr_live_xxxx"

レスポンス例

{
  "id": "gen-1775226820-719aea642d4b4d279c897793",
  "model": "anthropic/claude-sonnet-4.6",
  "provider": "Google",
  "created_at": "2026-04-03T12:00:00Z",
  "latency_ms": 1240,
  "usage": {
    "prompt_tokens": 14,
    "completion_tokens": 6,
    "total_tokens": 20,
    "cost": 0.000132,
    "is_byok": false,
    "prompt_tokens_details": {
      "cached_tokens": 0,
      "cache_write_tokens": 0
    },
    "completion_tokens_details": {
      "reasoning_tokens": 0
    },
    "cost_details": {
      "upstream_inference_cost": 0.000132,
      "upstream_inference_prompt_cost": 0.0000420,
      "upstream_inference_completions_cost": 0.000090
    }
  }
}

レスポンスフィールド

フィールド説明
idstring生成 ID
modelstringレスポンスを生成したモデル
providerstringリクエストを処理したプロバイダー
created_atstringISO 8601 タイムスタンプ
latency_msintegerリクエストの総レイテンシ(ミリ秒)
usage.prompt_tokensinteger入力トークン数
usage.completion_tokensinteger出力トークン数
usage.total_tokensinteger総トークン数
usage.costnumber総コスト(USD)
usage.is_byokbooleanユーザー提供の key が使用されたかどうか

注意事項

  • 生成メタデータは通常、リクエート完了後数秒以内に利用可能になります
  • 生成 ID はすべてのチャット補完レスポンスの id フィールドで返されます
  • 履歴データは 90 日間保持されます