Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.veri.studio/llms.txt

Use this file to discover all available pages before exploring further.

Veri uses a credit-based billing system backed by Stripe. Credits are purchased through the dashboard and deducted automatically when training jobs complete and while deployments are running.

Get Credit Balance

stripe_customer_id
string
required
Your Stripe customer ID (linked to your account).

Request

curl "https://api.veri.studio/v1/billing/balance?stripe_customer_id=cus_abc123" \
  -H "Authorization: Bearer vk_your_api_key"

Response

{
  "stripe_customer_id": "cus_abc123",
  "balance_usd": 47.50
}

List Transactions

stripe_customer_id
string
required
Your Stripe customer ID.
limit
integer
default:"20"
Maximum number of transactions to return.

Request

curl "https://api.veri.studio/v1/billing/transactions?stripe_customer_id=cus_abc123&limit=10" \
  -H "Authorization: Bearer vk_your_api_key"

Response

{
  "items": [
    {
      "id": "txn_xyz789",
      "amount_usd": -4.51,
      "description": "Training job job_xyz789",
      "created_at": "2026-05-01T14:30:00Z"
    },
    {
      "id": "txn_abc456",
      "amount_usd": 50.00,
      "description": "Credit purchase",
      "created_at": "2026-04-28T09:00:00Z"
    }
  ]
}

Check Balance

Check whether a user has sufficient credits for a job before submission. Returns 402 when the balance is insufficient.
stripe_customer_id
string
required
Your Stripe customer ID.
estimated_cost_usd
number
required
Estimated cost of the job in USD.

Request

curl -X POST https://api.veri.studio/v1/billing/check_balance \
  -H "Authorization: Bearer vk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "stripe_customer_id": "cus_abc123",
    "estimated_cost_usd": 10.00
  }'

Response (sufficient)

{
  "sufficient": true,
  "balance_usd": 47.50,
  "estimated_cost_usd": 10.00
}

Response (insufficient)

{
  "error": {
    "type": "invalid_request_error",
    "code": null,
    "message": "Insufficient credit balance",
    "param": null
  }
}

Get Burn Rate

Returns the current credit burn rate from all running jobs and active deployments. Includes balance, hourly rate, and estimated hours remaining.

Request

curl "https://api.veri.studio/v1/billing/burn_rate" \
  -H "Authorization: Bearer vk_your_api_key"

Response

{
  "balance_usd": 47.50,
  "burn_rate_usd_per_hour": 3.25,
  "hours_remaining": 14.62,
  "active_jobs": [
    {
      "job_id": "job_xyz789",
      "gpu_type": "A100-80GB",
      "gpu_count": 1,
      "provider": "prime_intellect",
      "burn_rate_usd_per_hour": 3.25,
      "elapsed_seconds": 1800,
      "accrued_cost_usd": 1.625
    }
  ]
}
The burn rate endpoint returns data for all active training jobs and deployments. If no jobs or deployments are running, burn_rate_usd_per_hour is 0 and hours_remaining is null.