Free.ai API

One API key. Every AI tool. Simple token billing.

Maitiro Ekushanda

1
Kuwana API Key

Kutenga tokens, wobva wagadzira yako sk-free- key

2
Chiva chero Endpoint

Chat, mapikicha, TTS, STT, mimhanzi, kushandura - zvese zvakasiyana API

3
Pay in Tokens

One توازن. Every tool costs tokens. Simple.

Kutanga Kwenguva pfupi

# Chat with AI
curl -X POST https://api.free.ai/v1/chat/ \
  -H "Authorization: Bearer sk-free-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{"role": "user", "content": "Hello!"}],
    "model": "qwen7b"
  }'

# Generate an image — self-hosted (free within daily allowance)
curl -X POST https://api.free.ai/v1/image/generate/ \
  -H "Authorization: Bearer sk-free-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A sunset over mountains", "model": "sdxl"}'

# Generate with a premium model (paid tokens only — FLUX Kontext, Seedream,
# Ideogram, Nano Banana, Gemini 3 Pro, etc.). Full list at /v1/providers.
curl -X POST https://api.free.ai/v1/image/generate/ \
  -H "Authorization: Bearer sk-free-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A sunset over mountains", "model": "premium/flux-pro/kontext"}'

# Generate a video (premium)
curl -X POST https://api.free.ai/v1/video/generate/ \
  -H "Authorization: Bearer sk-free-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A cat running in slow motion", "duration": 5, "model": "premium/kling-video/v2.6/pro/text-to-video"}'

# Text to speech
curl -X POST https://api.free.ai/v1/tts/ \
  -H "Authorization: Bearer sk-free-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello world", "voice": "default", "model": "kokoro"}'

# Translate text
curl -X POST https://api.free.ai/v1/translate/ \
  -H "Authorization: Bearer sk-free-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello world", "target": "es"}'
import requests

API_KEY = "sk-free-YOUR_KEY"
BASE = "https://api.free.ai"
HEADERS = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}

# Chat
r = requests.post(f"{BASE}/v1/chat/", headers=HEADERS, json={
    "messages": [{"role": "user", "content": "Hello!"}],
    "model": "qwen7b"  # or "openai/gpt-4o", "anthropic/claude-sonnet-4", etc.
})
print(r.json()["choices"][0]["message"]["content"])

# Generate image — self-hosted (free within daily allowance)
r = requests.post(f"{BASE}/v1/image/generate/", headers=HEADERS, json={
    "prompt": "A sunset over mountains",
    "model": "sdxl",  # or "premium/flux-pro/kontext" for paid tier
    "aspect_ratio": "16:9"
})
print(r.json()["image_url"])

# Generate video (premium — see /v1/providers for the full list)
r = requests.post(f"{BASE}/v1/video/generate/", headers=HEADERS, json={
    "prompt": "A cat running in slow motion",
    "duration": 5,
    "model": "premium/kling-video/v2.6/pro/text-to-video"
})
print(r.json()["video_url"])

# Text to speech
r = requests.post(f"{BASE}/v1/tts/", headers=HEADERS, json={
    "text": "Hello world",
    "model": "kokoro",
    "voice": "af_heart"
})
print(r.json()["audio_url"])

# Transcribe audio
r = requests.post(f"{BASE}/v1/stt/transcribe/", headers=HEADERS, json={
    "url": "https://example.com/audio.mp3",
    "model": "whisper"
})
print(r.json()["text"])
const API_KEY = "sk-free-YOUR_KEY";
const BASE = "https://api.free.ai";

// Chat
const chat = await fetch(`${BASE}/v1/chat/`, {
  method: "POST",
  headers: { "Authorization": `Bearer ${API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    messages: [{ role: "user", content: "Hello!" }],
    model: "qwen7b"
  })
});
const data = await chat.json();
console.log(data.choices[0].message.content);

// Generate image — self-hosted (free within daily allowance)
const img = await fetch(`${BASE}/v1/image/generate/`, {
  method: "POST",
  headers: { "Authorization": `Bearer ${API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ prompt: "A sunset over mountains", model: "sdxl" })
});

