Free.ai API
Famaha API iray. Fitaovana AI rehetra. Fandoavana vola tsotra.
Ahoana no fiasany
Handray famaha API
Mividy tokens, avy eo mamorona ny famaha sk-free- anao
Antsoy ny Endpoint
Resadresaka, sary, TTS, STT, mozika, fandikan-teny — API iray ihany
Mividy amin'ny tokens
Vola iray. Ny fitaovana tsirairay dia mandoa vola. Tsotra.
Fandefasana haingana
# 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);
Famaritana ny vidiny
Ny zavatra rehetra dia mandany tokens. Vola iray ho an'ny fitaovana rehetra. Samy mitovy ny vidiny na mampiasa ny API na ny tranonkala ianao.
| Modely | Karazana | Ny vidin'ny token | Lisansa |
|---|---|---|---|
| Qwen 2.5 7B | Resadresaka/Soraty/Rakitra | Ny tokens tena nampiasaina (fidirana+fivoahana) | Apache |
| FLUX.1 haingana | Famoronana sary | 1,000 tokens/image | Apache |
| Kokoro | Soratra ho teny miresaka | 1 token isaky ny marika 4 | Apache |
| faster-whisper | Soraty | 4 tokens/second of audio | MIT |
| AudioLDM 2 | Famoronana mozika | 2,000 tokens/track | Apache |
| MadLAD-400 | Fandikana teny (450+ lang) | Ny tokens tena nampiasaina | Apache |
| Real-ESRGAN | Fanovana habe | 500 tokens/image | BSD |
| BRIA RMBG | Fandraisana ny afara | 500 tokens/image | Apache |
| CogVideoX | Famoronana horonantsary | 5,000 tokens/video | Apache |
| Demucs | Fisarahana feo | 500 tokens/track | MIT |
Afaka mampiasa ny GPT-4, Claude, Gemini, Llama, DeepSeek, ary ireo modely 340+ hafa. Ny vidin'ny token dia mifototra amin'ny vidin'ny mpamatsy rehefa averina ho tokens.
| Modely | Mpanome tolotra | ~Token isaky ny hafatra | Fanamarihana |
|---|---|---|---|
| GPT-4o Mini | OpenAI | ~20 | Mora, haingana |
| Gemini 2.0 Flash | ~15 | Tena haingana | |
| Mistral Nemo | Mistral | ~10 | Tsara |
| DeepSeek V3 | DeepSeek | ~30 | Fiheverana matanjaka |
| Llama 3.3 70B | Meta | ~25 | Manokatra ny soratra |
| Claude Sonnet 4 | Anthropic | ~400 | Hatsarana avo lenta |
| GPT-4o | OpenAI | ~325 | Hatsarana avo lenta |
| Qwen 2.5 72B | Alibaba | ~40 | Lehibe, mahay |
Lisitra feno amin'ireo modely mihoatra ny 346 ao amin'ny /apps/. mampiasa ny /v1/chat/ farany mitovy izy rehetra — manova fotsiny ny model parameter.
Modely mikarakara tena: Ny tokens ampiasainao no aloanao. Tsy misy fanondroana.
Modely ivelany: our_tokens = provider_usd_cost × 100,000 × 1.30
Ohatra: GPT-4o dia mitentina $0.0025 isaky ny 1K tokens. Raha 1,000 tokens: $0.0025 × 100,000 × 1.30 = 325 tokens avy amin'ny salinao.
Ireo _tobin'ny farany rehetra
POST /v1/chat/ | Miresaka amin'ny modely rehetra (ao anatin'ny solosaina na ivelany). |
POST /v1/image/generate/ | Soratra ho lasa sary (FLUX, SDXL) |
POST /v1/image/edit/ | Fandefasana loko, fandefasana endrika |
POST /v1/image/enhance/ | Ampitomboy 2x/4x (Real-ESRGAN) |
POST /v1/image/remove-bg/ | Esory ny afara (BRIA RMBG) |
POST /v1/video/generate/ | Soratra/sary ho an'ny lahatsary (CogVideoX) |
POST /v1/tts/ | Mamorona lahateny (Kokoro, Piper, MeloTTS, Chatterbox) |
POST /v1/tts/stream/ | Streaming TTS (fizarazarana feo amin'ny fotoana tena izy) |
POST /v1/stt/transcribe/ | Adikao ho feo/tsary (mipetaka haingana kokoa, teny 99) |
POST /v1/music/generate/ | Mamorona mozika avy amin'ny soritsoritra |
POST /v1/music/separate/ | Manaisotra ny feo/ny feo mivantana (Demucs) |
POST /v1/write/ | Mamorona votoaty (fanadihadiana, mailaka, tantara, sns.) |
POST /v1/code/generate/ | Mamorona laha-daza amin'ny teny iray |
POST /v1/summarize/ | Manoritsoritra ny lahabolana |
POST /v1/humanize/ | Mahatonga ny lahabolana AI ho toy ny feo olombelona |
POST /v1/detect/ | Mizaha ny votoaty novokarin'ny AI |
POST /v1/translate/ | Dikan-tsoratra (MadLAD-400, fiteny 450+) |
POST /v1/ocr/ | Mamaky ny lahabolana ao anatin'ny sary |
GET /v1/models | List all available models (self-hosted + external) |
GET /v1/status/{job_id}/ | Jereo ny toetran'ilay asa asynchronous |
GET /health | Fitsapana ny fahasalaman'ny API |
Fanamarinana
Ampidiro anatin'ny lohateny Authorization ny famaha API-nao:
Authorization: Bearer sk-free-YOUR_API_KEY
Misy free_ai_usage iray mampiseho ny tokens ampiasaina ny valinteny tsirairay:
{
"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"
}
}
Fetra sy drafitra
Mifanaraka amin'ny vidiny eo amin'ny tranonkala sy ny API ny vidiny amin'ny token. Tsy misy vidiny API miavaka.
| _Fomba | Tokens/volana | Fangatahana API/Min | _Hamehana: |
|---|---|---|---|
| Free | 30K/day (pool) | 10 | $0 |
| Fototra | 250K | 30 | $5/volana |
| Pro | 1.25M | 60 | $19/volana |
| Asa | 6.25M | 120 | $49/volana |
| Enterprise | Safidy manokana | Safidy manokana | Mpifandraisana |
Misy ny fonosana tokens misy: 200K/$5, 1M/$15, 5M/$40.
Python SDK & CLI
Python SDK
Afaka mampiasa ny fitaovana AI rehetra avy amin'ny rindran'asa 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
Mpanampy amin'ny fanafangoana CLI
Ny faritr'ora dia GMT+4. : Tranonkala ofisialy IANA.gp Raharaha momba ny.gp, ny.gp, ary ny.gp.
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 (Ampidiro ny famahao manokana)
Ampiasao ny famaha API anao avy amin'ny mpamatsy rehetra. Tsy misy markup, tsy misy sarany. Ny INSEE dia mampiasa ny kaodim-paositra Free.ai.
| Mpanome tolotra | Lamin'ny famaha | Modely | Famaritana |
|---|---|---|---|
| OpenAI | sk-proj-xxx | GPT-4o, GPT-4o Mini, o1, o3, sns. | $0 |
| Anthropic | sk-ant-xxx | Claude Sonnet 4, Opus 4, Haiku, sns. | $0 |
AIzaSyxxx | Gemini 2.5 Pro, Flash, sns. | $0 | |
| Mpanome hafa | sk-or-xxx etc. | 346+ modely avy amin'ireo mpamatsy rehetra | $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
Ny famaha, ny fampiasanao, ny volavolanao. Tsy misy fandraketana. Tsy misy fanesorana ny tokens amin'ny Free.ai vola ao amin'ny kaontinao.
FAQ momba ny API
"model": "openai/gpt-4o" na "model": "anthropic/claude-sonnet-4". Ny lisitra feno dia ao amin'ny /apps/ na GET /v1/models."stream": true anatin'ny fangatahanao amin'ny resaka. Ny valinteny dia alefa amin'ny alalan'ny SSE (Server-Sent Events).free_ai_usage.tokens_charged ao amin'ny valin'ny API tsirairay.pip install free-dot-ai. Mampiditra valinteny voasoratra amin'ny teny miafina ny farany tsirairay. Raha mila fanampiana amin'ny fanoratana rindrankajy, ampidiro ny pip install free-dot-ai-code. Manaraka ny OpenAI ihany koa ny API\