Billing & Credits
Sybil uses a flexible billing system that allows you to pay for usage via credits or subscription plans. This guide explains how to manage your funds, subscriptions, and how usage is tracked.
Account Balance & Credits
Your account operates with a credit balance system. Usage costs are deducted from your balance as you make requests to the API.
Viewing Your Balance
You can view your current account balance in the Settings > Billing section of the dashboard.
- Account Balance: Shows your current available funds in USD.
- Total Available Requests: Shows the number of requests available if you are on a specific plan.
Adding Credits
To add funds to your account:
- Navigate to Settings > Billing.
- Locate the Account Balance section.
- Select a quick amount or click Custom to enter a specific amount.
- Click Add Credits.
- You will be redirected to a secure checkout page (Stripe) to complete the payment.
- Once payment is successful, your credits will be immediately available in your account.
Payment Methods
You can manage your saved credit cards under the Payment Methods section in Billing settings. This allows for faster checkout when topping up credits.
Subscriptions
In addition to "pay-as-you-go" credits, Sybil offers subscription plans that may provide a set number of monthly requests or other benefits.
- Click View Plans or Change Plan in the Billing settings to explore available options.
- Plans can be Prepaid (requests allocated upfront) or Postpaid.
- Your current plan is displayed next to your name in the profile details.
API Usage & Tracking
All requests made to the Sybil API are associated with your account through API Keys.
API Keys
To make requests, you must include a valid API Key in the request headers.
- Go to Settings > API Keys.
- Click Create New Key.
- Give your key a name (optional) to help you identify it later.
- Copy your key immediately. For security reasons, the full key is only shown once.
Authenticating Requests
Include your API key in the Authorization header of your HTTP requests:
Authorization: Bearer YOUR_API_KEY
How Billing Works for Requests
When our systems receive a request with your API Key:
- We verify the key belongs to your account.
- We calculate the cost of the request based on the model used and the number of tokens (prompt + completion).
- The cost is deducted from your Account Balance (for pay-as-you-go) or counted against your Plan Requests (for subscriptions).
Monitoring Usage
You can track your spending and usage stats (e.g., total spend, request count) in the dashboard to stay on top of your consumption.
Security Best Practices
- Keep your keys private: Never commit API keys to public repositories (like GitHub) or include them in client-side code.
- Rotate keys: If you suspect a key has been compromised, delete it in the API Keys settings and create a new one.
- Use descriptive names: Name your keys (e.g., "Development", "Production") to easily manage access.