Free.ai API
Isithonjana se-API esisodwa. Yonke into ye-AI. Ukukhokha okulula.
Indlela isebenza ngayo
Thola isithonjana se-API
Thenga ama-token, bese udala isithonjana sakho sk-free-
Dlula noma yisiphi isiqephu esiphelile
Ukuxhumana, izithombe, TTS, STT, umculo, ukuhumusha — konke kuyi-API eyodwa
Imali nge-token
Izinga elinye. 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": "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);
Ukuthengiselana okuzenzakalelayo
Konke kubiza amathokheni. Isilinganiso esisodwa sazo zonke izinto. Intengo efanayo noma ngabe usebenzisa i-API noma iwebhusayithi.
| Imodeli | Uhlobo | Izindleko ze-Token | Ilayisense |
|---|---|---|---|
| Qwen 2.5 7B | Ukukhuluma/Writing/Code | Ama-token asetshenziswayo (i-input+output) | Apache 2.0 |
| FLUX.1 ekhawulezayo | Ukukhiqizwa kwesithombe | 1,000 i-token/isithombe | Apache 2.0 |
| I-Kokoro | Umbhalo kuya kumazwi | 1 token ngamagama angu-4 | Apache 2.0 |
| i-faster-whisper | Ukukhuluma kuMbhalo | 4 ama-token/sekondi yomsindo | I-MIT |
| UmsindoLDM 2 | Ukukhishwa komculo | 2,000 amathokheni/isiqongo | Apache 2.0 |
| I-MadLAD-400 | Ukuhumusha (450+ izingcezu) | Ama-token asetshenziswayo | Apache 2.0 |
| I-Real-ESRGAN | Ukuphakama kwesithombe | 500 ama-token/isithombe | BSD |
| I-BRI-MBG | Ukususa isizinda | 500 ama-token/isithombe | Apache 2.0 |
| CogVideoX | Ukukhiqizwa kwevidiyo | 5,000 ama-token/ividiyo | Apache 2.0 |
| I-Demucs | Ukuhlukaniswa kwezwi | 500 ama-token/i-track | I-MIT |
Ufinyelela GPT-4, Claude, Gemini, Llama, DeepSeek, kanye ne-340+ nezinye izimo. Izindleko ze-token zisekelwe ku-provider pricing eguqulwe zibe yi-token yethu.
| Imodeli | Umhlinzeki | ~Izithonjana ngomlayezo ngamunye | Amabhukwana |
|---|---|---|---|
| GPT-4o Mini | I-OpenAI | ~20 | Intengo ephansi, ishesha |
| Gemini 2.0 Flash | ~15 | Qhubeka kakhulu | |
| Mistral Nemo | Mistral | ~10 | Ixabiso elikhulu |
| DeepSeek V3 | DeepSeek | ~30 | Ukucabanga okuqinile |
| Llama 3.3 70B | I-meta | ~25 | Vula izithako |
| Claude Sonnet 4 | I-Anthropic | ~400 | Ubunjani obuphezulu |
| GPT-4o | I-OpenAI | ~325 | Ubunjani obuphezulu |
| Qwen 2.5 72B | i-Alibaba | ~40 | Okukhulu, okukwaziyo |
Uhlu oluphelele lwezimodeli ezingu-346+ ku-/apps/. Zonke zisebenzisa i /v1/chat/ ekugcineni — shintsha nje i model parameter.
Amamodeli abekwe ngokuzimela: Ukhokha ama-token asetshenziswayo. Akukho uphawu.
Imodeli yangaphandle: our_tokens = provider_usd_cost × 100,000 × 1.30
Umzekelo: GPT-4o ibiza $0.0025 nge-1K ye-prompt tokens. I-1,000 tokens: $0.0025 × 100,000 × 1.30 = Ama-token angama-325 kusuka eqenjini lakho.
Zonke iziqongo
POST /v1/chat/ | Xhumana nanoma iyiphi imodeli (i-self-hosted noma yangaphandle). Ukusakazwa kuxhaswe. |
POST /v1/image/generate/ | Umbhalo kusithombe (FLUX, SDXL) |
POST /v1/image/edit/ | Ukudweba ngaphakathi, ukudweba ngaphandle, ukudluliswa kwesitayela |
POST /v1/image/enhance/ | Upscale 2x/4x (Real-ESRG) |
POST /v1/image/remove-bg/ | Susa isizinda (BRIA RMBG) |
POST /v1/video/generate/ | Umbhalo/isithombe kwividiyo (CogVideoX) |
POST /v1/tts/ | Dala ulwimi (Kokoro, Piper, MeloTTS, Chatterbox) |
POST /v1/tts/stream/ | Ukusakazwa kwe-TTS (isikhathi sangempela somsindo) |
POST /v1/stt/transcribe/ | Bhala umsindo/ividiyo (i-faster-whisper, 99 languages) |
POST /v1/music/generate/ | Dala umculo kusuka kumbhalo ochazayo |
POST /v1/music/separate/ | U vokali/i stems (Demucs) |
POST /v1/write/ | Dala okuqukethwe (i-essay, i-imeyili, inkondlo, njll.) |
POST /v1/code/generate/ | Dala ikhowudi nganoma iyiphi ulwimi |
POST /v1/summarize/ | Gcwalisa umbhalo |
POST /v1/humanize/ | Yenza umbhalo we-AI uzwakale njengomuntu |
POST /v1/detect/ | Thola okuqukethwe okukhishwe yi-AI |
POST /v1/translate/ | Guqulela umbhalo (MadLAD-400, 450+ izilimi) |
POST /v1/ocr/ | Khipha umbhalo kusuka kuzithombe |
GET /v1/models | List all available models (self-hosted + external) |
GET /v1/status/{job_id}/ | Khangela isimo semisebenzi engekho emsakazweni |
GET /health | Ukuhlolwa kwempilo kwe-API |
Ukuqinisekiswa
Faka isithonjana sakho se-API ku Igunyazo okubhalwe emantla ephepha:
Authorization: Bearer sk-free-YOUR_API_KEY
Uphendulo ngalunye lufaka i free_ai_usage block ebonisa ama-token asetshenziswa:
{
"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
Intengo ye-token efanayo kwiwebhusayithi ne-API. Akukho ntengo ye-API ehlukile.
| I-Plan | Ama-token/inyanga | Izicelo ze-API/min | Intengo |
|---|---|---|---|
| Ikhululekile | 30K/day (pool) | 10 | $0 |
| Isisekelo | 250K | 30 | $5/ngonyaka |
| I-Pro | 1.25M | 60 | $19/ngonyaka |
| Ibhizinisi | 6.25M | 120 | $49/ngonyaka |
| I-Enterprise | Iphutha | Iphutha | Oqhagamshelana 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"
GitHub
PyPI
Usizo lokuhlela CLI
Imahhala, i-open-source enye indlela ye-Claude Code, Cursor, ne 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 IDEBYOK (Bring Your Own Key)
Sebenzisa izinkinobho zakho ze-API kusuka kunoma yimuphi umhlinzeki. I-zero markup, i-zero fees. Free.ai ifaka isicelo.
| Umhlinzeki | Ifomethi lesithonjana | Amamodeli | Uphawu |
|---|---|---|---|
| I-OpenAI | sk-proj-xxx | GPT-4o, GPT-4o Mini, o1, o3, njll. | $0 |
| I-Anthropic | sk-ant-xxx | Claude Sonnet 4, Opus 4, Haiku, njll. | $0 |
AIzaSyxxx | Gemini 2.5 Pro, Flash, njll. | $0 | |
| Okunye | sk-or-xxx etc. | 346+ amamodeli kusuka kuwo wonke abahlinzeki | $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
Isithonjana sakho, ukusetshenziswa kwakho, i-bill yakho. Akukho kungena. Akukho kukhuphuka kwe-token kusuka ku-Free.ai yakho.
Imibuzo ebuzwa kaningi
"model": "openai/gpt-4o" noma "model": "anthropic/claude-sonnet-4". Uhlu oluphelele ku /apps/ noma GET /v1/models."stream": true kusicelo sakho sokuxoxa. Izinsiza zithunyelwa nge-Server-Sent Events (SSE).free_ai_usage.tokens_charged endaweni ngayinye ye-API.pip install free-dot-ai. Ifaka yonke indawo yokuqeda ngemiphumela ebhalwe. Usizo lokudweba, faka pip install free-dot-ai-code. I-API ilandela futhi i-OpenAI\