Free.ai API
یو API کلیدي. هر AI وسیله. ساده توکي بیل.
څنګه دا کار کوي
د API کيلۍ ترلاسه کول
د توکو پیرود، بیا ستاسو د sk-free- کلیدي تولید کړئ
هر پاي ټکی اړيکنيو
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 توکي/انځور | :دوتنه_ |
| :دوتنه_ | ليکنه وينا ته | 1 توکي پر 4 لوښه | :دوتنه_ |
| :دوتنه_ | وينا ليکنې ته | د غږيزو 4 توکي / ثانيه | MIT |
| :دوتنه_ | د سندرې جوړول | 2000 توکي / پلټنه | :دوتنه_ |
| :دوتنه_ | ژباړه (450+ پاڼې) | کارول شوي حقیقي توکي | :دوتنه_ |
| :دوتنه_ | انځور لويول | 500 توکي/انځور | بي اېس ډي |
| بريا | شاليد ړنګول | 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 ماډلونو پاتې برخې ته لاسرسی. د توکو لګښت د چمتو کونکي قیمتونو پراساس دی چې زموږ توکو ته بدل شوي.
| بېلګه | برابروونکی | ~ په هر پیغام توکي (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 ماډلونو بشپړ لیست په / ماډلونه / کې. ټول د ورته / v1 / چیټ / پای ټکی کاروي: یوازې د model پارامتر بدل کړئ.
ځان- کوربه ماډلونه: تاسو د دقیق توکو کارول شوي پیسې ورکړئ. نه markup.
: بهرني بېلګه our_tokens = provider_usd_cost × 750,000 × 1.5
مثال: GPT-4o د 1,000 پرله پسې توکو لپاره د $ 0.0025 لګښتونه، نو د 1,000 پرله پسې توکو لګښت $ 0.0025 x 750,000 x 1.5 = 2,812 توکو څخه ستاسو د توازن څخه.
د 1.5 markup د معياري نرخ دی. د حسابونو سره د يو لوړ میاشتني لګښت د يوه ټيټ يو د ورکړې.
ټول پاي ټکي
POST /v1/chat/ | Chat سره د هر ډول (خود-هسټ یا بهرني) د نمونې. د خپرونو ملاتړ. |
POST /v1/image/generate/ | انځور ته ليکنه (FLUX، SDXL) |
POST /v1/image/edit/ | انځور، اوترنګ، ډول لېږد |
POST /v1/image/enhance/ | (Real-ESRGAN) ۲x/۴x لويول |
POST /v1/image/remove-bg/ | شاليد لرې کول (BRIA RMBG) |
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/embeddings/ | د متن embeddings: BGE-M3 په تلواله توګه، یا "موډل": "embeddinggemma-2" د EmbeddingGemma 2 لپاره (768 dims، dimensions 128 ته 768، input_type پوښتنه یا سند) |
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 د روغتيا کتنه |
کرونه
ستاسو د 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 |
| بنسټيز | 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 تلواله، په غوښتنه پورته | اړيکلوری |
د توکو بسته شتون لري: 200K / $ 5، 1M / $ 15، 5M / $ 40. توکي هیڅکله پای ته نه رسیږي.
پېټان SDK او CLI
پېټېن SDK
د خپل Python کوډ څخه هر 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
پېي پي
د کوډييزونې مرستيال CLI
وړيا، د Claude کوډ، کرسر، او GitHub Copilot ته د خلاص سرچینې بديل.
# 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 کیلي وکاروئ. صفر markup، صفر فیس. Free.ai يوازې د غوښتنې وکیل.
| برابروونکی | کيلۍ بڼه | بېلګه | نښونه |
|---|---|---|---|
| پرانيستل AI | 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
ستاسو کلیدي، ستاسو کارول، ستاسو بل. نه log. ستاسو د Free.ai توازن څخه هیڅ توکي کم نه دي.
API ډېرې پوښتنې
"موډل": "openai / gpt-4o" یا "موډل": "انټروپیک / کلاډ-سونیټ-4" . په / ماډلونو کې بشپړ لیست یا GET / v1 / ماډلونه. "stream" تنظیم کړئ: په خپل چیټ غوښتنلیک کې true. ځوابونه د سرور-لیږل شوي پیښو (SSE) له لارې لیږدول کیږي.free_ai_usage.tokens_charged ساحه وګورئ.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