API Free.ai
Famaha API iray. Fitaovana AI rehetra. Fandoavana token 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 ny 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 3.6 35B | 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 | 30,000 tokens/video | Apache 2.0 |
| Stem Separator (Mel-Band RoFormer + SCNet) | Fisarahana feo | 500 tokens/track | MIT + Apache-2.0 |
Miditra amin'ny GPT-6, Claude, Gemini, Llama, DeepSeek ary ny sisa amin'ny modely 575. Ny vidin'ny token dia mifototra amin'ny vidiny omen'ny mpamatsy rehefa averina amin'ny tokens.
| Modely | Mpanome tolotra | ~Token isaky ny hafatra (500 ao, 300 mivoaka) |
|---|---|---|
| GPT-4o-mini | OpenAI | ~286 |
| Mistral Nemo | Mistral | ~100 |
| Llama 3.3 70B Instruct | Meta | ~639 |
| Qwen2.5 72B Instruct | Qwen | ~337 |
| DeepSeek V3 | DeepSeek | ~493 |
| GPT-4o | OpenAI | ~4,781 |
Lisitry ny modely 575 feno ao amin'ny /models/. Ny /v1/chat/ no ampiasaina amin'ny farany rehetra: ovao fotsiny ny santionany model.
Modely mikarakara tena: Mividy ny tokens ampiasainao ianao. Tsy misy markup.
Modely ivelany: our_tokens = provider_usd_cost × 750,000 × 1.5
Example: GPT-4o costs $0.0025 per 1,000 prompt tokens, so 1,000 prompt tokens cost $0.0025 x 750,000 x 1.5 = 2,812 tokens from your balance.
Ny 1.5 dia ny tahan'ny sanda tsotra. Ny kaonty manana fandaniana isam-bolana avo dia mandoa ny tahan'ny sanda ambany.
Ireo _toetry ny andro
POST /v1/chat/ | Chat amin'ny modely rehetra (miorina amin'ny tena na ivelany). Fanohanana ny streaming. |
POST /v1/image/generate/ | Soratra mankany amin'ny sary (FLUX, SDXL) |
POST /v1/image/edit/ | Inpaint, outpaint, transfer style |
POST /v1/image/enhance/ | Mampandeha ny habeny 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 lahateny (Kokoro, Piper, MeloTTS, Chatterbox) |
POST /v1/tts/stream/ | Stream TTS (fanaparitahana feo amin'ny fotoana tena izy) |
POST /v1/stt/transcribe/ | Adikao ny feo/sary (faster-whisper, teny 99) |
POST /v1/music/generate/ | Mamorona mozika avy amin'ny soritsoritra |
POST /v1/music/separate/ | Manaisotra ny feo/ny fototra (Mel-Band RoFormer + SCNet) |
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/embeddings/ | Ny famenoana lahabolana: BGE-M3 tsotra, na "model": "embeddinggemma-2" ho an'ny EmbeddingGemma 2 (768 dims, dimensions 128 ka hatramin'ny 768, input_type query na document) |
POST /v1/translate/ | Handikana lahatsoratra (MadLAD-400, teny mihoatra ny 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 | Token | Fitakiana API/volana | Fangatahana API/Min | Haben'ny vidiny |
|---|---|---|---|---|
| Free | 30,000 isan'andro (fivoahana maimaimpoana) | 1,000 | 60 | $0 |
| Fototra | 250,000 | 10,000 | 120 | $5 isam-bolana |
| Pro | 1,250,000 | 100,000 | 300 | $19 isam-bolana |
| Asa | 6,250,000 | 1,000,000 | 600 | $49 isam-bolana |
| Enterprise | Safidy manokana | 1,000,000 tsotra, alefa rehefa misy fangatahana | 600 tsotra, alefa rehefa misy fangatahana | Mpiaty |
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"
PyPI
PyPI
Mpanampy amin'ny fanafangoana CLI
Maimaimpoana, loharano misokatra safidy ho an'ny Claude Code, Cursor, ary GitHub Copilot.
# macOS / Linux
curl -fsSL https://free.ai/install.sh | sh
# Windows (PowerShell)
irm https://free.ai/install.ps1 | iex
# 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 tokens maimaimpoana isan'andro. Ny BYOK no raisina an-tànana. 575 modely. Mifanaraka amin'ny Web IDE ny fotoana.
PyPI Toro-làlana fametrahana sy fikirakirana IDEn'ny tranonkalaBYOK (Ampidiro ny famahao manokana)
Ampiasao ny famaha API anao manokana avy amin'ny mpizara iray. Tsy misy markup, tsy misy sarany. Free.ai dia proxy fotsiny ny fangatahana.
| 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. | 575 modely avy amin'ny 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 /models/ na GET /v1/models."stream": true. Ny valinteny dia alefa amin'ny alalan'ny Server-Sent Events (SSE).free_ai_usage.tokens_charged ao amin'ny valin'ny API tsirairay.pip install free-dot-ai. It wraps every endpoint with typed responses. For coding assistance, install pip install freeai-code. The API also follows OpenAI's format, so you can use the openai Python/Node SDK with our base URL. API docs