Free.ai API

Mid API muhiim ah. Wax kasta oo AI qalab. Simple token billing.

Sida ay u shaqeyso

1
Ka hel API Key

Iibso calaamado, ka dibna soo saar furahaaga sk-free-

2
U yeedha nuqulka dhamaadka

Chat, sawirro, TTS, STT, muusig, turjumaad — dhammaan API mid

3
Bixi Tokens

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": "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);

Qiimaha Token

Mid miisaanka qalabka oo dhan. Qiimaha isku mid ah haddii aad isticmaali API ama website.

Models Self-Hosted Ugu jaban
NoocNoocQiimaha calaamaddaLiisan
Qwen 2.5 7BKu hadla/qor/codsoTokens dhabta ah ee la isticmaalay (input+output)Apache
FLUX.1 degdeg ahSoosaarka Sawirada1,000 calaamadaha/sawirkaApache
KokoroQoraalka u beddel hadal1 calaamad oo 4 xarfo ahApache
Faster-whisperErayo u beddel qoraal4 calaamado / daqiiqo oo audio ahMIT
LDM-ka DhaqdhaqaaqaDhalashada Muusikada2,000 calaamadaha/trackApache
MadLAD-400Tarjumaadda (450+ langs)Token-yada dhabta ah ee la isticmaalayApache
Real-ESRGANSaamaynta Sawirka500 calaamadaha/sawirkaBSD
BRIA RMBGKa saar Dhagaxa500 calaamadaha/sawirkaApache
CogVideoXSoosaarka Fiidiyowga5,000 calaamadaha/videoApache
DemucsKala Bixinta Codka500 calaamadaha/trackMIT
Shaandhooyinka Dibadda 346+ tusaalooyin

Access GPT-4, Claude, Gemini, Llama, DeepSeek, iyo 340+ noocyo badan. Qiimaha Token waa ku salaysan qiimaha bixiyaha loo beddelay si ay u muujiyaan.

NoocBixiye~Tokens per messageFaahfaahin
GPT-4o yarOpenAI~20Cheap, degdeg ah
Gemini 2.0 FlashGoogle~15aad u degdeg ah
Mistral NemoMistral~10Qiimaha weyn
DeepSeek V3DeepSeek~30Talo xoog leh
Llama 3.3 70BMeta~25Miisaanka fur
Claude Sonnet 4Anthropic~400Tayada Premium
GPT-4oOpenAI~325Tayada Premium
Qwen 2.5 72BAlibaba~40weyn, awood u leh

Liiska buuxa ee 346+ qaababka at /apps/. Dhammaan isticmaalaan / v1/chat/ endpoint la mid ah — kaliya bedeli model parameter.

Foomka calaamadda

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

Models Dibadda: our_tokens = provider_usd_cost × 100,000 × 1.30

tusaale: GPT-4o qiimaha $ 0.0025 per 1K calaamadaha soo jeedinta. 1,000 calaamadaha: $ 0.0025 × 100,000 × 1.30 = 325 calaamado ka miisaankaaga.

Dhammaan

Wadahadalka / LLM
POST /v1/chat/Ku hadla oo leh nooc kasta (self-hosted ama dibadda). Streaming taageeray.
Sawirka
POST /v1/image/generate/Qoraalka ilaa sawirka (FLUX, SDXL)
POST /v1/image/edit/Inpaint, outpaint, qaabka wareejinta
POST /v1/image/enhance/Kor u qaad 2x/4x (Real-ESRGAN)
POST /v1/image/remove-bg/Ka saar background (BRIA RMBG)
Fiidiyow
POST /v1/video/generate/Warka/sawirada fiidiyowga (CogVideoX)
Qoraalka u beddel hadal
POST /v1/tts/abuuro hadal (Kokoro, Piper, MeloTTS, Chatterbox)
POST /v1/tts/stream/Streaming TTS (real-time audio chunks)
Erayo u beddel qoraal
POST /v1/stt/transcribe/Dhagax dhig audio / video (faster-wuxuu ku qayliyaa, 99 luqadood)
Muusikada iyo Dhagaha
POST /v1/music/generate/Dhammaan qoraalada
POST /v1/music/separate/Qaybta codka/dhagaxa kala sooci (Demucs)
Qalabka qoraalka
POST /v1/write/abuuro content (qaab, email, sheeko, iwm)
POST /v1/code/generate/Soo saar koodhka luqadda kasta
POST /v1/summarize/Faahfaahin qoraalka
POST /v1/humanize/Samee qoraalka AI codka aadanaha
POST /v1/detect/Ogaanshaha waxyaabaha AI-soo saara
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 xirin
GET /healthAPI baaritaan caafimaad

