Query API Key Billing

curl --request GET \
  --url 'https://api.novita.ai/openapi/v1/billing/apikey/bill/list?cycleType=Day&category=llm&startTime=1767225600&endTime=1769817599' \
  --header 'Authorization: Bearer <API_KEY>'

{
  "bills": [
    {
      "userId": "<string>",
      "startTime": "1767225600",
      "endTime": "1767311999",
      "billingMethod": 1,
      "productName": "<string>",
      "category": "llm",
      "ownerID": "<api_key_id>",
      "billNum0": "1000",
      "billNum1": "500",
      "basePrice0": "0",
      "basePrice1": "0",
      "discountPrice0": "0",
      "discountPrice1": "0",
      "amount": "10000",
      "voucherAmount": "0",
      "payAmount": "10000",
      "payAmountDisplay": 1,
      "pricePrecision": 1,
      "productId": "<string>",
      "apikeyName": "<string>",
      "apikeyMask": "sk-****"
    }
  ]
}

GET

openapi

billing

apikey

bill

list

curl --request GET \
  --url 'https://api.novita.ai/openapi/v1/billing/apikey/bill/list?cycleType=Day&category=llm&startTime=1767225600&endTime=1769817599' \
  --header 'Authorization: Bearer <API_KEY>'

{
  "bills": [
    {
      "userId": "<string>",
      "startTime": "1767225600",
      "endTime": "1767311999",
      "billingMethod": 1,
      "productName": "<string>",
      "category": "llm",
      "ownerID": "<api_key_id>",
      "billNum0": "1000",
      "billNum1": "500",
      "basePrice0": "0",
      "basePrice1": "0",
      "discountPrice0": "0",
      "discountPrice1": "0",
      "amount": "10000",
      "voucherAmount": "0",
      "payAmount": "10000",
      "payAmountDisplay": 1,
      "pricePrecision": 1,
      "productId": "<string>",
      "apikeyName": "<string>",
      "apikeyMask": "sk-****"
    }
  ]
}

Request Headers

string

required

Enum: application/json

string

required

Bearer authentication format, for example: Bearer {{API Key}}.

Query Parameters

string

required

Billing granularity. Options: Day, Week, Month.

string

Product type or business category. Common values: llm, gen_api, web_search.

string

Product name. Supports fuzzy matching.

integer

required

Query start time, Unix timestamp in seconds (int64). Must be greater than or equal to 2026-01-01 00:00:00.

integer

required

Query end time, Unix timestamp in seconds (int64). Must be greater than startTime.

This endpoint only supports data after 2026-01-01 00:00:00. It does not support pagination. Keep each query range within 31 days. For longer ranges, split requests by calendar month or calendar week.

Response Parameters

object[]

required

API Key bill list.

Hide properties

string

required

User account ID.

string

required

Bill start time, Unix timestamp in seconds.

string

required

Bill end time, Unix timestamp in seconds.

int32

required

Billing method: 1 (pay-as-you-go), 2 (subscription).

string

required

Product name.

string

required

Product type or subcategory.

string

required

API Key ID.

string

required

API Key name.

string

required

Masked API Key.

string

required

Product ID.

string

required

Usage field 0. For llm, this usually means input price per 1M tokens; GPU: price per card per hour; storage: price per GB per day.

string

required

Usage field 1. For llm, this usually means output tokens.

string

required

Usage field 2. For llm, this usually means read cache price per 1M tokens.

string

required

Usage field 3. For llm, this usually means write 5-minute cache price per 1M tokens.

string

required

Usage field 4. For llm, this usually means reasoning token price per 1M tokens.

string

required

Usage field 5. For llm, this usually means write 1-hour cache price per 1M tokens.

string

Usage field 6.

string

Usage field 7.

string

Usage field 8.

string

Usage field 9.

string

Usage field 10.

string

Usage field 11.

string

Usage field 12.

string

Usage field 13.

string

Usage field 14.

string

Usage field 15.

string

required

Original price field 0. For llm: input price per 1M tokens; GPU: price per card per hour; storage: price per GB per day.

string

required

Original price field 1. For llm, output price per 1M tokens.

string

required

Original price field 2. For llm, read cache price per 1M tokens.

string

required

Original price field 3. For llm, write 5-minute cache price per 1M tokens.

string

required

Original price field 4. For llm, reasoning token price per 1M tokens.

string

required

Original price field 5. For llm, write 1-hour cache price per 1M tokens.

string

required

Discounted price field 0. For llm, discounted input token price.

string

required

Discounted price field 1. For llm, discounted output token price.

string

required

Discounted price field 2. For llm, discounted read cache price per 1M tokens.

string

required

Discounted price field 3. For llm, discounted write 5-minute cache price per 1M tokens.

string

required

Discounted price field 4. For llm, discounted reasoning token price per 1M tokens.

string

required

Discounted price field 5. For llm, discounted write 1-hour cache price per 1M tokens.

string

required

Total amount, unit is 1/10000 USD.

string

required

Amount deducted by vouchers, unit is 1/10000 USD.

string

required

Cash payment amount, unit is 1/10000 USD.

float

required

Display value of cash payment amount, in USD.

int32

required

Price precision. Unit price (USD) = unit price / 10000 / pricePrecision.

string

LLM series.

string

Request count.

object

Multimodal model billing details.

object

Tiered billing configuration.

curl --request GET \
  --url 'https://api.novita.ai/openapi/v1/billing/apikey/bill/list?cycleType=Day&category=llm&startTime=1767225600&endTime=1769817599' \
  --header 'Authorization: Bearer <API_KEY>'

{
  "bills": [
    {
      "userId": "<string>",
      "startTime": "1767225600",
      "endTime": "1767311999",
      "billingMethod": 1,
      "productName": "<string>",
      "category": "llm",
      "ownerID": "<api_key_id>",
      "billNum0": "1000",
      "billNum1": "500",
      "basePrice0": "0",
      "basePrice1": "0",
      "discountPrice0": "0",
      "discountPrice1": "0",
      "amount": "10000",
      "voucherAmount": "0",
      "payAmount": "10000",
      "payAmountDisplay": 1,
      "pricePrecision": 1,
      "productId": "<string>",
      "apikeyName": "<string>",
      "apikeyMask": "sk-****"
    }
  ]
}

Last modified on June 2, 2026

Query Fixed-term Billing Query Transactions

⌘I

Overview

Basic

Quota

Team Budget

API Key Model Access

Model APIs

GPUs

Request Headers

Query Parameters

Response Parameters

​Request Headers

​Query Parameters

​Response Parameters

Request Headers

Query Parameters

Response Parameters