API Keys
Weavin supports Bring Your Own Key (BYOK) — you can use your own API keys from AI model providers, giving you full control over model access and costs.
Why BYOK?
- Cost control — Token usage bills directly to your provider account
- Model access — Use models or tiers that may not be included by default
- Rate limits — Benefit from your own API rate limits and quotas
Adding an API Key
- Go to Settings from the dashboard sidebar
- Scroll to the API Keys section
- Click Add Key
- Select the provider (OpenAI, Anthropic, Google, or OpenRouter)
- Paste your API key
- Click Save
Your API key is encrypted with AES-256-GCM before storage. After saving, only the last 4 characters are displayed. Weavin never logs or exposes your full key.
Supported Providers
| Provider | Key format | Where to get it |
|---|---|---|
| OpenAI | sk-... | platform.openai.com/api-keys |
| Anthropic | sk-ant-... | console.anthropic.com |
| API key | aistudio.google.com | |
| OpenRouter | sk-or-... | openrouter.ai/keys |
How It Works
When you create or edit an avatar, the model picker shows which models are available. If you've added an API key for a provider, all of that provider's models become available.
The routing logic:
- If you have a BYOK key for the model's provider → uses your key
- Otherwise → uses Weavin's built-in proxy (for included models)
Managing Keys
From the Settings page you can:
- View all configured keys (last 4 characters shown)
- Delete a key you no longer need
- Replace a key by deleting the old one and adding a new one
Deleting an API key does not stop running avatars. They will fall back to Weavin's built-in proxy if the model is supported, or return an error if not.
Best Practices
- Rotate keys periodically for security
- Set spending limits on your provider account to avoid unexpected charges
- Use OpenRouter if you want access to a wide range of models from different providers with a single key