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 - ählisi 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 2.5 7B | Chat/Write/Code | Ulanylan hakykat tokeni (giriş+çykyş) | Apache 2.0 |
| FLUX.2 Kiçi | Resim | Resim | 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 579 modelleriň galanyny elýeter edin. Token bahasy biziň tokenlerimize öwürilen prowaýder bahasyna esaslanýar.
| Model | Saýlaw | Islendik islendik | _Ýazy |
|---|---|---|---|
| GPT-4o Kiçi | OpenAI | ~20 | Gysga, tiz |
| Gemini 2.0 Flash | ~15 | Çok tiz | |
| Mistral Nemo | Mistral | ~10 | Beýik baha |
| DeepSeek V3 | DeepSeek | ~30 | Güçli düşünje |
| Llama 3.3 70B | Meta | ~25 | Aç |
| Claude Sonnet 4 | Antropik | ~400 | Beýik hili |
| GPT-4o | OpenAI | ~325 | Beýik hili |
| Qwen 2.5 72B | Alibaba | ~40 | Böyük, başarýan |
579 modyllarň doly sanawy /models/. Ehli birmeňzeş /v1/chat/ ahyryny ulanýar - diňe model parametri üýtgedýär.
Model: Siz ulanylan tokeni töläp bilersiňiz. Markup ýok.
Daşarky modyllar: our_tokens = provider_usd_cost × 100,000 × 1.30
Meselem: GPT-4o her 1K soramak tokeni üçin $0.0025 töleg eder. 1,000 tokeni üçin: $0.0025 × 100,000 × 1.30 = 325 tokeni Siziň balansyňyzdan.
Ehli Sonky
POST /v1/chat/ | Chat her hili model bilen (öz hosty ýa-da daşarky). |
POST /v1/image/generate/ | Resimiň metini (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/resim video (CogVideoX) |
POST /v1/tts/ | Ses bejer |
POST /v1/tts/stream/ | TTS (real-time audio chunks) |
POST /v1/stt/transcribe/ | Awto-Wideo |
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/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/Aý | API Soraglar/Min | _Baj |
|---|---|---|---|
| _Boş | 30K/gün (pool) | 10 | $0 |
| _Başlangyç | 250K | 30 | $5/aý |
| Pro | 1.25M | 60 | $19/aý |
| Iş | 6.25M | 120 | $49/aý |
| Enter | _Özboluşly | _Özboluşly | 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, Kärser we GitHub Copilot üçin azat, açyk çeşme alternatifi.
pip install freeai-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 free tokens/day. BYOK supported. 579 models. Session sync with Web IDE.
PyPI PyPI 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, etc. | $0 | |
| Başga Prowaýderler | sk-or-xxx etc. | ähli berijilerden 579 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