free-the-ai/free-ai

---

Overview

FreeTheAi, also searched as Free The AI or Free The Ai, is a free API gateway with 60+ active models behind a single key. OpenAI-compatible - if your SDK works with OpenAI, it works here. Full request docs live at freetheai.xyz/docs.

• POST /v1/chat/completions - chat with streaming and tool calling
• POST /v1/messages - Anthropic-style messages route
• POST /v1/responses - OpenAI Responses API
• POST /v1/images/generations - image generation
• POST /v1/images/edits - image edits for supported image aliases
• POST /v1/audio/speech and /v1/audio/transcriptions - supported voice aliases
• Tool calling, structured outputs, multi-turn conversations
• No billing, no credit card, no prompt storage
• Optional paid slots at freetheai.xyz/pricing for separate higher-power models

---

Quick Start

Base URL    https://api.freetheai.xyz/v1
Auth        Bearer YOUR_API_KEY

[!IMPORTANT] New keys must complete /checkin once per UTC day before API use. /checkin asks for your existing key and a randomized human challenge.

[!TIP] Lost your key? Run /resetkey and provide a real reset reason - same account, same stats, fresh key.

---

Setup Guides

Step-by-step setup for the most common AI clients lives at freetheai.xyz/setup.

Each guide ships exact field labels, a copy-paste config, and the gotchas users actually hit.

---

SKILL.md

This repo includes a SKILL.md describing how AI agents should connect to FreeTheAi (base URL, routes, model aliases, capability metadata, and rate limits). The standalone skeuomorphic UI skill that previously lived here is now at docs/SKILL_SKEUOMORPHIC.md.

---

Routes

---

Code Examples

See examples/image_client.py for a beginner-friendly CLI tool that saves the key locally and writes the returned b64_json image to disk.

---

Release And Growth

Public releases make updates easier to follow and help the repo look active to GitHub users.

• Latest release draft notes: RELEASE_NOTES.md
• Public changelog: CHANGELOG.md
• SEO and GitHub growth checklist: docs/GROWTH.md

If this project helps you, star the repo and share the docs page. It helps more developers find a free OpenAI-compatible API without a billing setup.

---

Support The Project

FreeTheAi is built and maintained by Vibhek Soni. The free tier always stays free. If this project saves you a subscription, replaces a paid plan, or unblocks something you were stuck on, a small tip helps cover servers, proxies, and the long nights spent keeping models alive.

• One-time tip on Buy Me a Coffee: buymeacoffee.com/vibheksoni
• Star the repo: github.com/Free-The-Ai/free-ai
• Share the docs and the setup guides with anyone you know who needs a free OpenAI-compatible key

Thanks for keeping the free tier alive.

---

Models

Browse the full searchable catalog at freetheai.xyz/models. Request examples and endpoint details are on freetheai.xyz/docs.

Live health currently reports 64 public catalog models across 12 provider prefixes. The bundled site fallback snapshot at site/public/models.json is refreshed from the same live /v1/models/full catalog used by the models page.

[!NOTE] Use exact alias IDs from GET /v1/models. Model availability updates automatically as the service catalog changes.

---

Rate Limits

Tiers unlock through Discord invite progress. Per-user daily success cap defaults to 250/day (resets at UTC midnight) with role-based bumps for trusted members.

---

Privacy

FreeTheAi does not store prompt text, completion text, uploaded media, or conversation history as operational logs.

See the public Privacy Policy and Terms of Use for the plain-English disclosure. Metadata is logged to validate access, debug failures, secure the service, enforce limits, and prevent abuse.

---

Discord Commands

---

Team

Built by a small crew sharing free AI tools with everyone. Open source on GitHub.

GitHub org: Free-The-Ai. Full team page: freetheai.xyz/team.

---