tokens-to-dollars Service

Purpose

Convert LLM token usage into USD using provider/model pricing tables. This service preserves provider-native usage keys. It does not force cross-provider normalization.

API Endpoint

POST /api/v01/calculate.php

No authentication header is required.

Request JSON

{
  "provider": "openai",
  "model": "gpt-5.6-terra",
  "usage": {
    "prompt_tokens": 2620,
    "completion_tokens": 220,
    "total_tokens": 2840,
    "prompt_tokens_details": {
      "cached_tokens": 1792,
      "audio_tokens": 0
    }
  }
}

Success Response (example)

{
  "success": true,
  "provider": "openai",
  "model": "gpt-5.6-terra",
  "currency": "USD",
  "cost_usd": 0.010298,
  "usage_received": {
    "prompt_tokens": 2620,
    "completion_tokens": 220,
    "total_tokens": 2840,
    "prompt_tokens_details": {
      "cached_tokens": 1792,
      "audio_tokens": 0
    }
  },
  "usage_normalized": {
    "input_tokens": 2620,
    "cached_input_tokens": 1792,
    "output_tokens": 220
  },
  "ignored_usage_keys": [
    "prompt_tokens",
    "completion_tokens",
    "total_tokens"
  ],
  "unmatched_usage_keys": [],
  "breakdown": {
    "input_tokens": {
      "tokens": 2620,
      "usd_per_million_tokens": 2.5,
      "usd": 0.00655
    }
  },
  "pricing_entry": {
    "effective_from_utc": "2026-07-23T00:00:00Z",
    "source_url": "https://developers.openai.com/api/docs/pricing"
  }
}