Hydra
Manage all your API keys in one place. Hydra distributes AI requests across your keys, monitors their health, and switches providers automatically when needed.
What It Does
Hydra is the engine room of XIX-VOID. Every AI request from every module — metadata generation, prompt writing, animation, keyword analysis — routes through Hydra. It keeps track of all your API keys, spreads the load between them, and handles failures silently so your workflow never stops.
Adding Gemini Keys
Get your Gemini API keys from Google AI Studio (aistudio.google.com) — they're free. Add as many as you have. Hydra distributes requests across all of them automatically, respects each key's rate limits, and tracks how healthy each one is.
A key that starts returning errors gets fewer requests assigned to it. After 5 consecutive errors, it's auto-disabled and flagged for review. You can re-enable it manually once the issue is resolved.
Fallback Providers
Hydra has two fallback tiers when Gemini keys run out:
1. Groq — the first fallback. Fast and free at console.groq.com. Add your Groq key in the API Keys section and Hydra switches to it automatically when all Gemini keys are exhausted.
2. OpenRouter — the second fallback. If Groq also fails or is unavailable, Hydra tries OpenRouter next. Add your OpenRouter key for maximum continuity on high-volume days.
Your batch keeps running through all three tiers without interruption.
Bria Keys
Bria AI keys (used by Obscure and Ascend) are managed separately from Gemini keys. Add multiple Bria keys to increase how many editing jobs can run concurrently. Hydra rotates between them per job — if one key fails mid-job, the request retries with a different key automatically.
Request Log
The Request Log shows every AI call in real time — which module made it, which model responded, how many tokens were used, how long it took, and which key served it.
Use the log to spot wasteful prompts (unexpectedly high token counts), diagnose slowdowns (high latency on a specific key), or confirm that your keys are actually being used as expected during a large batch.
Tips for High-Volume Work
The more Gemini keys you add, the more parallel work Hydra can handle. Free-tier Gemini keys are generous — adding 5 to 10 keys from different Google accounts noticeably increases your batch throughput.
Check the health scores periodically. Keys that sit at low health for days may have underlying account issues — regenerate them in AI Studio and replace the old key in Hydra.