Skip to content
byokaiapi keytutorialgeminiopenaianthropicclaude

BYOK: Use Your Own AI API Key in Vyneron, on Any Plan

Vyneron Team·
Start managing tasks with AI. Free, no credit card required.Get Started Free →

The Problem with AI Lock-In

Most AI-powered productivity tools give you no choice. They pick the model, they control the pricing, and they set how much AI you get per day. If they raise prices, you pay more. If they switch providers, you adapt. Vyneron lets you bring your own key instead.

What is BYOK?

BYOK (Bring Your Own Key) means you can connect your own AI provider API key to Vyneron. Instead of relying on our managed AI, you plug in your own key from Google Gemini, OpenAI, Anthropic Claude, OpenRouter or Together AI, and Vyneron's AI features run on your account with that provider.

Natural language task creation, AI chat, text extraction from photos (OCR), tag suggestions and tool calls (creating tasks, setting reminders) all run on your key. Voice notes run on your key with Gemini and OpenAI; with Anthropic there is one exception, covered in Step 1 below.

Why Use Your Own Key?

Full Cost Control

With BYOK, you pay your AI provider directly at their published rates. Vyneron adds no markup. Settings shows this month's request count, tokens and an estimated cost, so you can see what your usage looks like before the provider's invoice arrives.

No Daily Message Cap

On Vyneron's system AI, every plan has a daily message limit. With your own key, that daily counter no longer applies. Two kinds of limits still do: Vyneron's per-minute request limits that protect the service (for example, 30 chat messages per minute), and your provider's own rate limits and quotas.

A Direct Relationship with Your Provider

Your requests go to the provider you chose, on your account, instead of Vyneron's shared AI pool. The call is still made by Vyneron's server rather than your browser, and your chat history is stored in your Vyneron account like any other chat. Your API key itself is encrypted before it is written to our database.

Provider Choice

ProviderWhat you choose
Google GeminiHas a free tier, which makes it a good first key to try
OpenAIYour OpenAI account; voice notes use its own transcription
Anthropic ClaudeModel is optional; leave it empty for the default
OpenRouterPick a model from a curated list (required)
Together AIPick a model from a curated list (required)

You can switch providers anytime from Settings.

How to Set Up BYOK

Step 1: Get Your API Key

Get a key from your provider:

Voice notes with Anthropic: Claude doesn't transcribe audio, so when you upload a voice note on an Anthropic key, Vyneron transcribes it with its own system AI and then hands the text to Claude. Text, chat, vision and tool calls run on your Anthropic key.

Step 2: Connect to Vyneron

  1. Open Settings in Vyneron
  2. Go to the Integrations tab and find Bring your own key
  3. Select your provider under AI Provider
  4. Paste your key into API Key
  5. Click Test: Vyneron sends one short request to your provider and tells you whether it worked
  6. Click Save

Test first, then save: Save stores the key without testing it.

Step 3: Verify

Send a message to the AI chat. If your key has a problem, Vyneron tells you instead of quietly switching to its own AI: on a paid plan you're asked what to do, on the free plan the switch is announced with a clear message. Out-of-credit and rate-limit errors get their own messages.

How It Works Under the Hood

When you set a custom provider, Vyneron stores your API key encrypted with Fernet. The key is decrypted in memory for the AI call.

  1. You send a message (text, image, or audio)
  2. Vyneron checks your AI provider setting
  3. If BYOK → your decrypted key is used to call your provider
  4. If system default → Vyneron's managed chain handles it (OpenAI → Gemini → Groq)
  5. The AI response comes back through the same path

One exception: if a setup is incomplete (for example, OpenRouter or Together AI selected without a model), Vyneron falls back to its system AI.

Your key is account-wide, not per channel: messages you send from Telegram, WhatsApp and Slack use the same key.

Smart Model Selection

Each provider has a chain of models, chosen by task type:

  • Chat and tool calls → starts with an economical model and moves up only if needed
  • Image OCR → vision-capable models
  • Audio transcription → speech-to-text models
  • Photo tag suggestions → a light, low-cost model

Simple chat runs on the cheaper models, so it doesn't use up credits on expensive ones.

BYOK vs. Paid Plans

BYOK works on any plan, including free:

Free + your keySolo ($6/mo)Solo + your key
AI messagesNo Vyneron daily cap*150/day on system AINo Vyneron daily cap*
Max files50500500

*Your provider's own limits and Vyneron's per-minute request limits still apply. You pay your provider directly for API usage.

A new account starts with a 7-day trial (no credit card) with 50 AI messages a day. After the trial, the free plan has no system AI: with your own key, AI keeps working.

Security Details

  • Encryption at rest: Fernet, with the encryption key derived via PBKDF2 (100,000 iterations)
  • Separate secret: the encryption secret lives in environment variables, separate from the database
  • Masked display: only the first and last 4 characters of your key appear in the UI, and our API returns only the masked form
  • Pasted keys are redacted: if you paste a raw API key into the chat, it is masked before the message is saved to your history
  • Admin-only access: only workspace owners and admins can change AI provider settings

Who Should Use BYOK?

  • Heavy users who hit the daily limit of the system AI
  • Teams that want to track AI costs through their own billing dashboard
  • Developers who already have API keys and want to use them in more places
  • Free plan users who want AI after the trial without upgrading

FAQ

Which AI providers can I use with my own API key?

You can connect a key from Google Gemini, OpenAI, Anthropic Claude, OpenRouter or Together AI. Gemini has a free tier, which makes it a good first key to try, and OpenRouter and Together AI require you to pick a model from a curated list.

Does using my own API key remove the daily AI message limit?

Yes, with your own key the daily message counter no longer applies. Vyneron's per-minute request limits, such as 30 chat messages per minute, and your provider's own rate limits and quotas still do.

Is it safe to store my API key in Vyneron?

Your key is encrypted with Fernet before it is written to the database, and the encryption secret lives in environment variables, separate from the database. The UI shows only the first and last 4 characters of the key.

Get Started

BYOK needs no special activation. Sign up for Vyneron, go to Settings → Integrations, pick your provider, paste your key, test it and save.

Once your key is connected, the AI can search everything you've saved, and here's how that search actually works.

Start free →

Related posts

Ready to run your day from one chat?

Start managing tasks with AI. Free, no credit card required.

Get Started Free →