BYOK AI File Renaming: Setup, Providers & Costs (2026)

Quick answer: BYOK (Bring Your Own Key) lets you connect your own OpenAI, Gemini, Groq, or Claude API key to Zush and pay that provider directly. BYOK does not make the FREE plan unlimited: FREE still includes 50 shared AI renames, while PRO removes the Zush rename limit. Provider quotas and charges remain separate.

Pricing and provider notes last checked June 12, 2026.

If you are deciding between BYOK, built-in cloud credits, and local Ollama processing, start with Cloud AI vs Local AI File Renaming.

Choose a BYOK provider

Provider plans, models, prices, and rate limits can change. Confirm the current terms in the provider dashboard before processing a large batch.

Five-minute BYOK setup

1. Create an API key in the provider’s official dashboard.
2. Open Zush and go to Settings → BYOK / API Key.
3. Select the provider and paste the key.
4. Run the connection test.
5. Add a small sample batch and review the proposed filenames before applying them.

In current Mac builds, the key is stored locally in macOS Keychain. When BYOK is enabled, Zush relays the analysis request through its backend to your selected provider using your key for that request. The provider returns the result and bills your account at its standard API rates; Zush does not add a provider-usage markup.

What BYOK means in practice

When you use Zush’s built-in credits, the AI processing happens through Zush’s infrastructure. That is convenient but capped. BYOK flips the model: Zush acts as the client, your API key provides the access, and the AI provider handles the processing.

The practical result:

• 50 shared renames on FREE, or no Zush rename limit on PRO
• You pay the AI provider directly at their published rates
• You choose which provider and model to use
• You can switch providers at any time
• In current Mac builds, your API key is stored locally in macOS Keychain and sent only when needed for a BYOK request

Why BYOK matters

Free access and unlimited PRO

BYOK is available from the free plan: its renames count toward the same 50-rename allowance as Cloud AI and Offline AI. PRO removes the Zush limit, so higher-volume workflows are then governed only by the selected provider’s quota, billing, and model availability.

Cost control

You see exactly what each rename costs because it appears on your provider’s dashboard. There is no bundled pricing or opaque credit system. For high-volume users, this is often cheaper per rename than any credit-based plan.

Provider choice

Different AI providers have different strengths. Some are faster, some are cheaper, some handle certain image types better. BYOK lets you pick the one that fits your workflow and switch if your needs change.

Privacy preferences

Some users prefer to control which AI provider processes their files. BYOK gives you that choice. You select the provider, you read their privacy policy, and you manage the relationship directly.

Supported providers

Zush supports four AI providers for BYOK. Each has different pricing, speed, and availability characteristics.

Gemini (Google)

Gemini is Google’s multimodal AI. It handles images and documents well, and it is one of the most cost-effective options for file renaming.

• Free tier: Yes. Google offers a free tier for the Gemini API with generous rate limits for personal use.
• Paid pricing: Very low per-request cost once you exceed the free tier.
• Speed: Fast. Google’s infrastructure handles requests quickly.
• Best for: Users who want to start with zero cost and scale up only if needed.

Groq

Groq runs AI inference on custom hardware designed for speed. It is one of the fastest providers available.

• Free tier: Yes. Groq offers a free tier with rate limits suitable for moderate usage.
• Paid pricing: Competitive per-token pricing at higher volumes.
• Speed: Very fast. Groq’s hardware is optimized for low-latency inference.
• Best for: Users who prioritize speed and process files in large batches.

OpenAI

OpenAI provides GPT-4o and related models with strong image understanding capabilities.

• Free tier: No free tier, but new accounts may receive initial credits.
• Paid pricing: Metered API pricing; the cost depends on model choice, image size, and token usage.
• Speed: Good. Response times are consistent and reliable.
• Best for: Users who already have an OpenAI account or prefer GPT-based models.

Claude (Anthropic)

Claude is Anthropic’s AI with strong visual understanding and detailed analysis capabilities.

• Free tier: No free tier, but new accounts may receive initial credits.
• Paid pricing: Metered API pricing; the cost depends on model choice, file type, and token usage.
• Speed: Good. In our testing Claude wrote the most specific descriptions for screenshots with mixed visual content.
• Best for: Users who want detailed, accurate content descriptions, especially for complex images and documents.

Cost breakdown: what provider usage costs

Here is what typical usage can look like in real dollar terms. These are directional estimates, not guarantees, because provider pricing, selected models, file sizes, prompt length, and token usage can change the final bill.

