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/لکھنا/کوڈ | حقیقی ٹوکن استعمال کئے گئے (انپٹ+آؤٹپٹ) | Apache 2.0 |
| FLUX.2 چھوٹا | تصویر پیدا کرنا | 5000 ٹوکن/تصویر | Apache 2.0 |
| Kokoro | متن سے بولنا | 1 ٹوکن پر 4 حروف | Apache 2.0 |
| faster-whisper | زبان سے متن | 4 ٹوکنز/ ثانی | ايم آئی ٹی |
| AudioLDM 2 | موسیقی کی پیداوار | 2000 ٹوکنز/ٹرک | Apache 2.0 |
| MadLAD-400 | ترجمہ | حقیقی ٹوکن استعمال کئے گئے | Apache 2.0 |
| Real-ESRGAN | تصویر کا حجم بڑھانا | 500 ٹوکن/مچھلی | بي ايس ڈی |
| بريا RMBG | پس منظر | 500 ٹوکن/مچھلی | Apache 2.0 |
| CogVideoX | ویڈیو پیدائش | 30,000 tokens/video | Apache 2.0 |
| Stem Separator (Mel-Band RoFormer + SCNet) | آوازي جدا کي | 500 ٹوکنز/ٹرک | MIT + Apache-2.0 |
GPT-6، Claude، Gemini، Llama، DeepSeek اور باقی 575 ماڈلز تک رسائی حاصل کریں۔ ٹوکن کی قیمت ہمارے ٹوکنوں میں تبدیل شدہ پرووڈیوسر کی قیمت پر مبنی ہے۔
| ماڈل | فراہم کُنندہ | ~Tokens ہر پیغام (500 اندر، 300 باہر) |
|---|---|---|
| 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 ماڈل کے تمام فهرست /models/ پر تمام /v1/chat/ اينڈ پو اينٹ استعمال کريں: صرف model پارا مٹر بدليں
خود مہمان ماڈل: آپ کو استعمال کے ٹکنوں کی رقم ادا کرنا ہوگا.
خارجي ماڈل: our_tokens = provider_usd_cost × 750,000 × 1.5
مثال: GPT-4o کو $0.0025 کی قیمت ہے ہر 1,000 پروموشن ٹوکن کے لیے، تو 1,000 پروموشن ٹوکن کو $0.0025 x 750,000 x 1.5 = 2,812 ٹوکن آپ کے بلنڈ سے لگتا ہے.
1.5 مارک اپ معیاری شرح ہے. اکاؤنٹ جن میں ماہانہ خرچ زیادہ ہے وہ کم خرچ کرتے ہیں.
تمام انتہا پوائنٹ
POST /v1/chat/ | Chat کسی بھی ماڈل کے ساتھ (خود مہمان یا بیرونی). اسٹریمنگ کو مدد دی جاتی ہے. |
POST /v1/image/generate/ | تصوير میں متن (FLUX, SDXL) |
POST /v1/image/edit/ | انپائنٹ، آؤٹپائنٹ، انداز منتقلي |
POST /v1/image/enhance/ | 2x/4x اپسکیل (Real-ESRGAN) |
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/ | متن ضم کردہ: BGE-M3 دیفالٹ سے، يا " ماڈل ": "embeddinggemma-2" EmbeddingGemma2 کے ليے (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
پائتھون
آپ کے 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 کوپیلائٹ کے لئے مفت، اوپن سورس متبادل.
# 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 کی کلیدیں استعمال کریں. صفر مارک اپ، صفر فیس. Free.ai صرف درخواست پراکسیز.
| فراہم کُنندہ | کلیدی فارمیٹ | ماڈل | نشان |
|---|---|---|---|
| اوپن AI | sk-proj-xxx | GPT-4o, GPT-4o Mini, o1, o3, اور غيرها | $0 |
| انسان | sk-ant-xxx | Claude Sonnet 4، Opus4، 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
آپ کی کلید، آپ کی استعمال، آپ کے بل کوئی لاگنگ، آپ کے Free.ai بالانس سے کوئی ٹوکن کمائی.
API FAQ
" ماڈل ": "openai/gpt-4o" يا " ماڈل ": "anthropic/claude-sonnet-4" مکمل فهرست /models/ يا GET /v1/models پر"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