Free.ai API

Mid API furaha. Wax kasta oo AI qalab. Simple token billing.

Sida ay u shaqeyso

1
Ka hel API Key

Iibso calaamadaha, ka dibna abuuro sk-free- furahaaga

2
U yeedh wax kasta oo xagga dambe ah

Chat, sawirro, TTS, STT, muusig, turjumaad: dhammaan API mid ah

3
Lacag ku bixi

Mid miisaaniyad. qalab kasta oo ku kacaya calaamadaha. fudud.

Bilow deg deg ah

# 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);

Qiimaha Token

Mid ka mid ah miisaaniyadda qalabka oo dhan. Qiimaha isku mid ah haddii aad isticmaali API ama bogga internetka.

Models Self-Hosted Ugu jaban
NoocNoocQiimahaLiisan
Qwen 3.6 35BChat/Write/CodeTokens dhabta ah ee la isticmaalay (input+output)Apache 2.0
FLUX.2 yarSoosaarka Sawirka5,000 calaamadaha/sawirkaApache 2.0
KokoroQoraalka-u-hadalka1 calaamad oo 4 xarfo ahApache 2.0
faster-whisperHadal ilaa qoraal4 tokens / sekondii audioMIT
AudioLDM 2Dhalashada Muusikada2,000 calaamadaha / trackApache 2.0
MadLAD-400Tarjumaadda (450+ langs)Token-ka dhabta ah ee la isticmaalayApache 2.0
Real-ESRGANSaamaynta Sawirka500 calaamadaha/sawirkaBSD
BRIA RMBGDib u-dhigis500 calaamadaha/sawirkaApache 2.0
CogVideoXabuurka video30,000 calaamadaha/videoApache 2.0
Stem Separator (Mel-Band RoFormer + SCNet)Kala Bixinta Dhagaxyada500 calaamadaha / trackMIT + Apache-2.0
Models Dibadda 575 qaabab

Gaarsiinta GPT-6, Claude, Gemini, Llama, DeepSeek iyo wixii ka harsan ee 575 qaababka. Qiimaha Token waa ku saleysan qiimaha bixiyaha la beddelay si ay u muujiyaan our.

NoocBixiye~ Tokens per fariin (500 in, 300 ka baxsan)
GPT-4o-miniOpenAI~286
Mistral NemoMistral~100
Llama 3.3 70B InstructMeta~639
Qwen2.5 72B InstructQwen~337
DeepSeek V3DeepSeek~493
GPT-4oOpenAI~4,781

Liiska buuxa ee 575 qaababka at /models/. Dhammaan isticmaalaan /v1/chat/ endpoint la mid ah: kaliya bedeli model parameter.

Foomka

Models Self-hosted: Waxaad bixisaa calaamadaha saxda ah ee la isticmaalay.

Models Dibadda: our_tokens = provider_usd_cost × 750,000 × 1.5

tusaale: GPT-4o qiimaha $0.0025 per 1,000 calaamadaha soo jeediyay, sidaas 1,000 calaamadaha soo jeediyay qiimaha $0.0025 x 750,000 x 1.5 = 2,812 calaamadaha kaaga saldhigga.

The 1.5 markup waa heerka caadiga ah. xisaabaadka la kharashka bil kasta sare u bixiyaan mid ka hooseeya.

Dhammaan

Chat / LLM
POST /v1/chat/Chat oo leh nooc kasta oo (self-hosted ama dibadda). Streaming taageeray.
Sawirka
POST /v1/image/generate/Qoraalka sawirka (FLUX, SDXL)
POST /v1/image/edit/Inpaint, outpaint, qaabka wareejinta
POST /v1/image/enhance/U kordhi 2x/4x (Real-ESRGAN)
POST /v1/image/remove-bg/Ka saar daaqadda (BRIA RMBG)
Fiidiyow
POST /v1/video/generate/qoraal/sawirka in video (CogVideoX)
Qoraalka-u-hadalka
POST /v1/tts/abuuro hadalka (Kokoro, Piper, MeloTTS, Chatterbox)
POST /v1/tts/stream/Streaming TTS (real-time audio chunks)
Hadal ilaa qoraal
POST /v1/stt/transcribe/Ku qor codka/fiidiyowga (faster-whisper, 99 luqadood)
Muusikada iyo Dhagaha
POST /v1/music/generate/Dhagax ka abuuro qoraalka
POST /v1/music/separate/kala sooci codka/dhagaxa (Mel-Band RoFormer + SCNet)
Qalabka qoraalka
POST /v1/write/abuuro content (eegey, email, sheeko, iwm)
POST /v1/code/generate/Code abuuro in luqadda kasta
POST /v1/summarize/Faahfaahin qoraalka
POST /v1/humanize/Samee AI qoraalka codka aadanaha
POST /v1/detect/Ogaanshaha waxyaabaha AI-soo-saarka
POST /v1/embeddings/Qoraalka embeddings: BGE-M3 default, ama "model": "embeddinggemma-2" for EmbeddingGemma 2 (768 dims, dimensions 128 ilaa 768, input_type su'aal ama qoraal)
Tarjumaadda & OCR
POST /v1/translate/Tarjumaan qoraalka (MadLAD-400, 450+ luqadood)
POST /v1/ocr/Soo qaad qoraalka sawirka
Adeeg
GET /v1/modelsList all available models (self-hosted + external)
GET /v1/status/{job_id}/Ka hubi xaaladda shaqada aan la isku raacin
GET /healthAPI baaritaan caafimaad

Adeegga aqoonsiga

Ku darso furaha API ee Authorization madaxa:

Authorization: Bearer sk-free-YOUR_API_KEY

jawaab kasta oo ka mid ah free_ai_usage block muujinaya calaamadaha la isticmaalay:

{
  "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"
  }
}