Adeegga aqoonsiga

Ku dar 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 website iyo API. No kala duwan API qiimaha.

QorsheToken/BiloodAPI dalbashada / MinQiimaha
Bilaash5K/maalmood (pool)10$0
Saddexaad250K30$5/bilood
Pro1.25M60$19/bilood
Ganacsi6.25M120$49/bilood
Enterprise_Cusub_CusubXiriirka

Token packs la heli karo: 200K/$5, 1M/$15, 5M/$40.

Python SDK iyo CLI

Python SDK

U dhaqaaq qalab 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"
GitHub PyPI
La-taliyaha Codsiga CLI

Bilaash, ikhtiyaar ikhtiyaari ah oo furan Claude Code, Cursor, iyo 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"

5K free tokens/day. BYOK taageeray. 346+ qaabab. Kulanka sync la Web IDE.

GitHub PyPI Web IDE

BYOK (La soco furahaaga)

isticmaalka furahaada API ka mid ah bixiyaha kasta. Zero markup, zero lacagaha. Free.ai kaliya proxies codsiga.

BixiyeNoocka furayaashaNoocyadaCalaamadaha
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
Bixiyeyaasha kalesk-or-xxx etc.346+ noocyada 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 isweydiiyo

Haa! xisaabaadka bilaashka ah helaan 5K tokens / maalin iyo 10K bonus diiwaangelinta. qorshayaasha la bixiyo bixiyaan tokens badan iyo xaddidaadyada heerka sare.

Ha! Same tokens, qiimaha isku mid ah. Your miisaanka token waa la wadaagaa u dhexeeya website iyo API.

Xadka dhamaadka la mid ah, kaliya bedeli paramtirka qaabka. tusaale ahaan: "model": "openai/gpt-4o" ama "model": "anthropic/claude-sonnet-4". Liiska buuxa ee /apps/ ama GET /v1/models.

Haa! The / v1 / chat / endpoint raacaa qaabka OpenAI chat completions. Waxaad isticmaali kartaa SDK kasta oo OpenAI-ku habboon — kaliya bedeli URL-ka asalka ah https://api.free.ai oo isticmaal Free.ai API key.

Haa! Set "stream": true in aad weydiiso chat. Jawaabtu waa la siiyaa via Server-Diray dhacdooyinka (SSE).

Waxaad heli doontaa 402 jawaabta la fariin qalad ah. Iibso tokens dheeraad ah / pricing / ama sug ilaa maalin kasta oo bilaash ah ee kuleylka si ay u soo celiyaan. Self-hosted qaababka waa wali laga heli karaa xaddidaha maalin kasta.

Haa! dhammaan noocyada self-hosted waa MIT / Apache 2.0 liisan. content soo saaro waa adiga oo loogu talagalay isticmaalka ganacsi.

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

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

Haa! Ku rakib Python SDK: pip ku rakibi free-dot-ai. Waxay ku shubtaa dhammaan xadka dhamaadka jawaabaha la daabacay. Si aad u codsato caawimaad, ku rakib pip ku rakibi free-dot-ai-code. API sidoo kale waa OpenAI\

Waxaan ujeedadeenu tahay 99.9% uptime. Qorshaha Enterprise waxaa ka mid ah dammaanad SLA. Ka hubi / caafimaadka xaaladda waqtiga dhabta ah.

Email hello@free.ai ama booqo / xiriir /. Pro + qorshayaasha helaan taageerada hormuudka ah. Jawaabaha qaladka waxaa ka mid ah error_id debugging.

Jecel Free.ai? Ka warran saaxiibbadaa!

Qiimayn qoraalkan