Free.ai API
א API קײל. אױף אײן מאל. אײן קלײד
ווי עס אַרבעט
װײַז קײן בילד
קײן װײַז־טאָקענס, און דערנאָך שאַפֿן אײַער sk-free- שריפֿטצײכן
קלײַב אַלץ אױסundo-type
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 3.6 35B | Chat/Write/Code | אמת־טוקענס פֿאַרנומען (אַרײַנשרײַב+אַרײַנשרײַב) | װײַז |
| FLUX.2 Klein | בילד־אַרױסגלײַכונג | 5,000 טאַגס/בילד | װײַז |
| װײַז | טעקסט פֿאַרבtext-to-speech | 1 שריפֿטצײכן אױף 4 שריפֿטצײכן | װײַז |
| װײַז | טעקסט פֿאַרבtext-tool-action | 4 טאַקענס/סעקונדע פֿון אויטאָמאָביל | MIT |
| װײַז | מוזיק־אַרײַנשרײַב | 2,000 טאַגס/הײליק | װײַז |
| װײַז | איבערזעצונג | װײַז די װײַז־פּראָגראַם | װײַז |
| װײַז | בילד־צוװײַז | 500 טאַגס/בילד | BSD |
| ברײט RMBG | הינטער־פֿאַרבundo-type | 500 טאַגס/בילד | װײַז |
| װײַז | בילד־אַרױסגלײַכונג | 30,000 טאַגס/װידעאָ | װײַז |
| Stem Separator (Mel-Band RoFormer + SCNet) | טעקסט פֿאַרבKCharselect unicode block name | 500 טאַגס/הײליק | MIT + Apache-2.0 |
צוגײן GPT-6, Claude, Gemini, Llama, DeepSeek און די װעלכע פֿון די 575 מודלען. די קאָסטן פֿון די טיקעטס זײַנען באזירט אױף די װײַזער־פּרייזן, װאָס זײַנען איבערגעװײַזט געוואָרן צו אונזערע טיקעטס
| מאָדע | פֿאַרװאַנדלער | ~Tokens per message (500 in, 300 out) |
|---|---|---|
| GPT-4o-mini | OpenAI | ~286 |
| Mistral Nemo | Mistral | ~100 |
| Llama 3.3 70B Instruct | Meta | ~639 |
| Qwen2.5 72B Instruct | Qwen | ~337 |
| DeepSeek V3 | DeepSeek | ~493 |
| GPT-4o | OpenAI | ~4,781 |
פֿולע רשימה פֿון 575 מאָדעלן אױף /models/. אַלע ניצן די זעלבע /v1/chat/ סוף־פּראָצעס: נאָר װײַזן די model פּאַראַמעטער
װײַז מאָדע דו באַצאָלסט די ריכטיקע װײַזער־טײלעך. ניט קיין מעק
אױסגעפֿירטע מאָדעלס: our_tokens = provider_usd_cost × 750,000 × 1.5
למשל: GPT-4o קאָסטן $0.0025 פּער 1,000 פּרעפֿערענץ טיקעטס, אַזוי 1,000 פּרעפֿערענץ טיקעטס קאָסטן $0.0025 x 750,000 x 1.5 = 2,812 טיקעטס פון דיין באַגריף.
די 1.5 מעקאַפּ איז דער סטענדאַרד־רײַט. קאָנטאקטן מיט אַ הויכע מײַנלעך צאָלונג צאָלן אַ קלענערע צאָלונג
אַלע סוף־פּראָצעסן
POST /v1/chat/ | Chat מיט װעלכע װײַז (אויסגעפֿירט אױף זיך אױף אױסגעפֿירט אױף זיך) |
POST /v1/image/generate/ | טעקסט צו בילד (FLUX, SDXL) |
POST /v1/image/edit/ | טעקסט פֿאַרבtransform-type |
POST /v1/image/enhance/ | Upscale 2x/4x (Real-ESRGAN) |
POST /v1/image/remove-bg/ | קלײַב אַלץ אױסundo-type |
POST /v1/video/generate/ | טעקסט/בילד צו ווידעאָ (CogVideoX) |
POST /v1/tts/ | Generate speech (Kokoro, Piper, MeloTTS, Chatterbox) |
POST /v1/tts/stream/ | װײַז |
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/ | טעקסט פֿאַרבtext-tool-action |
POST /v1/humanize/ | מײַז AI טעקסט צו לײענען מענטשלעך |
POST /v1/detect/ | קלײַב אַלץ אױסselect-action |
POST /v1/embeddings/ | טעקסט־אַרײַנשרײַבונגען: BGE-M3 געװײנטלעך, אָדער "מאָדל": "embeddinggemma-2" פֿאַר EmbeddingGemma 2 (768 דימס, dimensions 128 צו 768, input_type פֿראַגע אָדער דאָקומענט) |
POST /v1/translate/ | איבערזעצן טעקסט (MadLAD-400, 450+ שפּראַכן) |
POST /v1/ocr/ | טעקסט פֿאַרבtext-tool-action |
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־צופֿרידנקייטן/מײַן | API־צופֿירונגען/מיני | צאָל |
|---|---|---|---|---|
| פֿרײַ | 30,000 אַ טאָג (פֿרייַ פּאָליצע) | 1,000 | 60 | $0 |
| קלײַב אַלץ אױסundo-type | 250,000 | 10,000 | 120 | $5 אַ חודש |
| פּראָ | 1,250,000 | 100,000 | 300 | $19 אַ חודש |
| אַרבעט | 6,250,000 | 1,000,000 | 600 | $49 אַ חודש |
| פֿאַרב: | װײַז אַלץ | 1,000,000 געװײנטלעך, אױפֿגעװײנט אויף דער בקשה | 600 געװײנטלעך, אױפֿגעװײנט אויף דער בקשה | קאָנטאַקט |
Token packs available: 200K/$5, 1M/$15, 5M/$40. Tokens never expire.
פּײַטאָן
פּײַטאָן 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"
PyPI
פּאַפּקע
קלײַב אַלץ אױסselect-action
פֿרײַע, אָפּגעהיט־קאָפּיע אַלטערנאַטיוו צו Claude קאָד, לױפֿער, און GitHub קאָפּילאַט
# macOS / Linux
curl -fsSL https://free.ai/install.sh | sh
# Windows (PowerShell)
irm https://free.ai/install.ps1 | iex
# 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 שטיצט. 575 מאָדעלס. סעסיע סינקראָניזירן מיט Web IDE
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, בלײַב, אױסגערעכנט | $0 | |
| װײַז פֿאָרױסװײַז | sk-or-xxx etc. | 575 מאָדעל פֿון אַלע פֿאַרװאַנדלער | $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־באַשלוס
FAQ
"model": "openai/gpt-4o" אָדער "model": "anthropic/claude-sonnet-4" . די װײַטע רשימה אין /models/ אָדער GET /v1/models"stream": true אין דיין צװײטע־שמועס־בקשה. ענטפֿערס ווערן איבערגעגעבן דורך סערװירער־געשלײטע געשעענישן (SSE)free_ai_usage.tokens_charged פעלד אין װײַז אױף די API־ענטפֿער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