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 | Chat/Ṣẹ̀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 | À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 | Ìṣà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 |
Àwọn ààyè-iṣẹ́ àwọn àwọn ààyè-iṣẹ́
| À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á |
Àtòjọ àwọn àwọn ààyè-iṣẹ́ 346+ ni /models/. Gbogbo wọ́n lo àwọn ààyè-iṣẹ́ /v1/chat/ tí a tí fi pamọ́ - yipada àwọn ààyè-iṣẹ́ model.
À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
Àwọn ààtòjọ-ẹ̀yàn: GPT-4o gbàwò $0.0025 fún àwọn àkóónú àkóónú 1K fún àwọn àtòjọ-ẹ̀yàn. Fún àtòjọ-ẹ̀yàn 1,000: $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 |
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 ààyè-iṣẹ́ | Àwọn Àwọn Àkọ́kọ́ | Àwọn Ìgbégbé API/Min | Àwọn Ìgúnrégé |
|---|---|---|---|
| Àìfẹ́ | 30K/ọ̀jọ́ (àwọn àwọn ààyè-iṣẹ́) | 10 | $0 |
| À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 IDE Wẹ́ẹ̀bùBYOK (Ṣé Ìṣà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 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 fi free-dot-ai pamọ́. Ò fi àwọn ààyè gbogbò pamọ́ nípa àwọn àgbékalẹ̀ tí a tí kọ́. Fún ìrànwọ́ ìṣàfihàn àwọn àkọ́kọ́, fi pip fi free-dot-ai-code pamọ́. API náà tun ń tẹle OpenAI\