# BYOK (Bring Your Own Key)





<DocImage src="features/byok/provider-settings" alt="The Provider settings listing model providers, with OpenAI expanded to show its ChatGPT and API key connection methods" width="1792" height="1148" />

BYOK (Bring Your Own Key) lets you connect your own API keys or existing provider subscriptions to Ideavo. Once connected, your usage is billed directly by the provider — it doesn't draw from your Ideavo credits.

## Supported Providers [#supported-providers]

A few of the major providers you can connect:

<Cards>
  <Card title="Anthropic" icon="<RiAnthropicLine />" description="Access Claude models directly through your Anthropic API key." />

  <Card title="OpenAI" icon="<BsOpenai />" description="Connect via API key or link your ChatGPT Plus/Pro subscription via OAuth." />

  <Card title="OpenCode" icon="<OpencodeIcon />" description="Connect your OpenCode subscription for seamless model access." />

  <Card title="OpenRouter" icon="<OpenrouterIcon />" description="Route requests across hundreds of models through a single key." />
</Cards>

<Callout type="tip">
  Ideavo supports many more providers. Visit
  [models.ideavo.ai](https://models.ideavo.ai/) for the full list, or check
  **Settings → Configurations** inside the app to see every provider currently
  available to connect.
</Callout>

### Need to connect local models? [#need-to-connect-local-models]

BYOK is for supported providers that Ideavo already knows how to connect. If you want to use a custom provider, self-hosted endpoint, custom Base URL, or your own model list, use [Custom Provider](/docs/features/custom-provider) instead.

## Connection Types [#connection-types]

Providers connect in one of two ways depending on what the provider supports.

### API Key [#api-key]

Most providers — including Anthropic, OpenRouter, and others — connect via a direct API key. You generate a key from your provider's dashboard, paste it into Ideavo, and requests are routed through your account at your provider's standard rates with no platform markup.

### OAuth & Subscriptions [#oauth--subscriptions]

Some providers support connecting via OAuth, which links your existing subscription rather than requiring a raw API key.

**OpenAI** is a notable example: connecting via OAuth with a ChatGPT Plus or Pro subscription grants access to models like **Codex** that are only available to active subscribers — models you wouldn't be able to reach with a standard API key alone.

<Callout type="info">
  OAuth connections never expose your account credentials. Ideavo only receives
  a scoped access token with the minimum permissions required to route model
  requests.
</Callout>

## Benefits [#benefits]

<Cards>
  <Card title="Direct billing" icon="<Wallet />" description="Pay your provider directly at their API rates. No platform markup, no middleman." />

  <Card title="More models" icon="<Layers />" description="Access any model your provider offers, including subscription-gated models like Codex via OpenAI OAuth." />

  <Card title="Use what you already pay for" icon="<BadgeCheck />" description="Fully utilize subscriptions you already have instead of paying for the same access twice." />

  <Card title="Revoke anytime" icon="<ShieldCheck />" description="Remove or rotate a key instantly from Settings without affecting your projects or history." />
</Cards>

### How to Connect a Provider [#how-to-connect-a-provider]

<Steps>
  <Step>
    Open **Settings** from the sidebar and navigate to **Configurations**.
  </Step>

  <Step>
    Select the provider you want to connect from the list of available
    integrations.
  </Step>

  <Step>
    Choose your connection method — **API Key** or **OAuth** — depending on what
    the provider supports, then follow the prompts.
  </Step>

  <Step>
    Save. The provider is now active and will be used for any models routed
    through it.
  </Step>
</Steps>

You can configure multiple providers simultaneously. Ideavo routes each request to the correct provider based on the model you select.

## Security [#security]

<Callout type="info">
  * All API keys and OAuth tokens are **end-to-end encrypted** and stored
    securely within Ideavo. - Keys are never exposed in plain text and cannot be
    viewed after saving. - OAuth tokens are scoped — Ideavo only requests the
    permissions needed to route model requests. - You can remove or rotate a key
    at any time from **Settings → Configurations** without affecting your project
    data.
</Callout>

### FAQ [#faq]

<Accordions>
  <Accordion title="Does using BYOK consume my Ideavo credits?">
    No. When you use a BYOK provider, requests are routed through your own key
    or subscription and billed directly by the provider. Your Ideavo credits are
    not affected.
  </Accordion>

  <Accordion title="What's the difference between API Key and OAuth connections?">
    An API key is a credential you generate from your provider's dashboard and
    paste into Ideavo. OAuth links your existing account or subscription
    directly — useful for providers like OpenAI where certain models (e.g.
    Codex) are only available to active subscribers and can't be accessed via a
    standard key.
  </Accordion>

  <Accordion title="Can I connect multiple providers at the same time?">
    Yes. You can configure as many providers as you like under Settings →
    Configurations. Ideavo routes each request to the appropriate provider based
    on the model you select.
  </Accordion>

  <Accordion title="Which providers support OAuth vs. API key?">
    Visit{" "}

    <a href="https://models.ideavo.ai/" target="_blank">
      models.ideavo.ai
    </a>

    {" "}

    for the full list of supported providers and their connection methods. You
    can also see available options per provider directly inside Settings →
    Configurations.
  </Accordion>

  <Accordion title="What happens to my key if I cancel my Ideavo subscription?">
    Your keys are removed from Ideavo when your account is closed. Your provider
    account itself is unaffected — only the connection within Ideavo is removed.
  </Accordion>

  <Accordion title="Can I update or rotate a key without losing my project data?">
    Yes. Updating or removing a key from Settings → Configurations only affects
    the connection — your projects, history, and settings remain intact.
  </Accordion>
</Accordions>
