Query Usage-based Billing

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

{
  "bills": [
    {
      "userId": "<string>",
      "startTime": "1764547200",
      "endTime": "1764633599",
      "billingMethod": 1,
      "productName": "<string>",
      "category": "llm",
      "ownerID": "<string>",
      "billNum0": "1000",
      "billNum1": "500",
      "basePrice0": "0",
      "basePrice1": "0",
      "discountPrice0": "0",
      "discountPrice1": "0",
      "amount": "10000",
      "voucherAmount": "0",
      "payAmount": "10000",
      "payAmountDisplay": 1,
      "pricePrecision": 1,
      "productId": "<string>"
    }
  ]
}

GET

openapi

billing

bill

list

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

{
  "bills": [
    {
      "userId": "<string>",
      "startTime": "1764547200",
      "endTime": "1764633599",
      "billingMethod": 1,
      "productName": "<string>",
      "category": "llm",
      "ownerID": "<string>",
      "billNum0": "1000",
      "billNum1": "500",
      "basePrice0": "0",
      "basePrice1": "0",
      "discountPrice0": "0",
      "discountPrice1": "0",
      "amount": "10000",
      "voucherAmount": "0",
      "payAmount": "10000",
      "payAmountDisplay": 1,
      "pricePrecision": 1,
      "productId": "<string>"
    }
  ]
}

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 cycle granularity. Options: Hour, Day, Week, Month.

productCategory

string

required

Product type. Common values:

summary (Summary bill)
gpu (GPU instance)
llm (LLM API)
serverless (Serverless Endpoint)
cloud_storage (Storage resources)
gen_api (Image/Video/Audio generation)
cloud_sandbox (Agent Sandbox)
llm_dedicated_endpoint (LLM Dedicated Endpoint)
web_search (Web Search)
bare_metal (Bare Metal)

productName

string

Product name. Supports fuzzy matching.

Response Parameters

bills

object[]

required

Pay-as-you-go 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

Resource instance ID.

productId

string

required

Product ID.

billNum0

string

required

Usage field 0. Meaning varies by product type:

llm: input tokens.
gpu: number of cards × billing duration.
cloud_storage: storage capacity × billing duration.
serverless: sum of worker count × duration.

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 tokens.

billNum3

string

required

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

billNum4

string

required

Usage field 4. For llm, this usually means output reasoning tokens. Currently not supported.

billNum5

string

required

Usage field 5. For llm, this usually means write 1-hour cache 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.

llm: input price per 1M tokens.
gpu: price per card per hour.
cloud_storage: price per GB per day.

basePrice1

string

required

Original price field 1. For llm, this usually means the output price per 1M tokens.

basePrice2

string

required

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

basePrice3

string

required

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

basePrice4

string

required

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

basePrice5

string

required

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

discountPrice0

string

required

Discounted price field 0.

llm: discounted input price per 1M tokens.
gpu: discounted price per card per hour.
cloud_storage: discounted price per GB per day.

discountPrice1

string

required

Discounted price field 1. For llm, this usually means the discounted output price per 1M tokens.

discountPrice2

string

required

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

discountPrice3

string

required

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

discountPrice4

string

required

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

discountPrice5

string

required

Discounted price field 5. For llm, this usually means the 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/bill/list?cycleType=Day&productCategory=llm&startTime=1764547200&endTime=1767225599' \
  --header 'Authorization: Bearer <API_KEY>'

{
  "bills": [
    {
      "userId": "<string>",
      "startTime": "1764547200",
      "endTime": "1764633599",
      "billingMethod": 1,
      "productName": "<string>",
      "category": "llm",
      "ownerID": "<string>",
      "billNum0": "1000",
      "billNum1": "500",
      "basePrice0": "0",
      "basePrice1": "0",
      "discountPrice0": "0",
      "discountPrice1": "0",
      "amount": "10000",
      "voucherAmount": "0",
      "payAmount": "10000",
      "payAmountDisplay": 1,
      "pricePrecision": 1,
      "productId": "<string>"
    }
  ]
}

Query Monthly Bill Query Fixed-term Billing

Documentation Index

​Request Headers

​Query Parameters

​Response Parameters

Request Headers

Query Parameters

Response Parameters