For context, 500 renames per month covers most active Mac users who take daily screenshots, download files regularly, and import photos weekly. The cost at that volume ranges from free to roughly fifty cents per month.

At 2,000 renames per month, heavy professional usage can still be low-cost on efficient models, but treat the table as a planning estimate and confirm current provider pricing before standardizing a workflow.

Step-by-step setup for each provider

For the quick-start version of these instructions inside Zush, see the BYOK setup guide.

Setting up Gemini

1. Go to Google AI Studio and sign in with your Google account
2. Navigate to the API keys section and create a new API key
3. Copy the key
4. Open Zush, go to Settings, and select the BYOK / API Key section
5. Choose Gemini as your provider and paste the key
6. Test the connection with a sample rename

That is the entire setup. Renames will now use your Gemini key with no monthly limit.

Setting up Groq

1. Go to Groq Console and create an account
2. Navigate to API Keys and generate a new key
3. Copy the key
4. In Zush Settings, select Groq as your provider and paste the key
5. Test with a sample file

Groq’s free tier is generous enough that many users never need to add a payment method.

Setting up OpenAI

1. Go to OpenAI Platform and sign in or create an account
2. Navigate to API keys and create a new secret key
3. Add a payment method if you do not have initial credits
4. Copy the key
5. In Zush Settings, select OpenAI as your provider and paste the key
6. Test with a sample rename

OpenAI charges per token, so costs scale linearly with usage. For file renaming, each request is small.

Setting up Claude

1. Go to Anthropic Console and create an account
2. Navigate to API Keys and generate a new key
3. Add a payment method to your account
4. Copy the key
5. In Zush Settings, select Claude as your provider and paste the key
6. Test with a sample file

Claude tends to write longer, more specific descriptions, which translates to more specific filenames.

When to use BYOK vs. credits

BYOK is not always the right choice. Here is how to decide.

Use the free plan (50 renames to start) when:

• You rename files occasionally, not daily
• You mainly use Zush for one-off cleanup projects
• You want zero setup and zero cost

Use PRO when:

• You rename files regularly and want unlimited PRO renames
• You prefer $10/month or $48 one-time over managing an API key
• You do not want to think about provider setup

Use BYOK when:

• You process large volumes of files (hundreds or thousands per month)
• You want no cap on renames under any circumstances
• You already have an API key with a supported provider
• You want to choose or switch your AI provider
• You want direct cost visibility through your provider’s billing dashboard

Tips for choosing a provider

Start with Gemini or Groq if cost matters most

Both offer free tiers that cover light to moderate usage. You can rename hundreds of files per month without paying anything. If you are not sure whether you need BYOK, starting with one of these lets you test the workflow at zero cost.

Choose OpenAI if you want broad model compatibility

OpenAI’s GPT-4o has been widely tested across many image types and document formats. If you process a wide variety of files and want predictable results, OpenAI is a safe default.

Choose Claude if description quality is your priority

Claude tends to write longer, more context-aware descriptions. If you work with complex images, detailed documents, or files where the filename really needs to capture subtle content, Claude is worth the extra per-call cost.

Switch providers any time

You are not locked in. You can change your API key or provider in Zush Settings at any point. Some users start with Gemini’s free tier and switch to OpenAI or Claude later when they want different output characteristics. Your rename history and naming patterns are preserved regardless of which provider you use.

Open videoOpen video

BYOK and folder monitoring

BYOK pairs naturally with folder monitoring. Files arrive in monitored folders, Zush detects them, sends the analysis request to your chosen AI provider, and renames them with zero manual input. FREE uses the shared 50-rename allowance; PRO removes the Zush rename cap.

This is the most hands-off setup available. For a detailed guide on folder monitoring, see the post on automatic file renaming with folder monitoring.

Security and privacy

Your API key is stored locally on your Mac and is only sent to the AI provider you selected. File content goes directly to the provider’s API endpoint for analysis. Review your chosen provider’s API data policy if privacy is a deciding factor.

Conclusion

BYOK gives you provider control. If you have already decided content-aware renaming is worth doing and want to route analysis through your own account, a Gemini or Groq key may cover light to moderate use within free-tier limits. For heavier OpenAI or Claude usage, use the estimate table as a planning baseline and confirm current provider pricing before committing.

For a comparison of Zush against other tools in this category, see Mac AI renamer tools comparison and AI renamer tools comparison. To get started with Zush, FREE includes 50 renames across Cloud AI, BYOK, and Offline AI; PRO removes the limit.