Python

from openai import OpenAI

client = OpenAI(
    api_key="vb_live_your_project_key",
    base_url="https://api.velobase.io/v1",
    default_headers={"X-Velobase-Customer": "user_123"},
)

resp = client.chat.completions.create(
    model="your-model-id",  # one of your project's models, see GET /v1/models
    messages=[{"role": "user", "content": "Hello!"}],
)
print(resp.choices[0].message.content)

import requests

BASE = "https://api.velobase.io"
HEADERS = {"Authorization": "Bearer vb_live_your_project_key"}

resp = requests.post(
    f"{BASE}/v1/customers/deposit",
    headers=HEADERS,
    json={
        "customer_id": "user_123",
        "amount": 5_000_000,  # $5.00
        "idempotency_key": "stripe_evt_1a2b3c",  # so a retry never double-credits
    },
)
resp.raise_for_status()

cust = requests.get(f"{BASE}/v1/customers/user_123", headers=HEADERS).json()
wallet = cust["wallets"]["credits"]
print(wallet["available"], "available")
for s in wallet["sources"]:
    print(s["source"], s["available"])

page = requests.get(
    f"{BASE}/v1/customers/user_123/ledger",
    headers=HEADERS,
    params={"limit": 20},
).json()

# Known cost up front: 200,000 credits = $0.20
requests.post(f"{BASE}/v1/billing/deduct", headers=HEADERS, json={
    "customer_id": "user_123", "transaction_id": "img_001", "amount": 200_000,
})

# Unknown cost: reserve a budget, then settle the actual amount.
requests.post(f"{BASE}/v1/billing/freeze", headers=HEADERS, json={
    "customer_id": "user_123", "transaction_id": "job_001", "amount": 1_000_000,
})
requests.post(f"{BASE}/v1/billing/consume", headers=HEADERS, json={
    "transaction_id": "job_001", "actual_amount": 730_000,  # releases the rest
})
# To cancel instead: POST /v1/billing/unfreeze {"transaction_id": "job_001"}