Free.ai API
Бир API ачкыч. Ар бир AI аспабы. Жакшы токендик эсептөө.
Кантип иштейт
API ачкычын алуу
Токендерди сатып алып, андан кийин sk-free- ачкычын генерациялоо
Ар бир аяктоо пунктун чакыруу
Чат, сүрөттөр, 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": "flux-schnell"}'
# 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": "flux-schnell", # 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: "flux-schnell" })
});
// 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 | Чат/Жазуу/Код | Фактикалык колдонулган токендер (кирүү+чыгыш) | Apache 2.0 |
| Жылдам | Сүрөттү жаратуу | 1000 символ/сүрөт | Apache 2.0 |
| Кокоро | Тексттен сүйлөөгө | 1 символ үчүн 4 символ | Apache 2.0 |
| тез-шыбыр | Сөздөн текстке | 4 иконка/секунда аудио | МИТ |
| Аудио LDM 2 | Музыкалык генератор | 2000 жетон/жолчолу | Apache 2.0 |
| MadLAD-400 | Таржима (450+ лонги) | Фактикалык колдонулган токендер | Apache 2.0 |
| Эскертүү | Сүрөт масштабын жогорулатуу | 500 символ/сүрөт | BSD |
| БРИА RMBG | Фонду өчүрүү | 500 символ/сүрөт | Apache 2.0 |
| CogVideoX | Видеону жаратуу | 5000 жетон/видео | Apache 2.0 |
| Демукстар | Вокалдык бөлүү | 500 жетон/жолчолу | МИТ |
GPT-4, Claude, Gemini, Llama, DeepSeek жана 340+ моделдерге кирүү. Токендин баасы биздин токендерге которулган провайдердин баасына негизделген.
| Модель | Провайдер | ~Жаңылык | Заметки |
|---|---|---|---|
| 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 | Жогорку сапат |
| GPT-4o | OpenAI | ~325 | Жогорку сапат |
| Qwen 2.5 72B | Алибаба | ~40 | Чоң, күчтүү |
346+ моделдин толук тизмеси /apps/. Бардыгы бирдей /v1/chat/ аяктоо пунктун колдонот — жөн гана model параметрин өзгөртүңүз.
Өзүн-өзү тейлеген моделдер: Сиз колдонулган токендердин суммасын төлөйсүз. Маркировка жок.
Тышкы моделдер: our_tokens = provider_usd_cost × 100,000 × 1.30
Мисалы: GPT-4o бир 1K суроо-талап үчүн $0.0025 турат. 1,000 суроо-талап үчүн: $0.0025 × 100,000 × 1.30 = 325 жетон балансыңыздан.
Бардык аяктоо пункттары
POST /v1/chat/ | Ар кандай модель менен баарлашуу (өздүк же сырткы). Стриминг колдойт. |
POST /v1/image/generate/ | Тексттен сүрөткө (FLUX, SDXL) |
POST /v1/image/edit/ | Стильдердин көчүрмөсү |
POST /v1/image/enhance/ | Масштабдоо 2x/4x (Real-ESRN) |
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/ | Аудио/видео транскрипциялоо (99 тилде) |
POST /v1/music/generate/ | Тексттик баяндамадан музыканы жаратуу |
POST /v1/music/separate/ | Вокал/Стеммдерди бөлүү (Demucs) |
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 суроолору/мин | Баасы |
|---|---|---|---|
| Акысыз | 5K/күн (пул) | 10 | $0 |
| Баштапкы | 250K | 30 | $5/ай |
| Про | 1.25M | 60 | $19/ай |
| Бизнес | 6.25M | 120 | $49/ай |
| Энтерпрайз | Өзгөчө | Өзгөчө | Контакттар |
Токен пакеттери бар: 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"
GitHub
PyPI
Коддоо ассистенти
Claude Code, Cursor жана 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"
5K акысыз токендер/күн. BYOK колдоо. 346+ моделдер. Сеанстарды Web IDE менен синхрондоштуруу.
GitHub PyPI Web 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. | Бардык провайдерлердин 346+ модели | $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 балансыңыздан эч кандай чектөөлөр жок.
Чагымдуу суроолор
"model": "openai/gpt-4o" же "model": "anthropic/claude-sonnet-4". Толук тизме /apps/ же GET /v1/models."stream": true коюңуз. Жауаптар серверден жөнөтүлгөн окуялар (SSE) аркылуу берилет.free_ai_usage.tokens_charged в каждом ответе API.pip install free-dot-ai. Бул ар бир аяктоо пунктун типографиялык жооптор менен каптайт. Кодировкага жардам алуу үчүн, pip install free-dot-ai-code орнотуңуз. API ошондой эле OpenAIге ылайык келет\