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

  1. Go to Settings from the dashboard sidebar
  2. Scroll to the API Keys section
  3. Click Add Key
  4. Select the provider (OpenAI, Anthropic, Google, or OpenRouter)
  5. Paste your API key
  6. 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

ProviderKey formatWhere to get it
OpenAIsk-...platform.openai.com/api-keys
Anthropicsk-ant-...console.anthropic.com
GoogleAPI keyaistudio.google.com
OpenRoutersk-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:

  1. If you have a BYOK key for the model's provider → uses your key
  2. 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