Query API Key Billing - Documentation

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

Content-Type

string

required

Enum: application/json

Authorization

string

required

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

Query Parameters

cycleType

string

required

Billing granularity. Options: Day, Week, Month.

Response Parameters

bills

object[]

required

API Key bill list.

Hide properties

userId

string

required

User account ID.

startTime

string

required

Bill start time, Unix timestamp in seconds.

endTime

string

required

Bill end time, Unix timestamp in seconds.

billingMethod

int32

required

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

productName

string

required

Product name.

category

string

required

Product type or subcategory.

ownerID

string

required

API Key ID.

apikeyName

string

required

API Key name.

apikeyMask

string

required

Masked API Key.

productId

string

required

Product ID.

billNum0

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.

billNum1

string

required

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

billNum2

string

required

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

billNum3

string

required

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

billNum4

string

required

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

billNum5

string

required

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

billNum6

string

Usage field 6.

billNum7

string

Usage field 7.

billNum8

string

Usage field 8.

billNum9

string

Usage field 9.

billNum10

string

Usage field 10.

billNum11

string

Usage field 11.

billNum12

string

Usage field 12.

billNum13

string

Usage field 13.

billNum14

string

Usage field 14.

billNum15

string

Usage field 15.

basePrice0

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.

basePrice1

string

required

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

basePrice2

string

required

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

basePrice3

string

required

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

basePrice4

string

required

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

basePrice5

string

required

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

discountPrice0

string

required

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

discountPrice1

string

required

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

discountPrice2

string

required

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

discountPrice3

string

required

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

discountPrice4

string

required

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

discountPrice5

string

required

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

amount

string

required

Total amount, unit is 1/10000 USD.

voucherAmount

string

required

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

payAmount

string

required

Cash payment amount, unit is 1/10000 USD.

payAmountDisplay

float

required

Display value of cash payment amount, in USD.

pricePrecision

int32

required

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

llmSeries

string

LLM series.

requestCount

string

Request count.

multimodalPricing

object

Multimodal model billing details.

tieredConfig

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 12, 2026

Query Fixed-term Billing Query Transactions

⌘I

​Request Headers

​Query Parameters

​Response Parameters

Request Headers

Query Parameters

Response Parameters