API Reference

Runs

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Usage

Retrieve Usage For Run

runs.usage.retrieve(strrun_id) -> UsageRetrieveResponse

GET/v1/runs/{run_id}/usage

ModelsExpand Collapse

class UsageRetrieveResponse: …

completion_tokens: Optional[int]

completion_tokens_details: Optional[CompletionTokensDetails]

reasoning_tokens: Optional[int]

prompt_tokens: Optional[int]

prompt_tokens_details: Optional[PromptTokensDetails]

cache_creation_tokens: Optional[int]

cache_read_tokens: Optional[int]

cached_tokens: Optional[int]

total_tokens: Optional[int]