Qiimaha xaddidaadda & qorshayaasha

Same token qiimaha ku saabsan bogga internetka iyo API. No kala duwan API qiimaha.

QorsheCalaamadahaAPI codsiyada / biloodAPI dalbashada / MinQiimaha
Bilaash30,000 maalin (jasiiradda bilaash ah)1,00060$0
Saddexaad250,00010,000120$5 bishii
Pro1,250,000100,000300$19 bishii
Ganacsi6,250,0001,000,000600$49 bishii
Enterprise_Cusub1,000,000 default, kor u qaadaya weydiinta600 default, kor u qaadaya weydiintaXidhiidh

Token pakets available: 200K/$5, 1M/$15, 5M/$40. Tokens marnaba ma dhamaadaan.

Python SDK iyo CLI

Python SDK

U dhaqaaq wax kasta oo AI ah koodkaada Python.

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"
PyPI PyPI
La-taliyaha Codsiyada CLI

Bilaash, furan-source bedelka Claude Code, Cursor, iyo GitHub Copilot.

# macOS / Linux
curl -fsSL https://free.ai/install.sh | sh
# Windows (PowerShell)
irm https://free.ai/install.ps1 | iex
# 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 / maalin. BYOK taageeray. 575 qaabab. Kulanka sync la Web IDE.

PyPI Ku rakib iyo setup IDE-ga Webka

BYOK (La soco furahaaga)

isticmaalka aad u gaar ah API furayaasha ka mid ah bixiyaha kasta. Zero markup, zero lacagaha. Free.ai kaliya proxies codsiga.

BixiyeNoocka furayaashaNoocyadaMarkii
OpenAIsk-proj-xxxGPT-4o, GPT-4o Mini, o1, o3, iwm.$0
Anthropicsk-ant-xxxClaude Sonnet 4, Opus 4, Haiku, iwm.$0
GoogleAIzaSyxxxGemini 2.5 Pro, Flash, iwm$0
La-hawlgalayaasha kalesk-or-xxx etc.575 qaabab ka bixiyaha oo dhan$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

Your furaha, isticmaalka aad, bill aad. No logging. No token deductions kaaga Free.ai miisaaniyadda.

Su'aalaha badanaa la waydiiyo

Haa! xisaabaadka Free helaan 30K tokens / maalin qorshayaasha la bixiyo bixiyaan tokens badan iyo xaddidaadyada heerka sare.

Ha! Same tokens, qiimaha isku mid ah. Your token miisaanka waxaa lagu wadaagaa u dhexeeya website iyo API. U isticmaali mid kasta, bixiso midka.

Same endpoint, kaliya bedeli kartaa model parameter. tusaale ahaan: "model": "openai/gpt-4o" ama "model": "anthropic/claude-sonnet-4". Liiska buuxa ee /models/ ama GET /v1/models.

Haa! The /v1/chat/ endpoint raacaa qaabka OpenAI chat completions. Waxaad isticmaali kartaa SDK kasta oo OpenAI-la jaanqaada: kaliya bedelka URL-ka salka https://api.free.ai iyo isticmaalka Free.ai API key.

Haa! Set "stream": true in aad weydiiso chat. Jawaabaha waxaa la siiyaa iyada oo Server-Diray dhacdooyinka (SSE).

Waxaad heli doontaa 402 jawaabta la fariin qalad ah. Iibso tokens dheeraad ah / qiimaha / ama sug in aad maalin kasta free pool si ay u soo celiyaan. Self-hosted qaababka waa waliba la heli karaa xaddidaadda maalin kasta.

Haa! dhammaan noocyada self-hosted waa MIT / Apache 2.0 sharci. content soo saaro waa adiga kuu ah isticmaalka ganacsi.

Self-hosted: ku socda GPU-yadayaga. ugu jaban, ugu dhaqsaha badan, kuwa ugu badan ee gaarka ah. Dibadda: ku xiran adeegga moodalka. U helitaanka GPT-4, Claude, Gemini, iyo in ka badan.

Booqo boggaaga xisaabtaada /account/ ama hubi free_ai_usage.tokens_charged goobta jawaabta API kasta.

Yes! Install our Python SDK: pip install free-dot-ai. It wraps every endpoint with typed responses. For coding assistance, install pip install freeai-code. The API also follows OpenAI's format, so you can use the openai Python/Node SDK with our base URL. API docs

Waxaan ujeedadeenu tahay 99.9% uptime, laakiin qorshe kasta oo hadda la yimaado SLA heshiiska. Ka hubi / caafimaadka xaaladda waqtiga dhabta ah.

Email hello@free.ai ama booqo / xiriir /. Pro+ qorshayaasha helaan taageerada hormuudka ah. Jawaabaha qaladku waxay ku jiraan error_id si loo debug.

Jecel Free.ai? Ka warran saaxiibbadaa!

Ma doonaysaan wax ka badan? Isdiiwaangeli bilaash: 30,000 tokens maalintii Ku soo biir Free

Boggan qiimee