Skip to main content

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:

  1. Navigate to Settings > Billing.
  2. Locate the Account Balance section.
  3. Select a quick amount or click Custom to enter a specific amount.
  4. Click Add Credits.
  5. You will be redirected to a secure checkout page (Stripe) to complete the payment.
  6. 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.

  1. Go to Settings > API Keys.
  2. Click Create New Key.
  3. Give your key a name (optional) to help you identify it later.
  4. 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:

  1. We verify the key belongs to your account.
  2. We calculate the cost of the request based on the model used and the number of tokens (prompt + completion).
  3. 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.