Kyb/DocsBeta
Start free

API Keys & Usage

Kyb uses AI for entity classification, cloud discovery abstraction, and the chat assistant. These features consume tokens. This page explains how token usage works and how to bring your own API key for unlimited access.

Understanding Token Usage

Tokens are a unit of AI processing. Every interaction with the AI assistant, every entity classification, and every cloud discovery abstraction consumes tokens. The number of tokens depends on the length and complexity of the conversation.

You can monitor your current token usage in the token meter, visible near the chat input in the Explorer. The meter shows how much of your monthly budget you have used.

Free Tier

Every Kyb account includes a free monthly token budget. This is enough to explore the product, build a small-to-medium architecture graph, and run cloud discovery on a typical GCP project. The budget resets monthly.

When you reach your free tier limit, AI features will be temporarily unavailable until the budget resets. You can still use all non-AI features (manual editing, views, export, team management) without limits.

Bring Your Own Key (BYOK)

For unlimited AI usage, you can add your own Anthropic API key. When a BYOK key is configured, all AI calls go directly through your key and are billed to your Anthropic account. Your free tier budget is no longer consumed.

Setting up BYOK

  1. 1. Create an API key at console.anthropic.com. You need an Anthropic account with billing enabled.
  2. 2. In Kyb, navigate to Settings > Billing.
  3. 3. Paste your API key in the BYOK section and save.
  4. 4. All AI features now use your key. You can remove it at any time to revert to the free tier.

Security

Your API key is encrypted at rest and used only for AI calls on your behalf. It is never logged, shared, or used for any other purpose. You can revoke it from your Anthropic console at any time.

Reducing Token Usage

  • Batch descriptions -- Describe multiple systems in a single chat message rather than one at a time.
  • Deterministic cloud discovery -- Run discovery in deterministic-only mode to skip the AI abstraction step. This uses zero tokens but produces infrastructure-level entities instead of architecture-level ones.
  • Manual editing -- Use the entity form and drag-to-connect for straightforward additions that do not need AI classification.

Need help?

If you have questions or run into issues, reach out at [email protected]. You can also start over with the Getting Started guide.