> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cyborg.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting an API Key

To use CyborgDB, you'll need an API key that authenticates your requests and determines your service capabilities. This guide will walk you through the process of signing up and generating your API key.

## Overview

CyborgDB offers both free and paid API keys:

<CardGroup cols={2}>
  <Card title="Free API Key" icon="gift">
    *Perfect for evaluation and testing*

    * Up to 1M vectors maximum
    * Community support
  </Card>

  <Card title="Paid API Key" icon="credit-card">
    *Full production capabilities*

    * Access to `cyborgdb-core` features
    * Unlimited items and vectors
    * All backing stores (PostgreSQL, Redis, Memory)
    * GPU acceleration support
    * Priority support
  </Card>
</CardGroup>

***

## Step-by-Step Guide

<Steps>
  <Step title="Sign Up for CyborgDB">
    Visit [cyborgdb.co](https://cyborgdb.co) and create your account.

    1. Click **"Sign Up"** in the top navigation
    2. Enter your email address and create a secure password
    3. Verify your email address by clicking the link sent to your inbox
    4. Complete your profile setup

    <Note>
      Your account starts with access to free API keys by default.
    </Note>
  </Step>

  <Step title="Choose Your Plan (Optional)">
    If you need production capabilities, upgrade to a paid plan.

    1. Navigate to the **"Billing"** section in your dashboard
    2. Review the available plans and features
    3. Select the plan that best fits your needs
    4. Complete the payment setup

    <Warning>
      **Plan Disclosure**: Paid plans unlock `cyborgdb-core` with unlimited vectors, GPU acceleration, and all backing stores. Free plans have a 1M item limite per index. You can always start free and upgrade later.
    </Warning>
  </Step>

  <Step title="Generate Your API Key">
    Create a new API key from your dashboard.

    1. In your CyborgDB dashboard, locate the **"API Keys"** section
    2. Click the **"Add"** button next to "API Keys"

    <Frame caption="CyborgDB Dashboard - API Keys Section">
      <img src="https://mintcdn.com/cyborg/kXyFWu9saA_TjOzS/images/cyborgdb-dashboard-create-api-key.png?fit=max&auto=format&n=kXyFWu9saA_TjOzS&q=85&s=92a9c1d24ff3c459a118eea46067980a" alt="Screenshot of CyborgDB Dashboard with API Keys 'Add' button highlighted" width="3464" height="2566" data-path="images/cyborgdb-dashboard-create-api-key.png" />
    </Frame>
  </Step>

  <Step title="Copy and Secure Your API Key">
    Your API key will be generated and displayed.

    <Frame caption="CyborgDB Dashboard - API Key Generated">
      <img src="https://mintcdn.com/cyborg/kXyFWu9saA_TjOzS/images/cyborgdb-dashboard-api-key-created.png?fit=max&auto=format&n=kXyFWu9saA_TjOzS&q=85&s=c58f991a49804f9f41f5ba416fe0c261" alt="Screenshot of CyborgDB Dashboard showing generated API key" width="3464" height="2566" data-path="images/cyborgdb-dashboard-api-key-created.png" />
    </Frame>

    <Warning>
      **Important**: Copy your API key immediately and store it securely. For security reasons, you won't be able to see the full key again after leaving this page.
    </Warning>

    **Best Practices:**

    * Store your API key in environment variables, not in your code
    * Never commit API keys to version control
    * Use different keys for development and production environments
    * Rotate keys regularly for enhanced security
  </Step>
</Steps>

***

## Using Your API Key

Once you have your API key, you can use it with any CyborgDB deployment:

<Tabs>
  <Tab title="Environment Variable (Recommended)">
    Set your API key as an environment variable:

    ```bash theme={null}
    export CYBORGDB_API_KEY="your-api-key-here"
    ```

    Then reference it in your code:

    ```python theme={null}
    import os
    from cyborgdb_core import Client

    client = Client(api_key=os.getenv("CYBORGDB_API_KEY"))
    ```
  </Tab>

  <Tab title="Direct Usage">
    Use your API key directly in your code (not recommended for production):

    ```python theme={null}
    from cyborgdb_core import Client

    client = Client(api_key="your-api-key-here")
    ```
  </Tab>

  <Tab title="Configuration File">
    Store in a configuration file that's excluded from version control:

    ```python theme={null}
    # config.py (add to .gitignore)
    CYBORGDB_API_KEY = "your-api-key-here"

    # main.py
    from config import CYBORGDB_API_KEY
    from cyborgdb_core import Client

    client = Client(api_key=CYBORGDB_API_KEY)
    ```
  </Tab>
</Tabs>

***

## Managing Your API Keys

### Dashboard Management

From your CyborgDB dashboard, you can:

* **View all API keys** - See all keys associated with your account
* **Create new keys** - Generate additional keys for different projects
* **Revoke keys** - Disable keys that are no longer needed
* **Monitor usage** - Track API key usage and performance

***

## Next Steps

<CardGroup cols={3}>
  <Card title="Start Building" href="./quickstart" icon="rocket">
    *Jump into the quickstart guide*

    Use your new API key to get started with CyborgDB
  </Card>

  <Card title="Choose Deployment" href="./deployment-models" icon="server">
    *Service vs Embedded*

    Decide between CyborgDB Service or Embedded libraries
  </Card>

  <Card title="Framework Integration" href="../integrations/langchain/introduction" icon="plug">
    *LangChain integration*

    Replace your existing vector store with CyborgDB
  </Card>
</CardGroup>

Got your API key? You're ready to start building confidential AI applications!
