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 2.5 7ב | קאָד | אמת־טוקענס פֿאַרנומען (אַרײַנשרײַב+אַרײַנשרײַב) | װײַז |
| קלײן | בילד־אַרױסגלײַכונג | 5,000 טאַגס/בילד | װײַז |
| װײַז | טעקסט פֿאַרבtext-to-speech | 1 שריפֿטצײכן אױף 4 שריפֿטצײכן | װײַז |
| װײַז | טעקסט פֿאַרבtext-tool-action | 4 טאַקענס/סעקונדע פֿון אויטאָמאָביל | MIT |
| װײַז | מוזיק־אַרײַנשרײַב | 2,000 טאַגס/הײליק | װײַז |
| װײַז | איבערזעצונג | װײַז די װײַז־פּראָגראַם | װײַז |
| װײַז | בילד־צוװײַז | 500 טאַגס/בילד | BSD |
| ברײט RMBG | הינטער־פֿאַרבundo-type | 500 טאַגס/בילד | װײַז |
| װײַז | בילד־אַרױסגלײַכונג | 30,000 tokens/video | װײַז |
| Stem Separator (Mel-Band RoFormer + SCNet) | טעקסט פֿאַרבKCharselect unicode block name | 500 טאַגס/הײליק | MIT + Apache-2.0 |
צוגײן GPT-6, Claude, Gemini, Llama, DeepSeek און די װעלכע פֿון די 579 מודלען. די קאָסטן פֿון די טיקעטס זײַנען באזירט אױף די װײַזער־פּרייזן, װאָס זײַנען איבערגעװײַזט געוואָרן צו אונזערע טיקעטס
| מאָדע | פֿאַרװאַנדלער | טעקסט פֿאַרב | נאָטיצן |
|---|---|---|---|
| קלײַב אַלץ אױס | OpenAI | ~20 | קלאָר |
| Gemini 2.0 בלױז | ~15 | שריפֿט מעק אַרױסundo-type | |
| Mistral װײַז | װײַז | ~10 | גרעסערע ווערט |
| DeepSeek V3 | װײַז | ~30 | קלײַב אַלץ אױסselect-criterion |
| Llama 3.3 70ב | מעק אַרױס | ~25 | פֿאָרױסװײַזStock label |
| װיפֿל | װײַז פֿאָרױסװײַז | ~400 | קװאַליטעט |
| או | OpenAI | ~325 | קװאַליטעט |
| Qwen 2.5 72ב | אַרײַנשרײַב | ~40 | גרײס: |
פֿולע רשימה פֿון 579 מאָדעלן אױף /models/. אַלע ניצן די זעלבע /v1/chat/ סוף־פּראָצעס - נאָר װײַזן די model פּאַראַמעטער
װײַז מאָדע דו באַצאָלסט די ריכטיקע װײַזער־טײלעך. ניט קיין מעק
אױסגעפֿירטע מאָדעלס: our_tokens = provider_usd_cost × 100,000 × 1.30
Example: GPT-4o costs $0.0025 per 1K prompt tokens. For 1,000 tokens: $0.0025 × 100,000 × 1.30 = 325 טאַגס פֿון דיין באַטרעף
אַלע סוף־פּראָצעסן
POST /v1/chat/ | Chat מיט אַװעקצונעמען אַ מאָדעל (אויסגעפֿירט אױף זיך אױף אױסגעפֿירט אױף זיך) |
POST /v1/image/generate/ | טעקסט פֿאַרבtext-tool-action |
POST /v1/image/edit/ | טעקסט פֿאַרבtransform-type |
POST /v1/image/enhance/ | קלײַב אַלץ אױסselect-action |
POST /v1/image/remove-bg/ | קלײַב אַלץ אױסundo-type |
POST /v1/video/generate/ | טעקסט פֿאַרב |
POST /v1/tts/ | װײַז פֿאָרױסװײַז |
POST /v1/tts/stream/ | װײַז װײַז |
POST /v1/stt/transcribe/ | איבער־פֿאַרקער אויטאָמאָביל |
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/translate/ | איבערזעצונג |
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־צופֿירונגען/מיני | צאָל |
|---|---|---|---|
| פֿרײַ | 30K/טאָג (פֿאָלק) | 10 | $0 |
| קלײַב אַלץ אױסundo-type | 250K | 30 | $5/יאָר |
| פּראָ | 1.25M | 60 | $19/חודש |
| אַרבעט | 6.25M | 120 | װײַז פֿאָרױסװײַז |
| פֿאַרב: | װײַז אַלץ | װײַז אַלץ | קאָנטאַקט |
אױף דער װײַט־װײַט
פּײַטאָן
פּײַטאָן 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 קאָפּילאָט
pip install freeai-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 שטיצט. 579 מאָדעלס. סעסיע סינקראָניזירן מיט Web IDE
PyPI פּאַפּקע װײַב IDEBYOK (באַקומען אייער אייגענעם קעלצער)
ניצן אייער אייגענע API קײט פֿון אַװעקצושטעלן ניט קיין מאַרקאַפּ, ניט קיין צאָלונג. Free.ai װײַזט נאָר די באַדערפעניש
| פֿאַרװאַנדלער | קלײַב פֿאָרמאַטירונג | מאָדע | מעק אַרױס |
|---|---|---|---|
| OpenAI | sk-proj-xxx | קלײַב אַלץ אױסundo-type | $0 |
| װײַז פֿאָרױסװײַז | sk-ant-xxx | 4, Opus 4, Haiku, אױסגעפֿילט | $0 |
AIzaSyxxx | 2.5 פּראָ, פֿלאַש, אױף אַ װײַז | $0 | |
| װײַז פֿאָרױסװײַז | sk-or-xxx etc. | 579 מאָדעל פֿון אַלע פֿאַרװאַנדלער | $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