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 | Chat/Напиши/код | Действителни използвани жетони (вход + изход) | Апачи 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/ | Откриване на съдържанието, генерирано от ИИ |
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/ден (дружество) | 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
Достъп до всеки ИИ инструмент от вашия 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
Пипи
Помощник по кодиране на 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 безплатни жетони/дневен. BYOK поддържа. 346+ модели. Синхронизация на сесията с Web IDE.
GitHub Пипи Уеб ИДЕ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.
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\