Free.ai API
Yon kle API. Tout zouti AI. Bidjè token senp.
Kijan li travay
Obtenn yon kle API
Achte tokens, epi jenere clé sk-free- ou a
Apèl nenpòt pwen fen
Chat, imaj, TTS, STT, mizik, tradiksyon — tout yon API
Pay in Tokens
Yon balans. chak zouti koute tokens. senp.
Kòmanse rapid
# 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);
Pri pou token
Tout bagay koute tokens. Yon balans pou tout zouti. Pri menm si ou itilize API a oswa sit entènèt la.
| Modèl | Tipe | Koute | Lisans |
|---|---|---|---|
| Qwen 2.5 7B | Konvèsasyon/Ekri/Kode | Token reyèl itilize (enput+output) | Apache |
| FLUX.1 Schnell | Kreyasyon imaj | 1,000 tokens/image | Apache |
| Kokoro | Tèks pou paleComment | 1 token pou chak 4 chars | Apache |
| faster-whisper | Konvèti pale an tèks | 4 tokens/second of audio | MIT |
| AudioLDM 2 | Pwodiksyon mizik | 2,000 tokens/track | Apache |
| MadLAD-400 | Tradiksyon (450+ lang) | Token reyèl itilize | Apache |
| Real-ESRGAN | Upscaling imaj | 500 tokens/image | BSD |
| BRIA RMBG | Fon | 500 tokens/image | Apache |
| CogVideoX | Kreyasyon videyo | 5,000 tokens/videyo | Apache |
| Demucs | Separasyon Vokal | 500 tokens/track | MIT |
Akses GPT-4, Claude, Gemini, Llama, DeepSeek, ak 340 + plis modèl.Koutim se baze sou pri founisè a konvèti nan nou.
| Modèl | Founisè | ~Token pou chak mesaj | Notifikasyon |
|---|---|---|---|
| GPT-4o Mini | OpenAI | ~20 | Cheap, rapid |
| Gemini 2.0 Flash | ~15 | Trè vit | |
| Mistral Nemo | Mistral | ~10 | Bon valè |
| DeepSeek V3 | DeepSeek | ~30 | Rasonman fò |
| Flame 3.3 70B | Meta | ~25 | Peze louvri |
| Claude Sonnet 4 | Antropolojik | ~400 | Kalite Premium |
| GPT-4o | OpenAI | ~325 | Kalite Premium |
| Qwen 2.5 72B | Alibaba | ~40 | Large, capable |
Lis konplè 346+ modèl nan /apps/. Tout itilize menm pwen fini /v1/chat/ — jis chanje paramèt model.
Self-hosted modèl: Ou peye pou egzakteman tokens itilize. Pa gen markup.
Modèles externes: our_tokens = provider_usd_cost × 100,000 × 1.30
Egzanp: GPT-4o koute $0.0025 pou chak 1K tokens. Pou 1,000 tokens: $0.0025 × 100,000 × 1.30 = 325 tokens soti nan balans ou.
Tout pwen fen
POST /v1/chat/ | Chat ak nenpòt ki modèl (yo te òganize tèt ou oswa ekstèn). Streaming sipòte. |
POST /v1/image/generate/ | Testman pou imaj (FLUX, SDXL) |
POST /v1/image/edit/ | Inpaint, outpaint, style transfer |
POST /v1/image/enhance/ | Upscale 2x/4x (Real-ESRGAN) |
POST /v1/image/remove-bg/ | Fòmilè |
POST /v1/video/generate/ | Testman/imè pou videyo (CogVideoX) |
POST /v1/tts/ | Pwodui pale (Kokoro, Piper, MeloTTS, Chatterbox) |
POST /v1/tts/stream/ | Streaming TTS (tan reyèl audio chunks) |
POST /v1/stt/transcribe/ | Transkripte son/videyo (faster-whisper, 99 lang) |
POST /v1/music/generate/ | Kreye mizik soti nan dekriman tèks |
POST /v1/music/separate/ | Separe vokal/vokal ki pa vokal (Demucs) |
POST /v1/write/ | Kreye kontni (esè, imèl, istwa, elatriye) |
POST /v1/code/generate/ | Pwodui kòd nan nenpòt lang |
POST /v1/summarize/ | Rimèd tèks |
POST /v1/humanize/ | Fè AI tèks son moun |
POST /v1/detect/ | Detekte kontni ki fèt pa AI |
POST /v1/translate/ | Tradiksyon tèks (MadLAD-400, 450+ lang) |
POST /v1/ocr/ | Ekstrè tèks soti nan imaj |
GET /v1/models | List all available models (self-hosted + external) |
GET /v1/status/{job_id}/ | Verifye estati travay asinkron |
GET /health | API sante check |
Auth
Enklude ou API kle nan Authorization tèt la:
Authorization: Bearer sk-free-YOUR_API_KEY
Tout repons gen ladan yon free_ai_usage blokaj ki montre ki kalite tokens ki itilize:
{
"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"
}
}
Limit ak Plan pou Rapò
Pri menm pou chak token sou sit entènèt la ak API a. Pa gen pri API separe.
| Plan | Tokens/Moun | Demands API / min | Pri |
|---|---|---|---|
| Gratis | 5K/jou (pool) | 10 | $0 |
| Baz | 250K | 30 | $5/mo |
| Pro | 1.25M | 60 | $19/mo |
| Biznis | 6.25M | 120 | $49/mo |
| Enterprise | Custom | Custom | Kontak |
Pake tokens ki disponib: 200K/$5, 1M/$15, 5M/$40. tokens pa janm ekspire.
Python SDK & CLI
Python SDK
Akses chak zouti AI nan kòd Python ou.
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
Asistan Kòd CLI
Li se yon altènativ lib ak sous louvri pou Claude Code, Cursor, ak 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"
5K gratis tokens/jou. BYOK sipòte. 346+ modèl. Sesyon sync ak Web IDE.
GitHub PyPI Web IDEBYOK (Pran Chwa Ou)
Itilize pwòp kle API ou soti nan nenpòt founisè. Zèro markup, zèl frè. Free.ai se sèlman pwoksimite demann lan.
| Founisè | Fòmasyon kle | Modèles | Markup |
|---|---|---|---|
| OpenAI | sk-proj-xxx | GPT-4o, GPT-4o Mini, o1, o3, elatriye | $0 |
| Antropolojik | sk-ant-xxx | Claude Sonnet 4, Opus 4, Haiku, etc. | $0 |
AIzaSyxxx | Gemini 2.5 Pro, Flash, elatriye | $0 | |
| Founisè lòt | sk-or-xxx etc. | 346+ modèl soti nan tout founisè | $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
Ou kle, ou itilize, ou bidjè. Pa gen logging. Pa gen dediksyon tokens soti nan balans ou Free.ai.
FAQ
"model": "openai/gpt-4o" oswa "model": "anthropic/claude-sonnet-4". Lis konplè nan /apps/ oswa GET /v1/models."stream": true nan demann konvèsasyon ou a. Reponn yo voye via Eveniman ki voye pa Sèvè (SSE).free_ai_usage.tokens_charged nan chak repons API.pip install free-dot-ai. Li enfliyanse chak pwen fini ak repons ki te ekri. Pou asistans kodaj, enstale pip install free-dot-ai-code. API a tou swiv OpenAI\