Free.ai API
Yon kle API. Tout zouti AI. Simple token billing.
Kijan li travay
Jwenn yon API Key
Achte tokens, Lè sa a, jenere ou sk-free- kle
Appeler n'importe quel point de fin
Chat, imaj, TTS, STT, mizik, tradiksyon - tout yon API
Payer en Tokens
Yon balans. chak zouti koute tokens. senp.
Enstalasyon 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": "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);
Pri 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 | Chat/Write/Code | Tokens reyèl itilize (enpòte+rezulte) | Apache 2.0 |
| FLUX.2 Klein | Pwodiksyon imaj | 5,000 tokens/image | Apache 2.0 |
| Kokoro | Tèks pou pale | 1 token pou chak 4 chars | Apache 2.0 |
| faster-whisper | Konvèti pale an tèks | 4 tokens/second of audio | MIT |
| AudioLDM 2 | Pwodiksyon mizik | 2,000 tokens/track | Apache 2.0 |
| MadLAD-400 | Tradiksyon (450+ lang) | Token reyèl itilize | Apache 2.0 |
| Real-ESRGAN | Upscaling imaj | 500 tokens/image | BSD |
| BRIA RMBG | Fon | 500 tokens/image | Apache 2.0 |
| CogVideoX | Kreyasyon videyo | 5,000 tokens/videyo | Apache 2.0 |
| Demucs | Separasyon Vokal | 500 tokens/track | MIT |
Accéder GPT-4, Claude, Gemini, Llama, DeepSeek, ak 340+ plis modèl. Koute a se baze sou pri a nan founisè a konvèti nan tokens nou yo.
| 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 |
| Claude Sonnet 4 | Anthropic | ~400 | Kalite Premium |
| GPT-4o | OpenAI | ~325 | Kalite Premium |
| Qwen 2.5 72B | Alibaba | ~40 | Wotè: |
Tout moun itilize menm /v1/chat/ pwent fin — jis chanje model paramèt.Liy konplè nan 346+ modèl nan /models/.
Modèles auto- hébergés: 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 pwent bout
POST /v1/chat/ | Chat ak nenpòt modèl (yo te òganize tèt li oswa ekstèn). Streaming sipòte. |
POST /v1/image/generate/ | Teks 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/ | Teks/imèl pou videyo (CogVideoX) |
POST /v1/tts/ | Kreye yon 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 nan dekriman tèks |
POST /v1/music/separate/ | Separe vokal/vokal ki pa parèt (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/ | Rimanbre tèks |
POST /v1/humanize/ | Fè AI tèks son moun |
POST /v1/detect/ | Detekte kontni AI-genre |
POST /v1/translate/ | Tradiksyon tèks (MadLAD-400, 450+ lang) |
POST /v1/ocr/ | Ekstrè tèks nan imaj |
GET /v1/models | List all available models (self-hosted + external) |
GET /v1/status/{job_id}/ | Tcheke estati travay asinkron |
GET /health | API sante check |
Auth
Enklude kle API ou nan Authorization endèks la:
Authorization: Bearer sk-free-YOUR_API_KEY
Tout repons gen ladan yon free_ai_usage blokaj ki montre tokens 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 pousantaj
Pri menm pou chak token sou sit entènèt la ak API a. Pa gen pri API separe.
| Plan | Tokens/Moun | API demann / min | Pri |
|---|---|---|---|
| Gratis | 30K/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 disponib: 200K/$5, 1M/$15, 5M/$40. Tokens pa janm fini.
Python SDK & CLI
Python SDK
Aksese tout 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
Gratis, open-source altènatif a Claude Kode, 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"
30K gratis tokens/jou. BYOK sipòte. 346+ modèl. Sesyon sync ak Web IDE.
GitHub PyPI IDE EntènètBYOK (Pran chenn ou)
Itilize pwòp kle API ou soti nan nenpòt founisè. Zèb markup, zèl frè. Free.ai se sèlman pwoksimite demann lan.
| Founisè | Fòmasyon kle | Modèl | Baliz |
|---|---|---|---|
| OpenAI | sk-proj-xxx | GPT-4o, GPT-4o Mini, o1, o3, elatriye | $0 |
| Anthropic | sk-ant-xxx | Claude Sonnet 4, Opus 4, Haiku, elatriye | $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 logs. 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\