Free.ai API
Bir API açary. Her AI esbap. Saýlawly token hasaplama.
Nädip işleýär
Bir API adyny al
Tokenleri satyn al, soňra öz sk-free- adyny döret
Her bir ahtar
Chat, resimler, TTS, STT, müzik, terjime: ähli bir API
Token
Bir balans. Her esbap token bahaly. Basit
Tiz Başlanç
# 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);
Token Price
Her zadyň bahasy token. Her zadyň balansy bir. API ýa-da web saýty ulanyp bir baha.
| Model | _Täze | Token | Lisenziýa |
|---|---|---|---|
| Qwen 3.6 35B | Chat/Write/Code | Ulanylan hakykat tokeni (giriş+çykyş) | Apache 2.0 |
| FLUX.2 Kiçi | Resim | 5,000 tokens/image | Apache 2.0 |
| Kokoro | Metinden Söze | 4 karakter üçin 1 tag | Apache 2.0 |
| faster-whisper | Sözden metin | 4 token/sekund ses | MIT |
| AudioLDM 2 | Müzik | 2,000 tokens/track | Apache 2.0 |
| MadLAD-400 | Terjime | Ullanylan hakyky toklar | Apache 2.0 |
| Real-ESRGAN | Resim | Resim | BSD |
| BRIA RMBG | Arkaplan | Resim | Apache 2.0 |
| CogVideoX | Video | 30,000 tokens/video | Apache 2.0 |
| Stem Separator (Mel-Band RoFormer + SCNet) | Sesler | 500 token/track | MIT + Apache-2.0 |
GPT-6, Claude, Gemini, Llama, DeepSeek we 575 modelleriň galanyny elýeter edin. Token bahasy biziň tokenlerimize öwürilen prowaýder bahasyna esaslanýar.
| Model | Saýlaw | ~Tokens per message (500 in, 300 out) |
|---|---|---|
| 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 |
575 modyllarň doly sanawy /models/. Ehli bir /v1/chat/ ahyryny ullan: diňe model parametri üýtget.
Model: Siz ulanylan tokeni töläp bilersiňiz. Markup ýok.
Daşarky modyllar: our_tokens = provider_usd_cost × 750,000 × 1.5
Meselem: GPT-4o her 1,000 soraň tokeni üçin $0.0025 töleg eder, şonuň üçin 1,000 soraň tokeni $0.0025 x 750,000 x 1.5 = 2,812 tokeni siziň balansyňyzdan töleg eder.
1.5 markup standart bahadyr. Ýokary aýlyk sarp ediji hasaplar az bahaly satýarlar.
Ehli Sonky
POST /v1/chat/ | Chat her hili model bilen (öz-özüne ýa-da daşarky). |
POST /v1/image/generate/ | Metinden resime (FLUX, SDXL) |
POST /v1/image/edit/ | Resim Içi, Resim Çykyşy, Resim Ýüpek |
POST /v1/image/enhance/ | 2x/4x ölçegini artdyr (Real-ESRGAN) |
POST /v1/image/remove-bg/ | Arkaplany _çykar |
POST /v1/video/generate/ | Metin/resimden wideo (CogVideoX) |
POST /v1/tts/ | Generate speech (Kokoro, Piper, MeloTTS, Chatterbox) |
POST /v1/tts/stream/ | TTS (real-time audio chunks) |
POST /v1/stt/transcribe/ | Awdio/wideony terjime et (faster-whisper, 99 dil) |
POST /v1/music/generate/ | Metin beýanyndan müzik döred |
POST /v1/music/separate/ | Özel vokallar/sözler (Mel-Band RoFormer + SCNet) |
POST /v1/write/ | Mazmuny döret (esej, e-poçta, hekaýa, we ş.m.) |
POST /v1/code/generate/ | Her hili dilde kod döred |
POST /v1/summarize/ | Metin jemle |
POST /v1/humanize/ | AI metin adam sesi ber |
POST /v1/detect/ | Aý-emeli mazmuny tap |
POST /v1/embeddings/ | Metin äpişgeleri: BGE-M3 öň bellenen, ýa-da "model": "embeddinggemma-2" for EmbeddingGemma 2 (768 dims, dimensions 128 to 768, input_type query or document) |
POST /v1/translate/ | Metini terjime et (MadLAD-400, 450+ dil) |
POST /v1/ocr/ | Metinleri resimlerden çykar |
GET /v1/models | List all available models (self-hosted + external) |
GET /v1/status/{job_id}/ | Async işiň haltyny barla |
GET /health | API saglyk barlagy |
Tanyşlyk
API adyny Authorization başlygda goş:
Authorization: Bearer sk-free-YOUR_API_KEY
Her jogap bir free_ai_usage bloky içer we ulanylan tokeni görkezýär:
{
"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"
}
}
Planlar
Web saýtda we APIde birmeňzeş token bahasy. Özbeginde API bahasy ýok.
| Plan | Tokenler | API soraglar/aý | API Soraglar/Min | _Baj |
|---|---|---|---|---|
| _Boş | 30,000 a day (free pool) | 1,000 | 60 | $0 |
| _Başlangyç | 250,000 | 10,000 | 120 | $5 a month |
| Pro | 1,250,000 | 100,000 | 300 | $19 a month |
| Iş | 6,250,000 | 1,000,000 | 600 | $49 a month |
| Enter | _Özboluşly | 1,000,000 öň bellenen, islendik soragda galdyrylan | 600 öň bellenen, islendik soragda galdyrylan | Baglanyş |
Elýeterli token paketleri: 200K/$5, 1M/$15, 5M/$40. Tokenler hiç wagt gutarmaz.
Python SDK we CLI
Python SDK
Python kodyňyzdan her bir AI esbaby ulanyň.
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
CLI Ködleme Yardımçysy
Claude Kod, Kursor we GitHub Copilot üçin azat, açyk çeşme alternatifi.
# 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 free tokens/day. BYOK supported. 575 models. Session sync with Web IDE.
PyPI Oýlap tap Web IDEBYOK (Öz alybyňy getir)
Her haçan bir üpjün edijiden öz API açarlaryňy ullan. Sıfr markap, sıfr tölegler. Free.ai diňe soragy proksy edip dur.
| Saýlaw | Ady | Modeller | Markup |
|---|---|---|---|
| OpenAI | sk-proj-xxx | GPT-4o, GPT-4o Mini, o1, o3, we ş.m. | $0 |
| Antropik | sk-ant-xxx | Claude Sonnet 4, Opus 4, Haiku, etc. | $0 |
AIzaSyxxx | Gemini 2.5 Pro, Flash, we ş.m. | $0 | |
| Başga Prowaýderler | sk-or-xxx etc. | ähli berijilerden 575 modyller | $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
Siziň alyçyňyz, siziň ulanmakyňyz, siziň hasapyňyz. Ýok loglamak. Ýok Free.ai balansyňyzdan token düşürmek.
Häzirlikçe soralýan soraglar
"model": "openai/gpt-4o" or "model": "anthropic/claude-sonnet-4". Tam liste /models/ ya da GET /v1/models."stream": true-i gepleşige soragyňda belle. Ýagşylar Serwer-Gitdiren Wajyplar (SSE) arkaly iberilýär.free_ai_usage.tokens_charged meýdançany barlaň.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