Docs › Guide

Billing & Credits

How the credits system, atomic billing, free crawls, and Bring Your Own Key (BYOK) work.

Docsieve utilizes an atomic credits billing system combined with generous developer tiers to keep costs simple and predictable.

The Credits Model

Every documentation crawl consumes platform computation credits based on the volume of pages crawled.

1. Atomic “Charge-on-Success” Billing

We believe in charging only for successful crawls.

  • Credits are deducted only after a crawl completes successfully (consume_credit_atomic).
  • If a crawl fails due to rate limits, server timeouts, or connection failures, no credits are deducted.

2. Generous Free Crawls

For small-scale testing and development:

  • The first 3 pages crawled in any space are always free (was_free === true).
  • Free crawls do not consume platform credits or require a credit card.

Bring Your Own Key (BYOK)

To bypass standard credit limits and use your own LLM credits directly:

  1. Navigate to Workspace Settings > BYOK.
  2. Save your API key for OpenAI, Anthropic, Google Gemini, or DeepSeek.
  3. Choose the scope: restrict the key to a single workspace or make it global across all workspaces.

Security and Encryption

  • Fernet Symmetric Cryptography: Your LLM keys are encrypted at rest on our servers using secure Fernet cryptography keys.
  • Key Masking: Saved keys are masked in the UI—only the last 4 characters are visible (e.g. ...abcd), preventing credential leakage.
  • Computing Only: When using BYOK, you only pay a minimal compute fee for the raw page parsing, while LLM tokens are charged directly to your provider.