# Venice AI Billing Usage

> Venice AI Billing Usage is a paid API for AI agents from api.venice.ai, paid per call via x402, $10/call, status down (last checked 2026-10-12).

Retrieves paginated billing usage records for the authenticated Venice AI user, with filtering by date range and currency.

## Facts

- Endpoint: GET https://api.venice.ai/api/v1/billing/usage?utm_source=zero.xyz
- Price: $10/call
- Payment: x402
- Status: down
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402, ai_ml
- Canonical page: https://www.zero.xyz/c/venice-ai-billing-usage-f4c80237
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7gp9oT7B7DxKdFmrnbEua

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability venice-ai-billing-usage-f4c80237
```

Example prompt: Show me my Venice AI billing usage for January 2024 — page 1 with 200 records per page, filtered to USD charges and sorted from newest to oldest.

## When to prefer this

Use this endpoint when you need detailed per-call billing records including SKU-level breakdowns, token counts, and inference execution times for the authenticated Venice AI account. Prefer this over the Usage Analytics sibling endpoint when you need raw paginated data rather than aggregated analytics, or when you need to export or audit specific date ranges of usage.

## Known failure modes

- Invalid date format returns 400 — use ISO 8601 format for startDate/endDate
- Page or limit below minimum (0) returns validation error
- Invalid currency enum value returns 400
- Unauthenticated request returns 401
- Rate limit exceeded returns 429
- Beta endpoint may return unexpected schema changes or 5xx errors

## How this service works

Get paginated billing usage data for the authenticated user. NOTE: This is a beta endpoint and may be subject to change.

## Output

Returns an array of billing usage entries, each containing SKU, notes, units consumed, amount charged, currency (USD/VCU/DIEM/BUNDLED_CREDITS), timestamp, price per unit in USD, and optional inference details (requestId, promptTokens, completionTokens, executionTime). Also returns pagination metadata including current page, limit, total records, and total pages.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "page": {
   "type": "integer",
   "default": 1,
   "example": 1,
   "minimum": 0,
   "description": "Page number for pagination",
   "exclusiveMinimum": true
  },
  "limit": {
   "type": "integer",
   "default": 200,
   "example": 200,
   "maximum": 500,
   "minimum": 0,
   "description": "Number of items per page",
   "exclusiveMinimum": true
  },
  "endDate": {
   "type": "string",
   "format": "date-time",
   "example": "2024-01-01",
   "description": "End date for filtering records (ISO 8601)"
  },
  "currency": {
   "enum": [
    "USD",
    "VCU",
    "DIEM",
    "BUNDLED_CREDITS"
   ],
   "type": "string",
   "example": "USD",
   "description": "Filter by currency"
  },
  "sortOrder": {
   "enum": [
    "asc",
    "desc"
   ],
   "type": "string",
   "default": "desc",
   "example": "desc",
   "description": "Sort order for createdAt field"
  },
  "startDate": {
   "type": "string",
   "format": "date-time",
   "example": "2024-01-01",
   "description": "Start date for filtering records (ISO 8601)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "example": {
  "data": [
   {
    "sku": "grok-imagine-image-image-unit",
    "notes": "API Inference",
    "units": 1,
    "amount": -0.1,
    "currency": "DIEM",
    "timestamp": {},
    "pricePerUnitUsd": 0.1,
    "inferenceDetails": null
   },
   {
    "sku": "zai-org-glm-5-1-llm-output-mtoken",
    "notes": "API Inference",
    "units": 0.000227,
    "amount": -0.06356,
    "currency": "DIEM",
    "timestamp": {},
    "pricePerUnitUsd": 2.8,
    "inferenceDetails": {
     "requestId": "chatcmpl-4007fd29f42b7d3c4107f4345e8d174a",
     "promptTokens": 339,
     "completionTokens": 227,
     "inferenceExecutionTime": 2964
    }
   }
  ],
  "pagination": {
   "page": 200,
   "limit": 1,
   "total": 56090,
   "totalPages": 56090
  }
 },
 "required": [
  "data",
  "pagination"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "amount",
     "currency",
     "inferenceDetails",
     "notes",
     "pricePerUnitUsd",
     "sku",
     "timestamp",
     "units"
    ],
    "properties": {
     "sku": {
      "type": "string",
      "description": "The product associated with the billing usage entry"
     },
     "notes": {
      "type": "string",
      "description": "Notes about the billing usage entry"
     },
     "units": {
      "type": "number",
      "description": "The number of units consumed"
     },
     "amount": {
      "type": "number",
      "description": "The total amount charged for the billing usage entry"
     },
     "currency": {
      "enum": [
       "USD",
       "VCU",
       "DIEM",
       "BUNDLED_CREDITS"
      ],
      "type": "string",
      "example": "USD",
      "description": "The currency charged for the billing usage entry"
     },
     "timestamp": {
      "type": "string",
      "example": "2025-01-01T00:00:00.000Z",
      "description": "The timestamp the billing usage entry was created"
     },
     "pricePerUnitUsd": {
      "type": "number",
      "description": "The price per unit in USD"
     },
     "inferenceDetails": {
      "type": "object",
      "nullable": true,
      "required": [
       "completionTokens",
       "inferenceExecutionTime",
       "promptTokens",
       "requestId"
      ],
      "properties": {
       "requestId": {
        "type": "string",
        "nullable": true,
        "description": "Unique identifier for the inference request"
       },
       "promptTokens": {
        "type": "number",
        "nullable
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/venice-ai-billing-usage-f4c80237/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.venice.ai](https://www.zero.xyz/host/api.venice.ai/llms.txt)