Token Usage & Response Headers

How tokens are used in API calls, and how to track their usage

Usage & Pricing

The API operates on a credit usage basis. Your subscription includes X million tokens. Each API call consumes tokens.

  • API Request:

  • Vision AI Request:

  • Text AI Request:

  • Chat Message Request:

Example Usage Tracking Headers Returned with Each API Response:

  • X-Budget-Cap: 12,000,000 (total tokens available in the current period)

  • X-Period-Usage: 494,188 (tokens used in the current period)

  • X-Request-Usage: 634 (tokens used by the current request)

Monitor these headers to track your API usage and avoid exceeding your token limit.

Dashboard

You can also see your total usage in your accounts portal dashboard for this product. This will display usage, % used and free, etc.

The dashboard also contains a section to show your usage in a few different breakdowns. It allows you to see number (total) and token usage (total) for requests of certain types (ai chat, api call, vision ai tools, etc) or by the API path that made the request (grouped after a certain level of path-specificity).

Last updated