Free.ai API
Bọ́tìnì API kan. Àwọn àtòjọ-ẹ̀yàn AI gbogbo. Ìṣàfilọ́lẹ̀ tóké́n.
Bií O ṣe N ṣiṣẹ́
Gba àwọn àwọn àmì-ìwé API
Rá àwọn tókènì, ki o si ṣẹ̀dá bọ́tìnì rẹ̀ sk-free-
Fẹ̀ẹ́ Àwọn Ààyè-iṣẹ́ Mìíràn
Àkọ́kọ́, àwòrán, TTS, STT, ìranṣẹ́, ìfàmúlò-ètò — gbogbo wọn ní API kan
Fi pamọ́ Nínú Àwọn Àmì-ìwé
Ìdáràn kan. Àwọn àtòjọ-ẹ̀yàn ní gbogbo wọn ní owó tókénì. Lárá.
Ìṣàfilọ́lẹ̀ Àìpẹ̀
# 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);
Àwọn Ìjánu-ìṣàmúlò-ètò
Gbogbo ohun ná owó tókénì. Ìbàlẹ̀ kan fun gbogbo àwọn àtòjọ-ẹ̀yàn. Ìbàlẹ̀ kan tí o bá ló API tàbí ojú-ìwé.
| Àwọn ìṣàmúlò-ètò | Àwọn Ìṣàmúlò-ètò | Àwọn Ìgúnrégé | Àwọn Ààyè-iṣẹ́ |
|---|---|---|---|
| Qwen 2.5 7B | Fipalẹ̀/Ṣẹ̀dà/Kóòdù | Àwọn tókè tí a lò (input+output) | Apache |
| FLUX.1 Ìjánu-ìṣàmúlò-ètò | Àwòrán | 1,000 tokens/image | Apache |
| Àwọn àyọkà ìṣàfarawégbèsì | Àkọlé sí Àkọ́kọ́ | Àwọn àmì-ìwé 4 fún àwọn àmì-ìwé 1 | Apache |
| Ìjánu-ìjánu-ìjánu-ìjánu-ìjánu-ìjánu-ìjánu-ìjánu-ìjánu-ìjánu | Àwọn Àkọlé | 4 token/second tí àwòrán | MIT |
| LDM Àwọn Àmì-ìwé | Àwọn àwọn ìṣàfarawé àwọn ìṣàmúlò-ètò | 2,000 tokens/track | Apache |
| Ìṣàmúlò-ètò | Àwọn ìṣàfarawé (450+) | Àwọn tókè tí a lò | Apache |
| Àwọn Àwọn Àwọn Àwọn Àwọn | Ìṣàmúlò-ètò Àwòrán | 500 tokeni/àwòrán | BSD |
| BRIA RMBG | Ìjádé Ààyè-iṣẹ́ | 500 tokeni/àwòrán | Apache |
| CogVideoX | Àwọn àwọn àwòrán | 5,000 tokens/video | Apache |
| Àwọn àyọkà ìṣàfarawégbèsì | Àwọn àwọn ìṣàfarawé àwọn àmì-ìwé | 500 tokeni/àkọ́kọ́ | MIT |
Access GPT-4, Claude, Gemini, Llama, DeepSeek, and 340+ more models. Token cost is based on provider pricing converted to our tokens.
| Àwọn ìṣàmúlò-ètò | Àwọn Ìṣàfilọ́lẹ̀ | Àwọn àmì-ìwé | Àwọn Àmì-ìwé |
|---|---|---|---|
| GPT-4o Kekere | OpenAI | ~20 | Ójútó, àìpẹ́ |
| Gemini 2.0 Fẹ̀ẹ̀ | ~15 | Ààyè-iṣẹ́ | |
| Mistral Nemo | Mistral | ~10 | Àwọn ìkúndùǹ |
| DeepSeek V3 | DeepSeek | ~30 | Ìṣàmúlò-ètò ìṣàfarawé |
| Llama 3.3 70B | Meta | ~25 | Ṣí àwọn àwọn ìwọ̀n |
| Claude Sonnet 4 | Anthropic | ~400 | Àwọn ìṣàfarawé ìpéwọ̀n |
| GPT-4o | OpenAI | ~325 | Àwọn ìṣàfarawé ìpéwọ̀n |
| Qwen 2.5 72B | Alibaba | ~40 | Nlá, àwọn ìṣẹ̀dá |
Full list of 346+ models at /apps/. All use the same /v1/chat/ endpoint — just change the model parameter.
Àwọn ìṣàmúlò-ètò àìṣàfilọ́lẹ̀: Ó fi àwọn tókè tí a lò lójútó. Kò ní àwọn àmì-ìwé.
Àwọn ìṣàmúlò-ètò inú: our_tokens = provider_usd_cost × 100,000 × 1.30
Example: GPT-4o costs $0.0025 per 1K prompt tokens. For 1,000 tokens: $0.0025 × 100,000 × 1.30 = 325 tokens lati igbimọ rẹ.
Àwọn ààyè-iṣẹ́ ìparí
POST /v1/chat/ | Fipa bánúbára pẹ̀lú àwọn móòdù (tí a fi pamọ́ fún ará tabi tí a fi pamọ́ fún ẹ̀yàn). Àtí ìṣàfihàn. |
POST /v1/image/generate/ | Àkọlé sí àwòrán (FLUX, SDXL) |
POST /v1/image/edit/ | Àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn |
POST /v1/image/enhance/ | Ìṣàmúlò-ètò 2x/4x (ESRGAN-Rẹ́ẹ̀lì) |
POST /v1/image/remove-bg/ | Pa àwọn ààyè-iṣẹ́ láti inú àwọn ààyè-iṣẹ́ |
POST /v1/video/generate/ | Àkọlé/ Àwòrán sí àwòrán (CogVideoX) |
POST /v1/tts/ | Ṣẹ̀dà àwọn ìsàlẹ̀-ilà (Kokoro, Piper, MeloTTS, Chatterbox) |
POST /v1/tts/stream/ | TTS Ìjádé (àwọn àyọkà ìsàlẹ̀-ilà nígbà gidi) |
POST /v1/stt/transcribe/ | Ṣàfihàn àwòrán/àwòrán (àtí ìgbọ́wọ́-ìjáde, 99 àwọn ìtàn) |
POST /v1/music/generate/ | Ṣẹ̀dà ìṣàfihàn àwọn àyọkà láti inú àkọlé |
POST /v1/music/separate/ | Ṣàfarawe àwọn àwòrán/àwọn àgbèwọlé (Demucs) |
POST /v1/write/ | Ṣẹ̀dà àwọn ìròyìn (ìwé-ìwé, àìmélì, àwọn ìròyìn, abbl.) |
POST /v1/code/generate/ | Ṣẹ̀dà ìrísí-lẹ́tà nínú ìtàn wòye |
POST /v1/summarize/ | Àwọn àkọlé |
POST /v1/humanize/ | Fi àkọlé AI hàn àwòrán àwọn eniyan |
POST /v1/detect/ | Wa àwọn ààyè-iṣẹ́ tí a ṣẹ̀dà láti inú AI |
POST /v1/translate/ | Ṣàfikún àkọlé (MadLAD-400, 450+ àwọn ìtàn) |
POST /v1/ocr/ | Ṣẹ̀dà àkọlé láti inú àwòrán |
GET /v1/models | List all available models (self-hosted + external) |
GET /v1/status/{job_id}/ | Ṣayẹwo ìṣàmúlò-ètò iṣẹ́ aṣínṣin |
GET /health | Àwọn ìṣàfihàn ìṣàmúlò-ètò |
Àwọn Àwọn Àkọ́gbégbé
Fi bọ́tìnì API rẹ̀ pamọ́ sínú àkọlé Àwọn ìṣàfarawé fún àwọn ìṣàmúlò-ètò:
Authorization: Bearer sk-free-YOUR_API_KEY
Àwọn ìṣàfihàn gbogbo ní àwọn àwọn àyọkà free_ai_usage tí wọ́n ṣàfihàn àwọn tókènì tí a lò:
{
"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"
}
}
Àwọn Ìgbà Ìṣẹ́
Àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn
| Àwọn ààyè-iṣẹ́ | Àwọn Àwọn Àkọ́kọ́ | Àwọn Ìgbégbé API/Min | Àwọn Ìgúnrégé |
|---|---|---|---|
| Àìfẹ́ | 30K/day (pool) | 10 | $0 |
| Àwọn àwọn àwọn àwọn àwọn àwọn | 250K | 30 | $5/oṣu |
| Àwọn Àwọn Àwọn | 1.25M | 60 | $19/oṣu |
| Àwọn iṣẹ́ | 6.25M | 120 | $49/oṣu |
| Àwọn Ìṣàmúlò-ètò | Àwọn ìkúndùǹ | Àwọn ìkúndùǹ | Àwọn Àkọlé |
Àwọn pákì token tí wa: 200K/$5, 1M/$15, 5M/$40. Token kò lè kù.
Python SDK & CLI
Python SDK
Gbaà gbogbo àwọn àtòjọ-ẹ̀yàn AI láti inú ìkódì Python rẹ̀.
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
Àwọn Àkọ́kọ́
Àwọn ìṣàfilọ́lẹ̀ àìfẹ́, àìṣiró-ìṣiró fún Claude Àkọ́kọ́, Àìṣàfilọ́lẹ̀, àti Copilot GitHub.
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 (Ṣé Ìṣàfilọ́lẹ̀ Bọ́tìnì Rẹ̀)
Lo àwọn bọ́tìnì API rẹ̀ láti inú àwọn onímọ́. Kò ní àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn àwọn Free.ai nínú àwọn ìṣàfilọ́lẹ̀ àgbèwọlé.
| Àwọn Ìṣàfilọ́lẹ̀ | Àwọn ìgúnrégé bọ́tìnì | Àwọn ìṣàmúlò-ètò | Àwọn àmì-ìwé |
|---|---|---|---|
| OpenAI | sk-proj-xxx | GPT-4o, GPT-4o Kekere, o1, o3, bbl | $0 |
| Anthropic | sk-ant-xxx | Claude Sonnet 4, Opus 4, Haiku, abbl. | $0 |
AIzaSyxxx | Gemini 2.5 Pro, Flash, abbl. | $0 | |
| Àwọn Àṣẹ Àwọn Mìíràn | sk-or-xxx etc. | 346+ awọn awoṣe lati gbogbo awọn olupese | $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 key, your usage, your bill. No logging. No token deductions from your Free.ai balance.
Àwọn Àtòjọ-ẹ̀yàn
"model": "openai/gpt-4o" tàbí "model": "anthropic/claude-sonnet-4". Àtòjọ ìparí nínú /apps/ tàbí GET /v1/models."stream":true paṣẹ nínú àgbègbè rẹ̀. Àwọn ìṣàfihàn náà tí a fi pamọ́ láti inú Àwọn Àgbègbè-Sáfírí (SSE).free_ai_usage.tokens_charged nínú àwọn ìṣàfihàn API níkan.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's format, so you can use the openai Python/Node SDK with our base URL. GitHub