Read and export usage

Understand billed costs, tokens, dates, and request history.

Choose a date range

Usage figures are reported by the account service. Recent requests may take time to appear; refreshing does not create usage.

  1. Open Usage and choose the start and end dates.
  2. Read the timezone beside the range. Trends are grouped hourly or daily according to the selected period.
  3. Wait for Updating to finish before exporting or interpreting the new range.

Understand the figures

Billed cost is the amount charged for the recorded usage. Token counts preserve the upstream input, output, cache-read and cache-creation categories. Cache hit rate and latency describe request behavior; they are not additional charges.

Model, group and endpoint distributions summarize the selected period. Request-history filters narrow the table independently of those range-wide charts.

Inspect and export request history

The console does not currently offer alert rules, webhook notifications, or a full-history CSV download.

  1. Filter the request table by model, request type or billing mode.
  2. Check the key name, token/cache counts, first-token latency, duration and billed cost.
  3. Use Export current page to download only the rows on the displayed page. Navigate to another page to export those rows separately.

Verify the answer and billed usage

  1. Check the returned assistant message. An error response is not a successful answer.
  2. Open Usage and select a date range that includes the request. Check the displayed timezone.
  3. Find the request by its model and key name. Review input/output and cache tokens, latency, and actual billed cost.
  4. If a request is interrupted or times out, check Usage before repeating it. A retry is a separate request and can incur another charge.

Troubleshooting

For support, include the time, model, request ID if supplied, and error status. Never send your API key, session cookie, or password. Error details vary by endpoint; use the returned status and message rather than assuming one universal error shape.

  1. Authentication failed: copy the complete key again, remove extra whitespace, and check its active status and expiry. Custom keys do not necessarily begin with sk-.
  2. Model unavailable or access denied: verify the selected key’s group and available model list. Check IP restrictions and provider route availability.
  3. Quota or balance exhausted: inspect the key’s quota and rolling USD limits, then the account balance or subscription usage. Changing a key quota does not fund the account.
  4. Request URL not found: use /v1 as the SDK base URL, and /v1/chat/completions for a direct Chat Completions request. Use the protocol supported by your chosen model.
  5. Rate-limited or temporarily unavailable: wait before trying again and check service status. Avoid repeatedly resending a request that may already have been processed.
  6. Stream stopped: keep the partial answer and check Usage. Start another request only when you want to retry.
  7. Playground with an IP-restricted key: the gateway sees the console server’s connection. A key that works from your application may not permit that connection. Keep the restriction unless you intend to change it.