API Keys Guide
How to get all the keys you need to deploy your first agent.
What Keys Do You Need?
| Key | Required? | Template | |-----|-----------|----------| | Telegram Bot Token | Yes | All templates | | AI API Key (Anthropic or OpenAI) | Yes | All templates | | Brave Search API Key | Optional | Reddit Lead Gen, HN Lead Gen | | X (Twitter) API Credentials | Required | X Autopilot, X Lead Gen |
1. Telegram Bot Token
Your agent communicates through a Telegram bot. You create and own this bot — ModelFitAI just runs it.
Steps:
- Open Telegram and search for @BotFather
- Send
/newbot - Choose a display name (e.g. "My Lead Gen Bot")
- Choose a username ending in
bot(e.g.myleadgen_bot) - BotFather sends your token:
7123456789:AAFxxxxxxxxxxxxx
Save this token — you'll paste it during agent deploy.
Privacy note: Your bot token is stored encrypted in our database using AES-256-GCM. It is only decrypted at deploy time to launch your container.
2. AI API Key
Your agent uses a large language model to understand context, score leads, and generate responses. You bring your own key — you pay the provider directly at their rates (typically $1–5/month for light use).
Option A — Anthropic (Claude) — Recommended
- Go to console.anthropic.com
- Sign up → API Keys → Create Key
- Add $5 credit (enough for months of light use)
- Copy your key:
sk-ant-api03-...
Best for: Reddit Lead Gen, HN Lead Gen, Product Hunt Assistant
Option B — OpenAI (GPT)
- Go to platform.openai.com
- Sign up → API Keys → Create new secret key
- Add $5 credit
- Copy your key:
sk-...
Best for: X Autopilot, general purpose
Option C — OpenRouter (Access 100+ models)
- Go to openrouter.ai
- Sign up → API Keys → create key
- Add $5 credit
- Copy your key:
sk-or-v1-...
Best for: Budget use — access DeepSeek, Mistral, and other low-cost models
3. Brave Search API Key (Optional)
Some templates (Reddit Lead Gen, HN Lead Gen) can use Brave Search to enrich lead results. This is optional — the agent works without it.
- Go to brave.com/search/api
- Sign up for the Free tier (2,000 queries/month free)
- Create an API key
- Copy your key:
BSA_...
4. X (Twitter) API Credentials
Required only for X Autopilot and X Lead Gen templates.
- Go to developer.twitter.com
- Sign up for a Free Developer Account
- Create a new app → Keys and Tokens
- You'll need:
- API Key & Secret
- Access Token & Secret (for your account)
Note: X's free developer tier allows read + write access for your own account, which is sufficient for X Autopilot.
How Your Keys Are Stored
ModelFitAI takes security seriously. Here's exactly how your keys are handled:
- In transit: All keys are submitted over HTTPS
- At rest: Keys are encrypted with AES-256-GCM before being stored in our database. The encryption key never touches the database.
- At runtime: Keys are decrypted only when your Docker container is launched, injected as environment variables, and never written to disk
- Isolation: Each agent runs in its own Docker container on a dedicated bridge network — your keys are never shared with other users' containers
Next Steps
- Quick Start → — Deploy your first agent
- Agent Templates → — See which keys each template needs
- Plans & Credits → — Free and Starter plan details