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);
نرخی نیشانە
هەموو شتێک بە تۆمەک دەدرێت. یەک پارە بۆ هەموو ئامرازەکان. هەمان نرخ ئەگەر تۆ ئەپی پی بەکاربهێنیت یان ماڵپەڕەکە.
| مۆدێل | جۆر | نرخی نیشانە | مۆڵەتی بەکارھێنەر |
|---|---|---|---|
| Qwen 2.5 7ب | چاوپێکەوتن/نوسین/کۆد | توكانەی ڕاستەقینە بەکارهاتوون (هێنان+دەرچوون) | ئەپاچی |
| خێرا | دروستکردنی وێنە | ١٠٠٠ نیشانە بۆ هەر وێنەیەک | ئەپاچی |
| کۆکۆرۆ | نوسراو بۆ قسەکردن | 1 نیشانە بۆ هەر ٤ پیت | ئەپاچی |
| خێراتر-فێڵ | گفتوگۆ بۆ نوسراو | ٤ نیشانە لە چرکەدا بۆ دەنگ | MIT |
| دەنگی | دروستکردنی مۆسیقا | 2,000 نیشانە/شێوەکاری | ئەپاچی |
| مادلاد-٤٠٠ | وەرگێڕان | نیشانەی ڕاستەقینە بەکارهاتوون | ئەپاچی |
| ڕیاڵ-ئێسڕگان | بەرزکردنەوەی وێنە | ٥٠٠ نیشانە بۆ هەر وێنەیەک | بی ئێس دی |
| بریانا | ڕەوانەی پشتەوەی پەڕەکە بکە | ٥٠٠ نیشانە بۆ هەر وێنەیەک | ئەپاچی |
| ڤیدیۆ | دروستکردنی ڤیدیۆ | ٥٠٠٠ نیشانە/ ڤیدیۆ | ئەپاچی |
| دیمۆک | جیاکردنەوەی دەنگی دەنگەکان | ٥٠٠ نیشانە بۆ هەر گۆرانییەک | MIT |
GPT-4، Claude، Gemini، Llama، DeepSeek، و 340+ مۆدێلی تر. نرخی تیکنە لەسەر بنەمای نرخی دابینکەرە کە گۆڕاوە بۆ تیکنەمان.
| مۆدێل | دابینکەر | _هەندێک پەیام | ئامۆژگاری |
|---|---|---|---|
| GPT-4o بچوک | ئۆپن ئای | ~20 | خێرا |
| Gemini ٢.٠ فلاش | گوگڵ | ~15 | زۆر خێرا |
| Mistral نیمۆ | _بەبێ_ناونیشان_12_ | ~10 | نرخی زۆر |
| DeepSeek V3 | _بەبێ_ناونیشان_11_ | ~30 | بیرکردنەوەیەکی بەهێز |
| Llama ٣.٣ ٧٠ب | مێرتا | ~25 | کێشی کراوە |
| Claude Sonnet ٤ | ئینترۆپی | ~400 | باڵاترین باڵا |
| GPT-4o | ئۆپن ئای | ~325 | باڵاترین باڵا |
| Qwen 2.5 72ب | ئەلیبابا | ~40 | گەورە، توانای هەیە |
لیستی تەواو لە 346+ مۆدێل لە /apps/. هەموویان هەمان /v1/chat/ بەکاردەهێنن - تەنها گۆڕینی model پارامەترەکان.
مۆدێلی خۆ-هەژمارکردن: تۆ پارە دەدەیت بۆ ئەو شتانەی کە بەکارت هێناون، هیچ شتێک ناگۆڕیت.
مۆدێلی دەرەوە: our_tokens = provider_usd_cost × 100,000 × 1.30
نمونە: GPT-4o نرخی ٠.٠٠٠٢٥ دۆلار بۆ هەر ١ کیلۆگرامێک لە نیشانە. بۆ ١٠٠٠ نیشانە: ٠.٠٠٠٢٥ دۆلار × ١٠٠،٠٠٠ × ١.٣٠ = 325 نیشانە له کێشان و پێوانهکهت.
هەموو خاڵەکانی کۆتایی
POST /v1/chat/ | گفتوگۆ لەگەڵ هەر مۆدێلێک بکە (خۆت یان دەرەوە). پشتگیری ڕەوانەکردن. |
POST /v1/image/generate/ | نوسراو بۆ وێنە (FLUX, SDXL) |
POST /v1/image/edit/ | کێشانی ناوەوە، کێشانی دەرەوە، گۆڕینی شێواز |
POST /v1/image/enhance/ | بەرزکردنەوەی 2x/4x (Real-ESRGAN) |
POST /v1/image/remove-bg/ | پشتگوێخستن |
POST /v1/video/generate/ | وێنە/نوسراو بۆ ڤیدیۆ (CogVideoX) |
POST /v1/tts/ | دروستکردنی قسەکردن (کۆکۆرۆ، پیپەر، مێلۆ تی تی ئێس، چاتەربۆکس) |
POST /v1/tts/stream/ | ڕەوانەکردنی TTS (بە دەنگ لە کاتی ڕاستەقینەی خۆیدا) |
POST /v1/stt/transcribe/ | گوێگرتن/ ڤیدیۆ (بە خێرایی، ٩٩ زمان) |
POST /v1/music/generate/ | مۆسیقا دروست بکە لە ناو باسکردنی مەکتەبەکەوە |
POST /v1/music/separate/ | دەنگەکان/هەناسەکان دابەش بکە (Demucs) |
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 |
ڕاستگۆیی
کلیلی ئەپی پی خۆت دابگرە لە ناو سەرنووس 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/day (pool) | 10 | $0 |
| بنەڕەتی | 250K | 30 | مانگانە |
| پڕۆ | 1.25M | 60 | مانگانە |
| بازرگانی | 6.25M | 120 | مانگانە |
| کۆمپانیا | _پێویست | _پێویست | پەیوەندیدار |
.پاکتەکانی لۆگۆی دەستکەوت: ٢٠٠ هەزار/$٥، ١ ملیۆن/$١٥، ٥ ملیۆن/$٤٠. لۆگۆکان هەرگیز کۆتاییان نایەت
پایتۆن
پایتۆن
پەڕەی هەموو ئامرازەکانی 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
پشتیوانی نوسینی کۆدی CLI
ئازاد، سەرچاوەی کراوە بۆ Claude کۆد، کارسۆر، و گیت هاب کۆپیلۆت.
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 (گیراوەی خۆت بهێنە)
کلیلی تایبەت بە خۆت بەکاربهێنه لە هەر دابینکەرێکەوە هیچ نرخێک، هیچ پارەیەک. Free.ai تەنها داواکاریەکە دەگۆڕێت.
| دابینکەر | شێوازی کلیل | مۆدێلەکان | نیشانە |
|---|---|---|---|
| ئۆپن ئای | sk-proj-xxx | GPT-4o، GPT-4o بچوک، o1، o3، هتد | $0 |
| ئینترۆپی | sk-ant-xxx | Claude Sonnet ٤، ئۆپۆس ٤، هایکۆ، هتد | $0 |
| گوگڵ | AIzaSyxxx | Gemini ٢.٥ پڕۆ، فلاش، هتد | $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
Your key, your usage, your bill. No logging. No token deductions from your Free.ai balance.
پرسیاری زۆر کراوە
"model": "openai/gpt-4o" یان "model": "anthropic/claude-sonnet-4". لیستی تەواو لە /apps/ یان GET /v1/models"stream": true لە داواکاریی گاڵتەجاڕی خۆت. وەڵامەکان لەڕێگەی ڕووداوەکانی دابەشکەرەوە دەنێرێت (SSE).free_ai_usage.tokens_charged بکە لە هەر وەڵامێکی ئەپی بی ئی.pip install free-dot-ai. هەموو خاڵێکی کۆتایی بە وەڵامی نووسراوەوە دەبەستێتەوە. بۆ یارمەتیدانی کۆد، دابنێ pip install free-dot-ai-code. ئەم API یە هەروەها OpenAI دەگرێتە بەر\