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 | Chat/Write/Code | Фактикалык колдонулган токендер (кирүү+чыгыш) | 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 суроолору/мин | Баасы |
|---|---|---|---|
| Акысыз | 30K/күн (пул) | 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"
30K акысыз токендер/күн. BYOK колдоо. 346+ моделдер. Сеанстарды Web IDE менен синхрондоштуруу.
GitHub PyPI Веб-интеграцияланган өнүктүрүү чөйрөсүBYOK (өзүңүздүн алдыңызда алып келүү)
Ар кандай провайдерден өз 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ге ылайык келет\