Free.ai API

Isithonjana se-API esisodwa. Yonke into ye-AI. Ukukhokha okulula kwe-token.

Indlela esebenza ngayo

1
Thola isithonjana se-API

Thenga ama-token, bese udala isithonjana sakho se-sk-free-

2
Dzula noma yisiphi isiqephu esiphele

Chat, izithombe, TTS, STT, umculo, ukuhumusha: zonke API eyodwa

3
Imali

Izinga elifanayo. Ithuluzi ngalinye libiza amathokheni. Kulula.

Qala ngokushesha

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

Ukulinganisa i-Token

Konke kubiza amathokheni. Izinga elinye kuzo zonke izithuluzi. Intengo efanayo noma ngabe usebenzisa i-API noma iwebhusayithi.

Amamodeli ahlala akhona Ephansi
ImodeliUhloboIzindleko ze-TokenIlayisense
Qwen 3.6 35BChat/Write/CodeAma-token asetshenziswayo (i-input+output)Apache 2.0
FLUX.2 omncaneUkukhiqizwa kwesithombe5,000 tokens/imageApache 2.0
KokoroUmbhalo kuya kumazwi1 token ngamagama angu-4Apache 2.0
faster-whisperUkukhuluma ku-TextAma-token angu-4/sekondi yesandiMIT
AudioLDM 2Ukukhishwa komculo2,000 amathokheni/isiqongoApache 2.0
MadLAD-400Ukuhumusha (450+ izingcezu)Ama-token amanje asetshenziswaApache 2.0
Real-ESRGANUkuphakama kwesithombe500 ama-token/isithombeBSD
I-BRI-MBGUkususa isizinda500 ama-token/isithombeApache 2.0
CogVideoXUkukhiqizwa kwevidiyo30,000 tokens/videoApache 2.0
Stem Separator (Mel-Band RoFormer + SCNet)Ukuhlukaniswa kwezwi500 ama-token/i-trackMIT + Apache-2.0
Amamodeli angaphandle 575 amamodeli

Ufinyelela ku-GPT-6, Claude, Gemini, Llama, DeepSeek kanye neminye imibukiso ye-575. Izindleko ze-Token zisekelwe ku-provider pricing eguqulwe zibe yi-token yethu.

ImodeliUmhlinzeki~Izithonjana zomlayezo ngamunye (500 ngaphakathi, 300 ngaphandle)
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

Uhlu oluphelele lwezimodeli ze-575 ku-/imodeli/. Zonke zisebenzisa i-/v1/chat/ endpoint efanayo: shintsha nje i-model parameter.

Ifomu le-Token

Amamodeli abekwe ngokuzimela: Ukhokha amathokheni asetshenziswayo. Akukho phawulo.

Amamodeli angaphandle: our_tokens = provider_usd_cost × 750,000 × 1.5

Umzekelo: GPT-4o izindleko $0.0025 nge 1,000 i-prompt tokens, ngakho 1,000 i-prompt tokens izindleko $0.0025 x 750,000 x 1.5 = 2,812 tokens kusuka kwi-balance yakho.

I-1.5 markup iyisilinganiso esijwayelekile. Ama-akhawunti anemali ephakeme enyakatho-ntshonalanga akhokha inkontileka ephansi.

Zonke iziqongo eziphelela

Chat / LLM
POST /v1/chat/Chat nganoma iyiphi imodeli (i-hosted noma yangaphandle). Ukusakazwa kuxhaswe.
Isithombe
POST /v1/image/generate/Umbhalo kusithombe (FLUX, SDXL)
POST /v1/image/edit/Ukudweba ngaphakathi, ukudweba ngaphandle, ukudlulisa isitayela
POST /v1/image/enhance/Ukuphakama 2x/4x (Real-ESRGAN)
POST /v1/image/remove-bg/Susa isizinda (BRIA RMBG)
Ividiyo
POST /v1/video/generate/Umbhalo/isithombe kwividiyo (CogVideoX)
Umbhalo kuya kumazwi
POST /v1/tts/Dala ulwimi (Kokoro, Piper, MeloTTS, Chatterbox)
POST /v1/tts/stream/Ukusakazwa kwe-TTS (isikhathi sangempela somsindo)
Ukukhuluma ku-Text
POST /v1/stt/transcribe/Bhala umsindo/ividiyo (faster-whisper, izilimi ezingu-99)
Umculo & Umsindo
POST /v1/music/generate/Dala umculo kusuka kumbhalo ochazayo
POST /v1/music/separate/U vokali/i-stems ehlukene (Mel-Band RoFormer + SCNet)
Amathuluzi ombhalo
POST /v1/write/Dala okuqukethwe (i-essay, i-imeyili, inkondlo, njll.)
POST /v1/code/generate/Dala ikhowudi nganoma iyiphi ulwimi
POST /v1/summarize/Isihloko se-summary
POST /v1/humanize/Yenza umbhalo we-AI uzwakale njengomuntu
POST /v1/detect/Thola okuqukethwe okwenziwe yi-AI
POST /v1/embeddings/Umbhalo ofakwe: BGE-M3 ngokuzenzakalela, noma "model": "embeddinggemma-2" for EmbeddingGemma 2 (768 dims, dimensions 128 to 768, input_type query or document)
IsiZulu
POST /v1/translate/Guqulela umbhalo (MadLAD-400, 450+ izilimi)
POST /v1/ocr/Khipha umbhalo kusuka kuzithombe
Ithuluzi
GET /v1/modelsList all available models (self-hosted + external)
GET /v1/status/{job_id}/Khangela isimo semisebenzi engekho emthethweni
GET /healthUkuhlolwa kwempilo kwe-API

