API Free.ai
Famaha API iray. Fitaovana AI rehetra. Fandoavana vola tsotra.
Ahoana ny fomba fiasany
Maka famaha API
Mividy tokens, avy eo mamorona ny famaha sk-free- anao
Antsoy ny Endpoint
Chat, sary, TTS, STT, mozika, fandikan-teny — API iray izy rehetra
Mividy amin'ny token
Vola iray. Ny fitaovana tsirairay dia mandoa vola. Tsotra.
Fiandohana 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": "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);
Famaritana ny vidiny
Ny zava-drehetra 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 | Chat/Write/Code | Token tena ampiasaina (fidirana+fivoahana) | Apache 2.0 |
| FLUX.2 Kely | Famoronana sary | 5,000 tokens/image | Apache 2.0 |
| Kokoro | Soratra ho lasa feo | 1 token isaky ny marika 4 | Apache 2.0 |
| faster-whisper | Hanova ny feo ho lahabolana | Token 4/segondra amin'ny feo | MIT |
| AudioLDM 2 | Famoronana mozika | 2,000 tokens/track | Apache 2.0 |
| MadLAD-400 | Fandikana teny (450+ lang) | Token tena ampiasaina | Apache 2.0 |
| Real-ESRGAN | Fanovana habe | 500 tokens/image | BSD |
| BRIA RMBG | Famoahana ny afara | 500 tokens/image | Apache 2.0 |
| CogVideoX | Famoronana lahatsary | 5,000 tokens/video | Apache 2.0 |
| Demucs | Fisarahana feo | 500 tokens/track | MIT |
Ampidiro ny GPT-4, Claude, Gemini, Llama, DeepSeek, ary ireo modely 340+ hafa. Ny vidin'ny token dia mifototra amin'ny vidiny omen'ny mpamatsy, nanovaina ho tokens.
| Modely | Mpanome tolotra | _Token'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, afaka |
Lisitry ny modely 346+ feno ao amin'ny /models/. mampiasa ny /v1/chat/ endpoint 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 = Token 325 avy amin'ny salinao.
Ireo _toetry ny andro
POST /v1/chat/ | Chat miaraka amin'ny modely iray (miorina amin'ny tena na ivelany). Ny streaming dia raisina an-tànana. |
POST /v1/image/generate/ | Soratra mankany amin'ny sary (FLUX, SDXL) |
POST /v1/image/edit/ | Inpaint, outpaint, transfer style |
POST /v1/image/enhance/ | Ampitomboy 2x/4x (Real-ESRGAN) |
POST /v1/image/remove-bg/ | Foano ny afara (BRIA RMBG) |
POST /v1/video/generate/ | Soratra/sary ho an'ny lahatsary (CogVideoX) |
POST /v1/tts/ | Mamorona laha-teny (Kokoro, Piper, MeloTTS, Chatterbox) |
POST /v1/tts/stream/ | Stream TTS (fanaparitahana feo amin'ny fotoana tena izy) |
POST /v1/stt/transcribe/ | Mandika feo/sarimihetsika (faster-whisper, teny 99) |
POST /v1/music/generate/ | Mamorona mozika avy amin'ny soritsoritra |
POST /v1/music/separate/ | Mamaritra ny feo/fandraisana (Demucs) |
POST /v1/write/ | Mamorona votoaty (fanadihadiana, mailaka, tantara, sns.) |
POST /v1/code/generate/ | Mamorona laha-daza amin'ny teny iray |
POST /v1/summarize/ | Mameno 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/ | Handikana lahabolana (MadLAD-400, teny 450+) |
POST /v1/ocr/ | Mamaky ny lahabolana avy amin'ny sary |
GET /v1/models | List all available models (self-hosted + external) |
GET /v1/status/{job_id}/ | Jereo ny toetran'ny asa asynchronous |
GET /health | Fitsapana ny fahasalaman'ny API |
Fanamarinana
Ampidiro anatin'ny loham-pejy Authorization ny famaha API-nao:
Authorization: Bearer sk-free-YOUR_API_KEY
Misy ny free_ai_usage block 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
Mitovy ny vidin'ny token amin'ny tranonkala sy ny API. Tsy misy API mizara vidiny.
| _Fomba | Tokens/volana | Fangatahana API/Min | Haben'ny vidiny |
|---|---|---|---|
| Free | 30K/andro (fikambanana) | 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 token misy: 200K/$5, 1M/$15, 5M/$40. Tsy miova ny fotoana fiafaran'ny token.
Python SDK & CLI
Python SDK
Miditra amin'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
Maimaimpoana, loharano misokatra safidy ho an'ny Claude Code, Cursor, ary 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"
Token maimaimpoana 30K isan'andro. Tohanan'ny BYOK. Modely 346+. Fifanakalozana session amin'ny Web IDE.
GitHub PyPI IDEn'ny tranonkalaBYOK (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 | 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 fanadihadiana. Tsy misy fanesorana ny token amin'ny Free.ai volavolanao.
Fanontaniana matetika
"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\