Free.ai API
Bir API açarı. Hər AI aləti. Sadə token hesablanması.
İşə başla
API Açarını Al
Tokenlər satın alın, sonra sk-free- açarınızı yaradın
Hər hansı bir son nöqtəni çağır
Chat, şəkillər, TTS, STT, musiqi, tərcümə - hamısı bir API
Tokenlərlə ödəmə
Bir balans. Hər alət token dəyərindədir. Sadə.
Tez Başla
# 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 qiymətləndirməsi
Hər şey tokenlərə başa gəlir. Bütün alətlər üçün eyni balans. API və ya veb saytdan istifadə etsəniz də eyni qiymətə.
| Model | Növ | Token Qiymət | Lisenziya |
|---|---|---|---|
| Qwen 2.5 7B | Chat/Yaz/Kod | Fəal istifadə edilən tokenlər (giriş+çıxış) | Apache 2.0 |
| FLUX.2 Kiçik | Rəsm | 5,000 tokens/image | Apache 2.0 |
| Kokoro | Mətndən Nitqə | 4 xarakter üçün 1 token | Apache 2.0 |
| faster-whisper | Nitqdən Mətnə | Audio | MIT |
| AudioLDM 2 | Musiqi Yarat | 2,000 token/track | Apache 2.0 |
| MadLAD-400 | Tərcümə | İstifadə edilən real tokenlər | Apache 2.0 |
| Real-ESRGAN | Rəsmi Böyüt | Rəsm | BSD |
| BRIA RMBG | Arxa Plan | Rəsm | Apache 2.0 |
| CogVideoX | Video | 30,000 tokens/video | Apache 2.0 |
| Stem Separator (Mel-Band RoFormer + SCNet) | Vokal ayırma | 500 token/track | MIT + Apache-2.0 |
GPT-6, Claude, Gemini, Llama, DeepSeek və 579 modellərinin qalan hissəsinə çıxış əldə edin. Token qiyməti provayderin qiymətinə əsaslanır və bizim tokenlərimizə çevrilir.
| Model | Təklifçi | İsmarış: | Qeydlər |
|---|---|---|---|
| GPT-4-in Mini | OpenAI | ~20 | Çox ucuz, sürətli |
| Gemini 2.0 Flash | ~15 | Çox sürətli | |
| Mistral Nemo | Mistral | ~10 | Böyük dəyər |
| DeepSeek V3 | DeepSeek | ~30 | Qüvvətli fikirləşmə |
| Flame 3.3 70B | Meta | ~25 | Açıq ağırlıqlar |
| Claude Sonnet 4 | Antropik | ~400 | Ən yaxşı keyfiyyət |
| GPT-4o | OpenAI | ~325 | Ən yaxşı keyfiyyət |
| Queen 2.5 72B | Alibaba | ~40 | Böyük, bacarıqlı |
579 modellərinin tam siyahısı /models/ saytındadır. Hamısı eyni /v1/chat/ son nöqtəsi istifadə edir - sadəcə model parametrini dəyişdirin.
Öz-özünə qovşaqlanmış modellər: Siz istifadə etdiyiniz tokenlərin tam dəyərini ödəyirsiniz. Heç bir markup yoxdur.
Xüsusiyyətlər our_tokens = provider_usd_cost × 100,000 × 1.30
Məsələn: GPT-4o 1K prompt tokens üçün $0.0025 dəyərindədir. 1,000 token üçün: $0.0025 × 100,000 × 1.30 = 325 token Sizin balansınızdan.
Bütün Son Nöqtələr
POST /v1/chat/ | Chat hər hansı bir modellə (öz-özünə host edilmiş və ya xarici). Dalğalanma dəstəklənir. |
POST /v1/image/generate/ | Rəsmdə mətn (FLUX, SDXL) |
POST /v1/image/edit/ | Rəsm daxili, rəsm xarici, üslub köçürməsi |
POST /v1/image/enhance/ | 2x/4x artır (Real-ESRGAN) |
POST /v1/image/remove-bg/ | Arxa planı sil |
POST /v1/video/generate/ | Videoya mətn/rəsm (CogVideoX) |
POST /v1/tts/ | Sənəd yaratmaq (Kokoro, Piper, MeloTTS, Chatterbox) |
POST /v1/tts/stream/ | TTS axını (real-time audio chunks) |
POST /v1/stt/transcribe/ | Audio/video transkripti (faster-whisper, 99 dil) |
POST /v1/music/generate/ | Mətn təsvirindən musiqi yaradın |
POST /v1/music/separate/ | Bölünmüş vokallar/sümüklər (Mel-Band RoFormer + SCNet) |
POST /v1/write/ | Məzmun yaradın (əsər, e-poçt, hekayə və s.) |
POST /v1/code/generate/ | Hər hansı bir dildə kod yaradın |
POST /v1/summarize/ | Mətni İcmal Et |
POST /v1/humanize/ | AI mətni insan səsi ver |
POST /v1/detect/ | AI-genered content |
POST /v1/translate/ | Mətni tərcümə et (MadLAD-400, 450+ dil) |
POST /v1/ocr/ | Rəsmlərdən mətni çıxart |
GET /v1/models | List all available models (self-hosted + external) |
GET /v1/status/{job_id}/ | Async iş vəziyyətini yoxla |
GET /health | API sağlamlıq yoxlaması |
Tanıtma
API açarını Authorization başlıqda daxil et:
Authorization: Bearer sk-free-YOUR_API_KEY
Hər cavab istifadə olunan tokenləri göstərən free_ai_usage blokunu ehtiva edir:
{
"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"
}
}
Limitlər və planlar
Veb sayt və API-də eyni token qiymətləndirməsi. Ayrı API qiymətləndirməsi yoxdur.
| Plan | Tokenlər/Ay | API İstəyi/Min | Qiymət |
|---|---|---|---|
| Pulsuz | 30K/gün (pool) | 10 | $0 |
| Əsas | 250K | 30 | $5/ay |
| Pro | 1.25M | 60 | $19/ay |
| İş | 6.25M | 120 | $49/ay |
| Enterprise | Özəl | Özəl | Bağlan |
Token paketləri mövcuddur: 200K/$5, 1M/$15, 5M/$40. Tokenlər heç vaxt bitmir.
Python SDK və CLI
Python SDK
Python kodundan hər bir AI alətinə çıxış əldə et.
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 Kodlama Yardımcısı
Free, Claude Code, Cursor, and GitHub Copilot-a açıq mənbə alternativi.
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 pulsuz tokenlər/gün. BYOK dəstəklənir. 579 modelləri. Web IDE ilə seans sinxronizasiyası.
PyPI PyPI Veb IDEBYOK (Öz Açarınızı Gəldirin)
Hər hansı provayderdən öz API açarlarınızı istifadə edin. Zərf markup, zərərsiz. Free.ai yalnız istəyi proxy edir.
| Təklifçi | Açar şəkli | Modellər | _Marker |
|---|---|---|---|
| OpenAI | sk-proj-xxx | GPT-4o, GPT-4o Mini, o1, o3, və s. | $0 |
| Antropik | sk-ant-xxx | Claude Sonnet 4, Opus 4, Haiku, və s. | $0 |
AIzaSyxxx | Gemini 2.5 Pro, Flash, və s. | $0 | |
| Digər Təqdimatçılar | sk-or-xxx etc. | bütün provayderlərdən 579 modelləri | $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
Açarınız, istifadəniz, hesabınız. Heç bir qeyd yoxdur. Free.ai balansınızdan heç bir token çıxarılmayacaq.
API FAQ
"model": "openai/gpt-4o" ya da "model": "anthropic/claude-sonnet-4". Tam siyahı /models/ ya da GET /v1/models."stream": true söhbət istəyinizdə təyin et. Cavablar Server-Sent Events (SSE) vasitəsilə çatdırılır.free_ai_usage.tokens_charged sahəsi ilə sınayın.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