Famaha API iray. Fitaovana AI rehetra. Fandoavana vola tsotra.
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.
# 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);
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 | Chat/Write/Code | 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.
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 |
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"
}
}
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/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 tokens misy: 200K/$5, 1M/$15, 5M/$40.
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
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"
Token maimaimpoana 30K isan'andro. Tohanan'ny BYOK. Modely 346+. Fifanakalozana session amin'ny Web IDE.
GitHub PyPI IDEn'ny tranonkalaAmpiasao 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.
"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\