// Premium image model (paid tokens) — full list at /v1/providers
const imgPro = await fetch(`${BASE}/v1/image/generate/`, {
  method: "POST",
  headers: { "Authorization": `Bearer ${API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ prompt: "A sunset over mountains", model: "premium/flux-pro/kontext" })
});
console.log((await img.json()).image_url);

Token Kubhadhara

Zviri nyore kushandisa, uye zvinokurumidza.Izvi zvinokutendera kuti utore mari yako yese kubva kune chero webhusaiti kana API.

Self-Hosted Mamodeli Yakachipa
Model_Rudzi:Kubhadhara kweTokenLicense
Qwen 2.5 7BChat/Write/CodeNhasi tokens kushandiswa (input + output)Apache 2.0
FLUX.2 KleinKuumbwa kweImage5,000 tokens / vhidhiyoApache 2.0
KokoroTevere1 token per 4 charsApache 2.0
faster-whisperKutaura-Ku-Tekisi4 tokens / sekondi yeaudioMIT
AudioLDM 2Kuumbwa kweMusic2,000 tokens / trackApache 2.0
MadLAD-400Kushandurwa (450+ langs)_KushandisaApache 2.0
Real-ESRGANKuwedzera kwechifananidzo500 tokens / vhidhiyoBSD
BRIA RMBGKubvisa Kwekunze500 tokens / vhidhiyoApache 2.0
CogVideoXKugadzira Video5,000 tokens / videoApache 2.0
DemucsKCharselect unicode block name500 tokens / trackMIT
_Pamusoro 346 + mamodheru

Kuwana GPT-4, Claude, Gemini, Llama, DeepSeek, uye 340+ mamwe mamodheru. Token mutengo wakagadzirwa nechigadzirwa chekutenga chinoshandurwa kuita yedu tokens.

ModelMugadziri~ Tokens per messageNhoroondo
GPT-4o MiniOpenAI~20Cheap, nyore
Gemini 2.0 FlashGoogle~15Yakanaka kwazvo
MistralMistral~10Great value
DeepSeek V3DeepSeek~30Strong reasoning
Llama 3.3 70BMeta~25Open weights
Claude Sonnet 4Anthropic~400Premium mhando
GPT-4oOpenAI~325Premium mhando
Qwen 2.5 72BAlibaba~40Large, capable

Full list of 346+ models at /models/.All use the same /v1/chat/ endpoint — just change the model parameter.

Token formula

Self-inochengetwa mamodheru: Unogona kubhadhara zvakajeka matombo anoshandiswa. Hapana markup.

Zvekunze mamodheru: our_tokens = provider_usd_cost × 100,000 × 1.30

Mufananidzo: GPT-4o mutengo $0.0025 pa 1K prompt tokens. For 1,000 tokens: $0.0025 × 100,000 × 1.30 = 325 tokens kubva pamari yako.

_Zvimwe

Chat / LLM
POST /v1/chat/Chat nechero mhando yechigadzirwa (yakazvimirira kana kunze). Streaming inotsigirwa.
I_mage
POST /v1/image/generate/Tevere, sarudza bhokisi rezvinyorwa (FLUX, SDXL)
POST /v1/image/edit/Inpaint, outpaint, style transfer
POST /v1/image/enhance/Kuwedzera 2x/4x (Real-ESRGAN)
POST /v1/image/remove-bg/Remove background (BRIA RMBG)
Video
POST /v1/video/generate/Tevere:
Tevere:
POST /v1/tts/Kugadzira mashoko (Kokoro, Piper, MeloTTS, Chatterbox)
POST /v1/tts/stream/Streaming TTS (real-time audio chunks)
Kutaura-Ku-Tekisi
POST /v1/stt/transcribe/Kushandura audio/video (faster-whisper, 99 languages)
Musangano & Audio
POST /v1/music/generate/Kugadzira mimhanzi kubva pamashoko ezvinyorwa
POST /v1/music/separate/Kusiyana kwevokal/stems (Demucs)
Zvirongwa
POST /v1/write/Kugadzira zvemukati (esesi, email, nyaya, nezvimwewo)
POST /v1/code/generate/Kugadzira kodhi mu chero rurimi
POST /v1/summarize/Kuisa mufananidzo
POST /v1/humanize/Kuita kuti AI tebhu iite semunhu
POST /v1/detect/Kuwana AI-yakagadzirwa zvemukati
Kushandura & OCR
POST /v1/translate/Kushandura tenzi (MadLAD-400, 450+ languages)
POST /v1/ocr/Kubvisa tenzi kubva kuimages
Utility
GET /v1/modelsList all available models (self-hosted + external)
GET /v1/status/{job_id}/Cheka async job status
GET /healthAPI hutano cheki

Ku_zivana

Kusanganisira yako API key mu Authorization header:

Authorization: Bearer sk-free-YOUR_API_KEY

Yese mhinduro inosanganisira free_ai_usage block ichiratidza ma tokens anoshandiswa:

{
  "choices": [...],
  "free_ai_usage": {
    "tokens_used": 142,      // actual tokens processed
    "tokens_charged": 142,   // tokens deducted from your balance
    "source": "self_hosted", // or "external"
    "model": "qwen7b"
  }
}

Kubhadhara Zvirambidzo & Plans

Same token pricing pawebsite uye API. No zvakasiyana API pricing.

PlanTokens/mwedziAPI Kukumbira / MinMutengo
_Dambudziko:30K/zuva (pool)10$0
Chikuru250K30$5/mwedzi
Pro1.25M60$19/mwedzi
Business6.25M120$49/mwedzi
Enterprise_Zvinoenderana_Zvinoenderana_Vashandi

Token mapakeji anowanikwa: 200K/$5, 1M/$15, 5M/$40. Tokens haasi ku expire.

Python SDK & CLI

Python SDK

Kuwana chero AI chirongwa kubva Python yako kodhi.

pip install free-dot-ai
from freeai import FreeAI

ai = FreeAI(api_key="sk-free-xxx")

# Chat
response = ai.chat("What is Python?")
print(response.text)

# Image generation
image = ai.image("A sunset over mountains")
image.save("sunset.png")

# Text to speech
audio = ai.tts("Hello world", voice="af_heart")
audio.save("hello.mp3")

# Translation
result = ai.translate("Hello", to="es")
print(result.text)  # "Hola"
GitHub PyPI
CLI Kunyora Mubatsiri

Yakasununguka, yakavhurika-sosi sarudzo ye Claude Code, Cursor, uye GitHub Copilot.

pip install free-dot-ai-code
# Start a coding session
cd your-project/
free-code

# Ask about your codebase
free-code ask "How does auth work?"

# Execute a task
free-code run "Add unit tests for User model"

30K free tokens/day. BYOK supported. 346+ models. Session sync with Web IDE.

GitHub PyPI Web IDE

BYOK (Bring Your Own Key)

Usashandisa yako yepamutemo API mabhureki kubva kune chero mutengesi. Zero markup, zero mari. Free.ai chete proxies chikumbiro.

MugadziriChikamu cheKeyboardMamodheruKunyora
OpenAIsk-proj-xxxGPT-4o, GPT-4o Mini, o1, o3, etc.$0
Anthropicsk-ant-xxxClaude Sonnet 4, Opus 4, Haiku, etc.$0
GoogleAIzaSyxxxGemini 2.5 Pro, Flash, nezvimwe.$0
Vamwe Vagadzirisk-or-xxx etc.346+ mamodheru kubva kune vese vanopa$0
# Python SDK with BYOK
from freeai import FreeAI

ai = FreeAI(provider="openai", api_key="sk-proj-xxx")
response = ai.chat("Hello", model="gpt-4o")

# CLI with BYOK
# free-code config set provider openai
# free-code config set api_key sk-proj-xxx

Chikamu chako, kushandisa kwako, bhiri rako. Hapana kurodha pasi. Hapana kubvisa kwechiratidzo kubva kune yako Free.ai chengetedzo.

API FAQ

Yemahara accounts vanowana 30K tokens / zuva. Pamwe, vanobhadhara vanopa zvakawanda zve tokens uye zvirambidzo zvepamusoro.

Hapana! Same tokens, same pricing. Your token balance inopihwa pakati pewebsite uye API. Usati washandisa, bhadhara zvakafanana.

Same endpoint, just change the model parameter. For example: "model": "openai/gpt-4o" or "model": "anthropic/claude-sonnet-4". Full list at /apps/ or GET /v1/models.

Yeah! The / v1 / chat / endpoint inotevera OpenAI chat completions format. Iwe unogona kushandisa chero OpenAI-inowirirana SDK — chete chinja base URL kuti https://api.free.ai uye shandisa yako Free.ai API key.

Yes! Set "stream": true in your chat request. Responses are delivered via Server-Sent Events (SSE).

Uchawana 402 mhedzisiro nemeseji yematambudziko. Shandisa zvimwe zviratidzo pa / pricing / kana kumirira kuti yako yezuva nezuva yemahara pool idzokere. Self-hosted mamodheru anoramba aripo mukati memazuva ezvirambidzo.

Yeah! All self-hosted models are MIT/Apache 2.0 licensed. Yakagadzirwa zvemukati ndezvenyu chete uye inogona kushandiswa muzvinangwa zvekutengesa.

Self-hosted: inofamba paGPU yedu. Cheapest, fastest, most private. External: inoenda kuproxy yemugadziri wemufananidzo. Kusvika kuGPT-4, Claude, Gemini, uye zvimwe. Kubhadhara zvishoma nekuda kwemutengesi weAPI.

Dzvanya pane peji reaccount yako pa /account/ kana tarisa free_ai_usage.tokens_charged mumunda weAPI response.

Yeah! Install yedu Python SDK: pip install free-dot-ai. It wraps every endpoint with typed responses. For coding assistance, install pip install free-dot-ai-code. The API also follows OpenAI\

Tine chinangwa chekuvimbisa 99.9% uptime. Enterprise mapurogiramu anosanganisira SLA zvibvumirano. Ona /health yenguva chaiyo status.

Email hello@free.ai kana enda /contact/. Pro + michina kuwana kutarisirwa rutsigiro. Error mazano akadai error_id debugging.

Love Free.ai? Tinya pano kuti utore Free.ai!

Ratidza iyi peji