ChatUsage Type | OpenRouter TypeScript SDK | OpenRouter

The TypeScript SDK and docs are currently in beta. Report issues on GitHub.

Token usage statistics

Example Usage

1 import { ChatUsage } from "@openrouter/sdk/models";
2 
3 let value: ChatUsage = {
4   completionTokens: 15,
5   promptTokens: 10,
6   totalTokens: 25,
7 };

Fields

Field	Type	Required	Description	Example
`completionTokens`	number	✔️	Number of tokens in the completion
`completionTokensDetails`	models.CompletionTokensDetails	➖	Detailed completion token usage
`cost`	number	➖	Cost of the completion
`costDetails`	models.CostDetails	➖	Breakdown of upstream inference costs	`{"upstream_inference_completions_cost": 0.0004,"upstream_inference_cost": null,"upstream_inference_prompt_cost": 0.0008}`
`isByok`	boolean	➖	Whether a request was made using a Bring Your Own Key configuration
`promptTokens`	number	✔️	Number of tokens in the prompt
`promptTokensDetails`	models.PromptTokensDetails	➖	Detailed prompt token usage
`totalTokens`	number	✔️	Total number of tokens