Free.ai API

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

Maitiro Ekuita

1
Get an API Key

Kutenga ma tokens, wobva wagadzira yako sk-free- key

2
Nhare Yese Endpoint

Chat, mapikicha, TTS, STT, music, translation — zvese muimwe API

3
Pay in Tokens

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

Kutanga kwacho kwacho

# 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": "flux-schnell"}'

# 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": "flux-schnell",  # 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: "flux-schnell" })
});

// 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 Kutengesa

Zviri nyore kushandisa, uye zvinodhura. One kubhadhara kune ese maturusi. Same pricing kana iwe uchishandisa API kana webhusaiti.

Self-Hosted Mamodeli Yakachipa
Model_Ruvara:Kubhadhara kweTokenLicense
Qwen 2.5 7BChitima/Kunyora/KunyoraAuthentic tokens used (input+output)Apache 2.0
FLUX.1 FastKuumbwa kweImage1,000 tokens / vhidhiyoApache 2.0
_ChikoroTevere:1 token per 4 charsApache 2.0
faster-whisperKutaura-Ku-Tekisi4 tokens / sekondi yeaudioMIT
AudioLDM 2Kuumbwa kweMusic2,000 tokens / trackApache 2.0
MadLAD-400Kushandurwa (450+ talen)Ikozvino ma tokens anoshandiswaApache 2.0
Real-ESRGANKuwedzera Kukura Kwechifananidzo500 tokens / vhidhiyoBSD
BRIA RMBGKubvisa Kwekumashure500 tokens / vhidhiyoApache 2.0
CogVideoXKugadzira Video5,000 tokens / videoApache 2.0
DemucsKCharselect unicode block name500 tokens / trackMIT
_Pamusoro 346+ mamodheru

Kusvika GPT-4, Claude, Gemini, Llama, DeepSeek, uye 340 + zvakawanda mamodheru. Token mutengo inoenderana ne provider pricing yakashandurwa kuita yedu tokens.

ModelMugadziri~ Tokens per messageNhoroondo
GPT-4o MiniOpenAI~20Cheap, nyore
Gemini 2.0 FlashGoogle~15Yakanaka kwazvo
Mistral NemoMistral~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 /apps/. All use the same /v1/chat/ endpoint — just change the model parameter.

Token formula

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

Zvimwe 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 / Kutaura
POST /v1/chat/Chat ne chero model (self-hosted kana kunze). Streaming inotsigirwa.
I_mage
POST /v1/image/generate/Tevere kune imwecheteyo (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/Tenzi/picha ku video (CogVideoX)
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/Transcribe audio/video (faster-whisper, 99 languages)
Musangano & Audio
POST /v1/music/generate/Kugadzira mimhanzi kubva kune yakanyorwa chinyorwa
POST /v1/music/separate/Kuzvimirira vowels/stems (Demucs)
Zvirongwa
POST /v1/write/Kugadzira zvinhu (essay, email, nyaya, nezvimwewo)
POST /v1/code/generate/Kugadzira kodhi mu chero rurimi
POST /v1/summarize/Kuunganidza mazita
POST /v1/humanize/Kuita kuti AI tebhu iite semunhu
POST /v1/detect/Kuwana AI-yakagadzirwa zvemukati
Kushandura & OCR
POST /v1/translate/Translate text (MadLAD-400, 450+ languages)
POST /v1/ocr/Kubvisa mazita kubva kuimages
Utility
GET /v1/modelsList all available models (self-hosted + external)
GET /v1/status/{job_id}/Cheka async basa rezvirongwa
GET /healthAPI hutano cheki

Ku_zivana

Kusanganisira yako API key mu Authorization header:

Authorization: Bearer sk-free-YOUR_API_KEY

Kana iwe ukawana mhinduro, shandisa free_ai_usage block kukuratidzai 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 Mibvunzo / MinMutengo
_Dambudziko30K/day (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 ese 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

Free, open-source chirongwa chinova chirongwa chekushandura 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 mitero. Free.ai chete proxies chikumbiro.

MugadziriChiratidzo chekufomatiMamodeliKunyora
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 paFree.ai yako.

API FAQ

Yes! Free accounts get 30K tokens/day plus a 10K signup bonus. Paid plans offer more tokens and higher rate limits.

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