Meter slug
Unique identifier included in forward tokens to apply specific pricing
Fee model
Fixed cost per unit, percentage markup on provider cost, or both
Usage units
What you’re measuring — tokens, characters, seconds, or requests
Pricing tiers
Volume-based rate schedules that reward higher usage
Usage units
Usage units define what metric drives pricing. Set via the field:| Unit type | Label | Rate basis | Example use case |
|---|---|---|---|
tokens_1m | Tokens | $ per 1M tokens | LLM APIs |
characters_1m | Characters | $ per 1M characters | Text-to-speech |
minutes | Seconds | $ per minute | Audio processing, voice calls |
requests | Requests | $ per request | Image generation, API calls |
Fee models
The field determines how fees are calculated.- Fixed
- Percentage
Charge a flat amount per usage unit, regardless of the provider’s cost:Example: $2.00 per 1M tokens with
input+output basis- 500 input tokens + 200 output tokens = 700 tokens
- Fee: $2.00 × 700 / 1,000,000 = $0.0014
Pricing tiers
Tiers let you offer volume-based pricing. Each tier defines a usage threshold and rate. As cumulative usage increases, later tiers apply.At least one tier is required. The first tier must start at
0, and tier starts must be in ascending order.Example: Three-tier token pricing
Example: Three-tier token pricing
| Tier | Start | Rate (per 1M tokens) |
|---|---|---|
| 1 | 0 | $5.00 |
| 2 | 1,000,000 | $3.00 |
| 3 | 10,000,000 | $1.00 |
- First 1M at $5.00/1M = $5.00
- Next 4M at $3.00/1M = $12.00
- Total fee: $17.00