Free.ai API
Един API ключ, всеки интелигентен инструмент.
Как действа
Вземи API ключ
Покупка на жетони, след това генерирате вашия ключ sk-free-
Обади се на всяка крайна точка.
Чат, изображения, ТТС, СТТ, музика, превод — всички един 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 | Чат/Пиши/Код | Действителни използвани жетони (вход + изход) | Апачи 2.0 |
| FLUX.1 Schnell | Създаване на изображение | 1000 жетона/изображение | Апачи 2.0 |
| Кокоро | Текст към реч | 1 знак на 4 символа | Апачи 2.0 |
| по-бързо-шепкане | Изказване към текст | 4 жетона/секунда звук | МИТ |
| AudioLDM 2 | Създаване на музика | 2000 жетона/пистата | Апачи 2.0 |
| МадЛАД-400 | Превод (450+ лангове) | Действителни използвани жетони | Апачи 2.0 |
| Реално-ESRGAN | Увеличаване на изображението | 500 жетона/изображение | BSD |
| BRIA RMBG | Отстраняване на фона | 500 жетона/изображение | Апачи 2.0 |
| CogVideoX | Генериране на видео | 5000 жетона/видео | Апачи 2.0 |
| Демуци | Вокално разделяне | 500 жетона/пистата | МИТ |
Достъп GPT-4, Claude, Gemini, Llama, DeepSeek, и 340+ повече модели. Цената е основана на цените на доставчика, преобразувани в нашите жетони.
| Модел | Доставчик | ~Токенс на съобщение | Бележки |
|---|---|---|---|
| GPT-4o Мини | OpenAI | ~20 | Евтини, бързи |
| Близнаци 2.0 Светкавица | Гугъл | ~15 | Много бързо. |
| Мистрал Немо | Мистрал | ~10 | Голяма стойност |
| Дълбок търсач V3 | Дийп Сейк. | ~30 | Силни аргументи |
| Llama 3.3 70B | Мета | ~25 | Отворени тежести |
| Клод Сонет 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 разходи $0.0025 за 1K токени. За 1000 жетона: $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 (реално-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/ | Преписване на аудио/видео (бързо-шеп, 99 езика) |
POST /v1/music/generate/ | Създаване на музика от текстовото описание |
POST /v1/music/separate/ | Разделни вокали/стами (Демуци) |
POST /v1/write/ | Генериране на съдържание (показва, имейл, история и т.н.) |
POST /v1/code/generate/ | Генериране на код на всеки език |
POST /v1/summarize/ | Обобщаване на текста |
POST /v1/humanize/ | Нека текстът на интелигентния интелект звучи като човек |
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: 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/day (pool) | 10 | $0 |
| Основен | 250K | 30 | 5 долара/мо. |
| Професионален | 1.25M | 60 | $19/mo |
| Бизнес | 6.25M | 120 | $49/mo |
| Предприятия | Потребителски | Потребителски | Контакт |
Налични пакети: 200K/$5, 1M/$15, 5M/$40.
Python SDK & CLI
Python SDK
Достъп до всеки AI инструмент от вашия Python код.
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
Помощник по кодиране на CLI
Свободна, отворена алтернатива на Клод Код, Курсор, и GitHub копилот.
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 free tokens/day. BYOK supported. 346+ models. Session sync with 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.
API Често задавани въпроси
"model": "openai/gpt-4o" или "model": "antropic/claude-sonnet-4". Пълен списък на /apps/ или GET / v1/models."stream": true във вашето запитване за чат. Отговорите са доставени чрез сървър-сент събития (SSE).free_ai_usage.tokens_ purped в всеки API отговор.pip install free- dot-ai. Той обвива всяка крайна точка с напечатани отговори. За помощ за кодиране инсталирайте pip install free- dot- ai-code. API също следва OpenAI\