Skip to main content
POST
/
meters
Create meter
curl --request POST \
  --url https://api.lava.so/v1/meters \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "GPT-4 Usage",
  "rate_type": "fixed",
  "tier_type": "tokens_1m",
  "tiers": [
    {
      "start": "0",
      "rate": "0.50"
    }
  ],
  "meter_slug": "gpt4-usage"
}
'
{
  "meter_id": "<string>",
  "meter_slug": "<string>",
  "name": "<string>",
  "rate_type": "fixed",
  "token_basis": "input+output",
  "base_cost_payer": "merchant",
  "service_charge_payer": "merchant",
  "tiers": [
    {
      "start": 123,
      "rate": "<string>",
      "type": "tokens_1m"
    }
  ],
  "created_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication used for standard API calls. Format: 'Bearer YOUR_API_KEY'

Body

application/json
​
name
string
required

Display name of the meter

Example:

"GPT-4 Usage"

​
rate_type
enum<string>
required

Fee model: 'fixed' (fixed added cost per unit) or 'percentage' (percentage of base cost)

Available options:
fixed,
percentage
Example:

"fixed"

​
tier_type
enum<string>
required

Unit type for pricing tiers

Available options:
tokens_1m,
characters_1m,
minutes,
requests
Example:

"tokens_1m"

​
tiers
object[]
required

Pricing tiers (at least one required, must be in ascending start order)

​
meter_slug
string

Unique slug identifier for the meter. If not provided, one will be auto-generated.

Example:

"gpt4-usage"

Response

Meter created

​
meter_id
string
required

Unique identifier for the meter

​
meter_slug
string
required

Slug identifier for the meter used in forward token authentication

​
name
string
required

Display name of the meter

​
rate_type
enum<string>
required

Fee model: 'fixed' (fixed added cost) or 'percentage' (percentage of base cost)

Available options:
fixed,
percentage
​
token_basis
enum<string>
required

Token counting method: 'input+output' or 'output' only

Available options:
input+output,
output
​
base_cost_payer
enum<string>
required

Who pays the base AI provider cost

Available options:
merchant,
wallet
​
service_charge_payer
enum<string>
required

Who pays the Lava service charge

Available options:
merchant,
wallet
​
tiers
object[]
required

Pricing tiers for the meter

​
created_at
string<date-time>
required

When the meter was created