跳轉到主要內容
透過 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輸入 Token 數
usage.completion_tokensinteger輸出 Token 數
usage.total_tokensinteger總 Token 數
usage.costnumber總費用(USD)
usage.is_byokboolean是否使用了使用者提供的 key

說明

  • 生成元數據通常在請求完成後數秒內即可取得
  • 生成 ID 在每個聊天補全回應的 id 欄位中回傳
  • 歷史資料保留 90 天