Ukuqinisekisa

Faka isithonjana sakho se-API ku-Authorization header:

Authorization: Bearer sk-free-YOUR_API_KEY

Yonke impendulo ifaka i-free_ai_usage block ebonisa ama-token asetshenziswayo:

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

Izinga lemikhawulo nezinhlelo

Imali elinganayo ye-token kuwebhusayithi ne-API. Akukho mali ehlukile ye-API.

I-PlaneAma-tokenIzicelo ze-API/ngonyakaIzicelo ze-API/minIntengo
Ikhululekile30,000 ngosuku (i-pool ekhululekile)1,00060$0
Isisekelo250,00010,000120$5 ngenyanga
I-Pro1,250,000100,000300$19 ngenyanga
Ibhizinisi6,250,0001,000,000600$49 ngenyanga
I-EnterpriseIphutha1,000,000 ngokuzenzakalela, iphakanyiswe uma kudingeka600 ngokuzenzakalela, iphakanyiswe uma kudingekaOqhagamshelana naye

Amaphakethe e-token atholakalayo: 200K/$5, 1M/$15, 5M/$40. Ama-token angeke aphele.

I-Python SDK ne-CLI

I-Python SDK

Ngena kuwo wonke amathuluzi we-AI kusuka kukhodi yakho ye-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
Umsizi we-CLI Coding

Imahhala, i-open-source alternative ku-Claude Code, Cursor, ne 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 i-token emahhala/izinsuku. BYOK ixhaswe. 575 amamodeli. Isiqephu sosynchronization ne Web IDE.

PyPI Faka futhi umisele umhlahlandlela I-IDE ye-Web

BYOK (Bring Your Own Key)

Sebenzisa izithonjana zakho ze-API kusuka kunoma yimuphi umhlinzeki. I-zero markup, i-zero fees. Free.ai ifaka isicelo.

UmhlinzekiIfomethi lesithonjanaAmamodeliUkuphawula
I-OpenAIsk-proj-xxxGPT-4o, GPT-4o Mini, o1, o3, njll.$0
I-Anthropicsk-ant-xxxClaude Sonnet 4, Opus 4, Haiku, njll.$0
GoogleAIzaSyxxxGemini 2.5 Pro, Flash, njll.$0
Okunyesk-or-xxx etc.575 amamodeli kusuka kuwo wonke ahlinzeki$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

Isici sakho, kusetshenziswa kwakho, i-bill yakho. Akukho kungena. Akukho kukhuphuka kwe-token kusuka ku-Free.ai yakho.

Imibuzo ebuzwa kaningi

Yebo! Ama-akhawunti amahhala athola ama-30K tokens / ngosuku Ama-plans akhokhelwa anikeza ama-tokens amaningi nama-limits aphezulu.

Hayi! Ama-token afanayo, ukuthengiselana okufanayo. Isibalo sakho se-token sihlukaniswa phakathi kwewebhusayithi ne-API. Sebenzisa noma kunjalo, khokha ngokufanayo.

Isigaba esifanayo, shintsha kuphela ipharamitha yemodeli. Umzekelo: "model": "openai/gpt-4o" noma "model": "anthropic/claude-sonnet-4". Uhlu oluphelele ku /models/ noma GET /v1/models.

Yebo! I /v1/chat/ isigaba esiphelile silandela i-OpenAI chat completions format. Ungasebenzisa noma iyiphi i-OpenAI-compatible SDK: shintsha nje i-base URL ku https://api.free.ai bese usebenzisa isithonjana sakho se-Free.ai API.

Yebo! Misela i-"stream": true kusicelo sakho sokuxoxa. Izinsiza zithunyelwa nge-Server-Sent Events (SSE).

Uzothola impendulo engu-402 nomlayezo wephutha. Thenga amathokheni amaningi ku /pricing/ noma ulinde i-pool yakho yansuku zonke emahhala iphinde ibuyiselwe. Amamodeli ahlala akhona akhona ngaphakathi kwemikhawulo yansuku zonke.

Yebo! Zonke imodeli ezihlala ngokwazo ziyi-MIT/Apache 2.0 licensed. Izinto ezikhiqizwe ziyizinto zakho zokusebenziseka kwezokuhweba.

I-self-hosted: isebenza ku-GPU yethu. Ibiza kakhulu, ihamba ngokushesha, ihlala ifihlakele. Engaphandle: i-proxied ku-model provider. Ufinyelela ku-GPT-4, Claude, Gemini, nokuningi. Izindleko eziningi ze-token ngenxa yezindleko ze-API ze-provider.

Thola ikhasi lakho le-akhawunti ku /account/ noma hlola i-free_ai_usage.tokens_charged ezindaweni zonke ze-API.

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

Sifuna u-99.9% uptime, kodwa akukho hlelo oluvela ngoku nge-SLA esemthethweni. Khangela /ukunakekelwa kwempilo ukuqinisekisa isimo sesikhathi sangempela.

I-imeyili hello@free.ai noma uvakashele /contact/. Ama-Pro+ ama-plans athola usizo oluphambili. Izinhlolovo zephutha zifaka i-error_id yokususa iphutha.

Uthando Free.ai? Uthi abangane bakho!

Ufuna okuningi? Bhalisela mahhala: amathokheni angu-30,000 ngosuku Ubhalise

Linganisa leli khasi