Free.ai API

یەک کلیلی API. هەموو ئامرازەکانی AI. گرێبەستی ئاسان.

چۆن کاردەکات

1
کلیلی API بەدەست بهێنە

توكێنەکان بکڕن، پاشان کلیلی sk-free- دروست بکەن

2
هەر خاڵێکی کۆتایی بانگ بکە

چاوپێکەوتن، وێنە، TTS، STT، مۆسیقا، وەرگێڕان - هەموویان یەک API

3
پارە بدە بە نیشانە

یەک کێش، هەموو ئامرازێک بە بڕی کەرەستە دەفرۆشرێت، ئاسانە

دەستپێکردنی خێرا

# 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
مۆدێلی دەرەوە 346+ مۆدێل

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/modelsList 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
بنەڕەتی250K30مانگانە
پڕۆ1.25M60مانگانە
بازرگانی6.25M120مانگانە
کۆمپانیا_پێویست_پێویستپەیوەندیدار

.پاکتەکانی لۆگۆی دەستکەوت: ٢٠٠ هەزار/$٥، ١ ملیۆن/$١٥، ٥ ملیۆن/$٤٠. لۆگۆکان هەرگیز کۆتاییان نایەت

پایتۆن

پایتۆن

پەڕەی هەموو ئامرازەکانی 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 IDE

BYOK (گیراوەی خۆت بهێنە)

کلیلی تایبەت بە خۆت بەکاربهێنه لە هەر دابینکەرێکەوە هیچ نرخێک، هیچ پارەیەک. Free.ai تەنها داواکاریەکە دەگۆڕێت.

دابینکەرشێوازی کلیلمۆدێلەکاننیشانە
ئۆپن ئایsk-proj-xxxGPT-4o، GPT-4o بچوک، o1، o3، هتد$0
ئینترۆپیsk-ant-xxxClaude Sonnet ٤، ئۆپۆس ٤، هایکۆ، هتد$0
گوگڵAIzaSyxxxGemini ٢.٥ پڕۆ، فلاش، هتد$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.

پرسیاری زۆر کراوە

Yes! Free accounts get 30K tokens/day plus a 10K signup bonus. Paid plans offer more tokens and higher rate limits.

نەخێر! هەمان کەرەستە، هەمان نرخ. کەرەستەت لە نێوان ماڵپەڕ و API دا دابەشکراوە. هەریەکەیان بەکاربهێنە، هەمان پارە بدە.

هەمان خاڵى کۆتایی، تەنها گۆڕینی پارامەتری مۆدێل. بۆ نمونە: "model": "openai/gpt-4o" یان "model": "anthropic/claude-sonnet-4". لیستی تەواو لە /apps/ یان GET /v1/models

بەڵێ! خاڵەکانی کۆتایی /v1/chat/ بە شێوازی کۆتایهێنان بە گفتوگۆکانی ئۆپن ئای دەگەڕێن. دەتوانیت هەر جۆرێک لە SDK بەکاربهێنیت کە لەگەڵ ئۆپن ئای هاوشێوەیە - تەنها گۆڕینی ناوەکەی بنەڕەت بۆ https://api.free.ai و بەکارهێنانی Free.ai کلیلی API ی خۆت.

بەڵێ! دیاریکردنی "stream": true لە داواکاریی گاڵتەجاڕی خۆت. وەڵامەکان لەڕێگەی ڕووداوەکانی دابەشکەرەوە دەنێرێت (SSE).

تۆ وەڵامی ٤٠٢ و پەیامێکی هەڵە وەردەگریت. پەڕەی زیاتر بکڕە لە /pricing/ یان چاوەڕێ بکە بۆ ئەوەی کە ڕۆژانە پارە بەبێ پارە بگەڕێتەوە. مۆدێلی خۆبەخشانە هەمیشە لە سنووری ڕۆژانەدا هەیە.

بەڵێ! هەموو مۆدێلەکانی خۆ-هەژمارکراو مۆڵەتی MIT/Apache 2.0یان هەیە. شتەکانی دروستکراو بۆ بەکارهێنانی بازرگانیە.

خۆ-هەژمار: لەسەر GPU ی خۆمان کاردەکات. گرانترین، خێراترین، تایبەتترین. دەرەوە: بە پڕۆکسی بۆ مۆدێلی دابینکەر. گەیشتن بە GPT-4، Claude، Gemini، و زیاتر. نرخی زیاتری تۆمێنەکان بەهۆی پارەی دابینکەرەوە API.

سەردانی پەڕەی هەژمارەکەت بکە لە /account/ یان سەردانی free_ai_usage.tokens_charged بکە لە هەر وەڵامێکی ئەپی بی ئی.

بەڵێ! دابنێ بۆ پایتۆن SDK: pip install free-dot-ai. هەموو خاڵێکی کۆتایی بە وەڵامی نووسراوەوە دەبەستێتەوە. بۆ یارمەتیدانی کۆد، دابنێ pip install free-dot-ai-code. ئەم API یە هەروەها OpenAI دەگرێتە بەر\

ئێمە ئامانجمان بۆ ٩٩.٩% کاتی کارکردنە. پلانەکانی کۆمپانیا بریتین لە دڵنیاکردنەوەی SLA. پشکنینی / تەندروستی بۆ بارودۆخی کاتی ڕاستەقینە.

ئیمەیڵ بۆ hello@free.ai بنێرە یان سەردانی /contact/ بکە. پلانەکانی پرۆ+ پشتگیری پێشەنگیان پێدەدرێت. وەڵامەکانی هەڵە هەڵگری ناو_هەژاردەیەکی هەڵە بۆ هەڵە دۆزینەوەی هەڵە.

Like this tool? Share it!

ئەم لاپەڕەیە بایەخی بدە