Home/Support/Managing AI API Keys (BYOK)

Managing AI API Keys (BYOK)

Category: AI Assisted Writing

The AI writing tools in the Manuscript Editor work on a Bring Your Own Key (BYOK) basis: you add an API key from an AI provider, and Writing Crucible uses it to make AI requests for you. You pay your provider directly for what you use.

Which features need a key

  • Need your own key: Continue writing, Continue writing with guidance, and the AI editing tools (Clarity, Tighten, Lengthen, Show, Active, Dialogue). These are part of the Professional plan.

  • Don't need a key: worldbuilding AI Summaries and the Cruci support chat run on Writing Crucible's own AI.

Supported providers

  • OpenAI

  • Google Gemini

  • Anthropic (Claude)

  • OpenRouter: one OpenRouter key also gives you access to many OpenAI, Anthropic and Google models.

You can save more than one key and switch between models from the Model picker in the editor's / menu. The picker only lists models your saved keys can run.

Adding a key

  1. Go to Settings → AI Providers and click Add New Key.

    Settings, AI Providers, with Add New Key highlighted
  2. Choose the Provider (openai, gemini, claude or openrouter).

  3. Paste your API Key and give it a Nickname so you can tell your keys apart. Both are required.

  4. Click Save Key.

The key is ready to use straight away.

Managing your keys

From Settings → AI Providers you can Reveal a key (they're masked by default) and Hide it again, Edit its nickname or replace its value, or Delete it.

How your keys are protected

  • Keys are encrypted at rest.

  • Keys are masked until you choose to reveal them.

  • Writing Crucible staff cannot view or decrypt your API keys.

  • Keys are never logged, shared with other users or collaborators, or included in exported files.

  • Every key action (save, edit, reveal, delete) requires you to be signed in.

  • Your keys are used only for your own AI requests, and Writing Crucible doesn't train AI models on your writing.

Getting a key

Troubleshooting

"API Key is required" or "Nickname is required"

Fill in both fields before saving.

My key is hidden after saving

That's expected. Keys are masked by default; click Reveal to see it.

AI features aren't working

  • Check that you're on the Professional plan or the free trial.

  • If the Model picker in the / menu shows No model available, none of your saved keys can run a model. Add a key under Settings → AI Providers.

  • Check that your provider account has credit available.

Good practice

  • Use a separate key just for Writing Crucible.

  • Rotate keys now and then, and delete ones you no longer use.

Hi, I'm Cruci!
Your AI support agent. I'm ready to answer any questions you have about Writing Crucible!