APIی Free.ai

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

چۆن کاردەکات

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

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

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

Chat، وێنە، 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": "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 ٢.٥ ٧بکۆدی نوسینی Chatکارامەییەکانی ڕاستەقینە بەکارهاتوون (هێڵکردن+دەرچوون)Apache 2.0
FLUX.2 Kleinدروستکردنی وێنە5,000 tokens/imageApache 2.0
Kokoroنوسراو بۆ قسەکردن1 لۆگۆ بۆ هەر ٤ پیتApache 2.0
faster-whisperگفتوگۆ بۆ نوسین٤ تاکە لە چرکەدا بۆ دەنگماک
AudioLDM 2دروستکردنی مۆسیقا2000 نیشانە بۆ هەرشێوەکارییەکApache 2.0
MadLAD-400وەرگێڕانناپاڵمەکانی ڕاستەوخۆ بەکارهاتوونApache 2.0
Real-ESRGANکێشکردنی وێنەوێنەبی ئێس دی
بریاناناپەسەندکردنی پشتگوێخستنوێنەApache 2.0
CogVideoXدروستکردنی ڤیدیۆ30,000 tokens/videoApache 2.0
Stem Separator (Mel-Band RoFormer + SCNet)جیاکردنەوەی دەنگی٥٠٠ نیشانە بۆ هەر ڕێکەوتێکMIT + Apache-2.0
مۆدێلی دەرەوەی 579 models

. گەیشتە GPT-6، Claude، Gemini، Llama، DeepSeek و مادەی تریش لە مۆدێلی 579. نرخی توكێن لەسەر بنەمای نرخی دابینکەرە کە گۆڕاوە بۆ توكێنەکانمان

مۆدێلدابینکەرپەیامەکەئامۆژگاری
GPT-4ی بچوکئۆپن ئای~20خێرا
Gemini 2.0 فلاشگوگڵ~15زۆر خێرا
Mistral نیمۆMistral~10نرخی زۆر
DeepSeek V3DeepSeek~30بیرکردنەوەیەکی بەهێز
3.3 70بمێرتا~25کێشی کراوە
Claude Sonnet ٤ئینترۆپی~400باڵاترین ئاستی
GPT-4oئۆپن ئای~325باڵاترین ئاستی
2.5 72بئەلیبابا~40گەورە، توانای هەیە

لیستی تەواو بۆ مۆدێلی 579 لە /models/. هەموویان هەمان خاڵى کۆتایی /v1/chat/ بەکاردەهێنن - تەنها گۆڕینی پارامەتری model

فۆرمۆڵ

مۆدێلی خۆ-هەژمارکردن: تۆ پارە دەدەیت بۆ ئەو شتانەی کە بەکارت هێناون، هیچ شتێکت پێ نادرێت

مۆدێلی دەرەوە: our_tokens = provider_usd_cost × 100,000 × 1.30

نمونە: GPT-4o نرخی $0.0025 بۆ هەر 1k کارامە. بۆ 1,000 کارامەکان: $0.0025 × 100,000 × 1.30 = 325 نیشانە له کێشان و پێوانت

هەموو خاڵەکانی کۆتایی

Chat / LLM
POST /v1/chat/Chat لەگەڵ هەر مۆدێلێک (خۆبەڕێوەبەری یان دەرەوە). پشتگیری ڕەوانەکردن.
وێنە
POST /v1/image/generate/نوسراو بۆ وێنە (FLUX, SDXL)
POST /v1/image/edit/کێشانی ناوەوە، کێشانی دەرەوە، گواستنەوەی ستایل
POST /v1/image/enhance/بەرزکردنەوەی ٢x/٤x (Real-ESRGAN)
POST /v1/image/remove-bg/پشتگوێخستن
ڤیدیۆ
POST /v1/video/generate/نوسراو/ وێنە بۆ ڤیدیۆ (CogVideoX)
نوسراو بۆ قسەکردن
POST /v1/tts/گفتوگۆ دروست بکە (Kokoro, Piper, MeloTTS, Chatterbox)
POST /v1/tts/stream/ڕەوانەکردنی TTS (بە دەنگ)
گفتوگۆ بۆ نوسین
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/کورتکردنەوەی نوسراو
POST /v1/humanize/نووسراوەکانی AI بە دەنگێکی مرۆڤانە دروست بکە
POST /v1/detect/بۆنەکانی دروستکراوی AI بدۆزەوە
وەرگێڕان
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

ناساندنی

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

.بڵاوکردنەوەی لۆگۆی دەستکەوتەکان: 200K/$5, 1M/$15, 5M/$40. لۆگۆکان هەرگیز کۆتاییان نایەت

پایتۆن

پایتۆن

پەڕەی هەموو ئامرازەکانی 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"
PyPI PyPI
پشتیوانی کۆدکردن

ئازاد، سەرچاوەی کراوە بۆ کۆدی Claude، کورسۆر، و گیت هاب کۆپیلۆت

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 free tokens/day. BYOK پشتگیری کراوە. 579 models. Session sync with Web IDE.

PyPI PyPI IDEی ماڵپەڕ

کلیلی خۆت بهێنە

کلیلی API ی خۆت بەکاربهێنە لە هەر دابینکەرێکەوە هیچ ماركوپ، هیچ پارە Free.ai تەنها داواکاریەکە پێشکەش دەکات

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

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

بەڵێ! حسابە بێ نرخەکان 30K tokens / ڕۆژ بەدەست دەهێنن پلانەکانی پارە زیاتر پێشکەش دەکەن و سنووری نرخی بەرزتر.

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

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

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

بەڵێ! دیاریکردنی "stream": true لە داواکاریی چاوپێکەوتنەکەتدا. وەڵامەکان لەڕێگەی ڕووداوەکانی خزمەتگوزاری-نێردراوەوە دەدرێن (SSE).

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

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

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

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

Yes! Install our Python SDK: 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

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

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

خۆشت دەوێت Free.ai؟ بڵێ بە هاوڕێکانت!

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