Free.ai API
Бир API калити. Ҳар бир AI асбоби. Оддий токен ҳисоб-китоби.
У қандай ишлайди
API калитини олиш
Токенларни сотиб олиб, кейин sk-free- калитингизни яратинг
Ҳар қандай якуний нуқтани чақириш
Chat, тасвирлар, TTS, STT, мусиқа, таржима - ҳаммаси бир API
Токенлар билан тўлаш
Бир баланс. Ҳар бир асбоб учун белгилар сарфланади. Оддий.
Тез бошланиш
# 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);
Токен нархлари
Ҳаммаси токенлар эвазига. Барча воситалар учун бир баланс. API ёки веб-сайтдан фойдалансангиз ҳам, нархлар бир хил.
| Модель | Тури | Токен қиймати | Лицензия |
|---|---|---|---|
| Qwen 2.5 7B | Chat/Ёзиш/Коди | Фойдаланган реал токенлар (кириб+чиқиб) | Apache 2.0 |
| FLUX.2 Кичик | Расм яратиш | 5,000 тош/расм | Apache 2.0 |
| Kokoro | Матндан сўзга | 4 белги учун 1 очко | Apache 2.0 |
| faster-whisper | Матнга сўзлаш | Аудионинг 4 токен/секунда | MIT |
| AudioLDM 2 | Мусиқа яратиш | 2000 очко/йўлланма | Apache 2.0 |
| MadLAD-400 | Таржима (450+ тил) | Фойдаланган реал токенлар | Apache 2.0 |
| Real-ESRGAN | Расмнинг катталашиши | 500 тош/сурат | БСД |
| БРИА RMBG | Орқа фонни олиб ташлаш | 500 тош/сурат | Apache 2.0 |
| CogVideoX | Видео яратиш | 30,000 tokens/video | Apache 2.0 |
| Stem Separator (Mel-Band RoFormer + SCNet) | Вокал ажратиш | 500 очко/йўлланма | MIT + Apache-2.0 |
GPT-6, Claude, Gemini, Llama, DeepSeek ва бошқа 579 моделларига кириш. Токен қиймати бизнинг токенларимизга айлантирилган провайдер нархига асосланган.
| Модель | Провайдер | Хабар учун ~Tokens | Ёдлаш |
|---|---|---|---|
| GPT-4o Мини | OpenAI | ~20 | Оғир, тез |
| Gemini 2.0 Flash | ~15 | Жуда тез | |
| Mistral Nemo | Mistral | ~10 | Кўп қийматли |
| DeepSeek V3 | DeepSeek | ~30 | Қудратли фикрлаш |
| Llama 3.3 70B | Мета | ~25 | Очиқ вазнлар |
| Claude Sonnet 4 | Антропик | ~400 | Premium сифати |
| GPT-4o | OpenAI | ~325 | Premium сифати |
| Qwen 2.5 72B | Алибаба | ~40 | Кўп, қодир |
579 моделларининг тўлиқ рўйхати /models/ да. Ҳаммаси бир хил /v1/chat/ охирини қўллайди - фақат model параметрини ўзгартиринг.
Ўз-ўзини хост қилувчи моделлар: Сиз фойдаланилган токенлар учун тўлаяпсиз. Ҳеч қандай маржа йўқ.
Ташқи моделлар: our_tokens = provider_usd_cost × 100,000 × 1.30
Мисол: GPT-4o ҳар бир 1K prompt token учун $0.0025 қийматга эга. 1,000 token учун: $0.0025 × 100,000 × 1.30 = 325 та тош Сизнинг тарозунгиздан.
Барча якуний нуқталар
POST /v1/chat/ | Chat ҳар қандай модел билан (ўзига хос ёки ташқи). Стрим қўллаб-қувватланади. |
POST /v1/image/generate/ | Расмга матн (FLUX, SDXL) |
POST /v1/image/edit/ | Инпринтинг, аутропринтинг, услублар кўчириш |
POST /v1/image/enhance/ | 2x/4x ўлчамли (Real-ESRGAN) |
POST /v1/image/remove-bg/ | Орқа фонни олиб ташлаш (BRIA RMBG) |
POST /v1/video/generate/ | Видеога матн/расм (CogVideoX) |
POST /v1/tts/ | Сўзлашув яратиш (Kokoro, Piper, MeloTTS, Chatterbox) |
POST /v1/tts/stream/ | TTS (реал вақтдаги аудио парчалар) узатиш |
POST /v1/stt/transcribe/ | Аудио/видеони транскрипция қилиш (faster-whisper, 99 тил) |
POST /v1/music/generate/ | Матн таърифидан мусиқа яратиш |
POST /v1/music/separate/ | Айри овозлар/томчиларни ажратиш (Mel-Band RoFormer + SCNet) |
POST /v1/write/ | Мазмунни яратиш (эссе, электрон почта, мақола ва ҳоказо) |
POST /v1/code/generate/ | Ҳар қандай тилда код яратиш |
POST /v1/summarize/ | Матнни қисқартириш |
POST /v1/humanize/ | AI матнини инсон товушига айлантиринг |
POST /v1/detect/ | AI-янгиланган мазмунни аниқлаш |
POST /v1/translate/ | Матнни таржима қилиш (MadLAD-400, 450+ тил) |
POST /v1/ocr/ | Расмлардан матнни ажратиш |
GET /v1/models | List all available models (self-hosted + external) |
GET /v1/status/{job_id}/ | Асинхрон иш ҳолатини текшириш |
GET /health | API соғлиғини текшириш |
Тасдиқлаш
API калитингизни Authorization бошлигига киритинг:
Authorization: Bearer sk-free-YOUR_API_KEY
Ҳар бир жавобда фойдаланилган токенларни кўрсатувчи free_ai_usage блоки мавжуд:
{
"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"
}
}
Ҳисоблаш миқдори ва режалар
Веб-сайт ва API'да бир хил қиймат. Айрим API'лар учун алоҳида қиймат йўқ.
| План | Токенлар/ой | API сўровлари/мин | Нарх |
|---|---|---|---|
| Обод | 30K/кун (пул) | 10 | $0 |
| Асосий | 250K | 30 | $5/ой |
| Про | 1.25M | 60 | ойига |
| Иш | 6.25M | 120 | ой |
| Корхона | Бошқа | Бошқа | Алоқа |
Қонунда мавжуд бўлган токен пакетлари: 200K/$5, 1M/$15, 5M/$40. Токенлар ҳеч қачон тугамайди.
Python SDK ва CLI
Python SDK
Python кодингиздан ҳар бир AI асбобига кириш.
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 кодлаш ёрдамчиси
Claude код, курсор ва GitHub Copilot учун бепул, очиқ манбали алтернатив.
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 бепул токенлар. BYOK қўллаб-қувватланади. 579 моделлари. Сеанс Web IDE билан синхронлаштирилади.
PyPI PyPI Веб IDEBYOK (ўз қулфингизни келтиринг)
Ҳар қандай провайдердан ўз API калитларини қўллаш. Ҳеч қандай маржа, ҳеч қандай тўловлар. Free.ai фақатгина илтимосни прокси орқали бажаради.
| Провайдер | Калит шакли | Намуналар | Маркировка |
|---|---|---|---|
| OpenAI | sk-proj-xxx | GPT-4o, GPT-4o Mini, o1, o3, ва ҳоказо | $0 |
| Антропик | sk-ant-xxx | Claude Sonnet 4, Opus 4, Haiku, ва ҳоказо | $0 |
AIzaSyxxx | Gemini 2.5 Pro, Flash, ва ҳоказо | $0 | |
| Бошқа провайдерлар | sk-or-xxx etc. | Барча провайдерлардан 579 моделлари | $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
Сизнинг калитингиз, сизнинг фойдаланишингиз, сизнинг ҳисобингиз. Ҳеч қандай ёзув йўқ. Сизнинг Free.ai балансингиздан ҳеч қандай чекловлар йўқ.
API FAQ
"model": "openai/gpt-4o" ёки "model": "anthropic/claude-sonnet-4". /models/ ёки GET /v1/models да тўлиқ рўйхат."stream": true ўрнатинг. Жавоблар Сервер-Юборилган Ҳодисалар (SSE) орқали етказилади.free_ai_usage.tokens_charged майдонни текширинг.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