API Reference

TokenSense is a transparent proxy — you call it the same way you'd call your AI provider directly. This page covers the endpoint format, authentication, and code examples.

Base URL

Your TokenSense endpoint is shown on your dashboard home page. All requests go through this URL:

Replace /chat/completions with the appropriate path for your provider and model type.

Supported endpoints

The most common endpoint is /v1/chat/completions — it accepts OpenAI-format requests and automatically translates for Anthropic, Gemini, xAI, and Mistral. Use the native endpoints (/v1/messages, /v1beta/models/...) when you need provider-specific features that don't map to the OpenAI format.

Authentication

Every request must include a Bearer token with your TokenSense API key:

Your TokenSense API key is not your provider key. You add provider keys separately in Settings → Providers. TokenSense uses them to forward requests on your behalf.

Supported formats

TokenSense detects the provider from the model name in your request and routes automatically. You can send requests in any of these formats:

• OpenAI format — /v1/chat/completions with any model. TokenSense translates automatically for all providers.
• Native Anthropic — /v1/messages for the Anthropic Messages API (passthrough, no translation).
• Native Gemini — /v1beta/models/{model}:{action} for the Gemini API (passthrough, no translation).

xAI and Mistral are natively OpenAI-compatible — requests pass through directly via /v1/chat/completions with zero translation.

Attribution headers

Add these optional headers to track costs per workflow and step in your dashboard:

Response format

TokenSense returns the exact same response as the upstream provider. Your code doesn't need any changes to parse the response — it's identical to calling the provider directly.

Code examples

cURL

curl https://api.tokensense.io/chat/completions \
  -H "Authorization: Bearer YOUR_TOKENSENSE_KEY" \
  -H "Content-Type: application/json" \
  -H "x-workflow-tag: my-workflow" \
  -d '{
    "model": "gpt-5-mini",
    "messages": [
      {"role": "user", "content": "Hello, world!"}
    ]
  }'

Python

import requests

response = requests.post(
    "https://api.tokensense.io/chat/completions",
    headers={
        "Authorization": "Bearer YOUR_TOKENSENSE_KEY",
        "Content-Type": "application/json",
        "x-workflow-tag": "my-workflow",
    },
    json={
        "model": "gpt-5-mini",
        "messages": [
            {"role": "user", "content": "Hello, world!"}
        ],
    },
)

print(response.json())

Node.js

const response = await fetch(
  "https://api.tokensense.io/chat/completions",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_TOKENSENSE_KEY",
      "Content-Type": "application/json",
      "x-workflow-tag": "my-workflow",
    },
    body: JSON.stringify({
      model: "gpt-5-mini",
      messages: [
        { role: "user", content: "Hello, world!" },
      ],
    }),
  }
);

const data = await response.json();
console.log(data);

Error responses

See the full Error Codes reference for detailed troubleshooting.

Related

• Make & Zapier Setup
• n8n Setup Guide
• Cost Attribution
• Supported Providers