Skip to main content
The TypeScript SDK and docs are currently in beta. Report issues on GitHub.
Token usage statistics

Example Usage

import { ChatUsage } from "@openrouter/sdk/models";

let value: ChatUsage = {
  completionTokens: 15,
  promptTokens: 10,
  totalTokens: 25,
};

Fields

FieldTypeRequiredDescriptionExample
completionTokensnumber:heavy_check_mark:Number of tokens in the completion
completionTokensDetailsmodels.CompletionTokensDetails:heavy_minus_sign:Detailed completion token usage
costnumber:heavy_minus_sign:Cost of the completion
costDetailsmodels.CostDetails:heavy_minus_sign:Breakdown of upstream inference costs{"upstream_inference_completions_cost": 0.0004,"upstream_inference_cost": null,"upstream_inference_prompt_cost": 0.0008}
isByokboolean:heavy_minus_sign:Whether a request was made using a Bring Your Own Key configuration
promptTokensnumber:heavy_check_mark:Number of tokens in the prompt
promptTokensDetailsmodels.PromptTokensDetails:heavy_minus_sign:Detailed prompt token usage
totalTokensnumber:heavy_check_mark:Total number of tokens