# BYOK

> Bring Your Own Key — connect your AI provider API key so chat, ghost-text completion, and skill passes run on your account, with usage you can see in that provider’s dashboard.

Also known as bring your own key

## In practice

BYOK means you connect your own AI provider API key so chat, ghost-text completion, and skill passes can run on your account with usage you can see in that provider's dashboard. It is not limited to skill launches — those three surfaces are in scope when a key is connected and ready.

Keys are stored encrypted and used for the AI calls you initiate. Hosted skill passes still work if you never connect a key, which matters for writers who want craft tools without managing provider billing. Choose the path that matches how your room budgets model usage across a season.

Set expectations with collaborators: a connected key changes whose quota a pass consumes. Review Inkwell's security docs for what scoped context is sent — typically the scenes or lines in scope for the pass, not your entire library as a silent bundle shipped without asking.

## What does BYOK mean?

BYOK stands for bring your own key. It means you supply a key of your own to a service, instead of using the one the service provides, so you keep control of something the key unlocks.

The term has two common meanings. In cloud security, the key is an encryption key that protects your data. In AI apps, the key is an API key for an AI provider account, so the app's AI requests run on your account.

Inkwell uses the second meaning: you connect an API key from your own AI provider account, and Inkwell's AI features run on it.

## BYOK in cloud encryption

Cloud providers encrypt the data they store. With BYOK, a customer creates an encryption key in their own system, often a hardware security module, and imports it into the provider's key service, so the customer controls the key that protects their data.

Microsoft Azure Key Vault documents the process in its BYOK specification: the key is wrapped for transfer so it never exists outside a hardware security module in plain text.

Organizations use it to meet rules about who controls encryption keys, and to be able to revoke access by disabling the key.

## BYOK for AI tools

Many apps with AI features let you bring your own API key from a provider such as Anthropic or OpenAI. The app sends its AI requests with your key, so they run on your provider account instead of the app's.

You then pay the provider directly at its own rates, see each request in the provider's dashboard and fall under your account's limits rather than the app's plan limits.

It suits writers who already pay for an AI provider, rooms that want one bill for a whole season and anyone who wants usage they can audit themselves.

## How BYOK works in Inkwell

In Inkwell you can connect an API key from Anthropic or OpenAI in your account settings. Once a key is connected, chat, ghost-text completion and skill passes can run on your provider account.

Keys are encrypted at rest, never shown again after you save them and used only for AI requests you start. Requests carry the context the work needs, such as the scenes in a pass, not your whole library.

AI usage on your own key is not counted against your Inkwell plan's AI limits, because you pay the provider directly. You can remove a key at any time and go back to Inkwell's hosted AI.

## Should you bring your own key?

Bring your own key if you want your provider's dashboard and billing, if you already pay for a provider account or if you use AI heavily enough that plan limits get in the way.

Skip it if you would rather not manage a provider account, a payment method and a key. Hosted AI needs no setup and its cost is part of your plan.

If you share a project, agree whose key pays for passes. A key connected to your account pays for the AI you run, not for what collaborators run on theirs.

## Official sources & context

Sources reviewed Nov 3, 2026

- [Microsoft Learn — Azure Key Vault bring your own key specification](https://learn.microsoft.com/en-us/azure/key-vault/keys/byok-specification)

[Set up BYOK](https://www.inkwell.software/resources/guides/byok-setup)

## Common questions

### What does BYOK mean?

BYOK means bring your own key: you supply your own key to a service instead of using the service's. In AI apps it is your own AI provider API key; in cloud security it is your own encryption key.

### What is BYOK encryption?

In cloud security, BYOK means the customer creates an encryption key in their own system and imports it into the cloud provider's key service, so the customer controls the key that protects their stored data.

### Which AI providers can I connect to Inkwell?

You can connect an API key from Anthropic or OpenAI in your account settings. Once a key is connected, chat, ghost-text completion and skill passes can run on that provider account.

### Do I need BYOK to try skills?

No. Every plan includes hosted skill passes. BYOK is optional when you want your own provider account, quotas, and dashboard-visible usage.

### What does BYOK route through my key?

Chat, ghost-text completion, and skills — not skills alone. If you connect a key, those AI surfaces can use your provider account.

### Are my API keys stored in plain text?

No. Keys are stored encrypted and used for provider calls you initiate. See Security for the fuller data-handling story behind storage.

### Can I use Inkwell AI features without bringing a key?

Yes. Hosted skills work without BYOK. Skip connecting a key if you prefer not to manage provider credentials or billing.

## Related terms

- [AI Skill](https://www.inkwell.software/glossary/ai-skill): A structured AI pass that reads your document and proposes edits or findings in place — dialogue polish, continuity flags, coverage — as reviewable markup you accept or reject.
- [Dialogue Pass](https://www.inkwell.software/glossary/dialogue-pass): A skill that proposes line-level dialogue improvements — tightening, rhythm, voice consistency — as inline markup you accept or reject one line at a time.
- [Continuity Check](https://www.inkwell.software/glossary/continuity-check): A skill that reads your scenes and flags continuity problems — vanishing props, unexplained costume changes, location contradictions — as findings you accept or dismiss.

---

Canonical page: <https://www.inkwell.software/glossary/byok>
