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 ننڍو | تصوير پيدا ڪرڻ | 5,000 tokens/image | Apache 2.0 |
| Kokoro | متن کان ڳالھائڻ | 1 ٽوڪون هر 4 ڪارڪنن لاءِ | Apache 2.0 |
| faster-whisper | ڳالھائڻ کان متن | آڊيو جو 4 ٽوڪنز/ سيڪنڊ | ايم آءِ ٽي |
| AudioLDM 2 | ميوزڪ پيدا ڪرڻ | ٽوڪنز/ٽريڪ | Apache 2.0 |
| MadLAD-400 | ترجمو (450+ صفحا) | حقيقي ٽوڪنز استعمال ٿيل | Apache 2.0 |
| Real-ESRGAN | تصوير جي وڌي وئي | تصوير | بي ايس ڊي |
| بريا RMBG | پس منظر جو لڪير | تصوير | 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 per message (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 ڪنهن به ماڊل سان (خود hosted يا ٻاهرين). سٽنگ حمايت ڪئي. |
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" EmbeddingGemma 2 (768 dims, dimensions 128 کان 768, input_type query or document) |
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
پنھنجي پائيتن ڪوڊ مان سڀ 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 ماڊل. سيشن sync سان Web IDE.
PyPI انسٽال ۽ ترتيب ڏيڻ جو ھدايتڪار ويب IDEBYOK (پاڻ جي ڪُٻي آڻيو)
ڪنهن به فراهم ڪندڙ کان پنھنجيون API ڪُليون استعمال ڪريو. صفر مارڪ اپ، صفر فيس. Free.ai درخواست صرف پرڪسي ڪري ٿو.
| مهيا ڪندڙ | ڪُليءَ جي شڪل | ماڊل | نشان |
|---|---|---|---|
| اوپن اي آءِ | sk-proj-xxx | GPT-4o, GPT-4o Mini, o1, o3, وغيره | $0 |
| انسان | sk-ant-xxx | Claude Sonnet 4، اوپس 4، هائڪو، وغيره | $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 جي حساب مان ڪوبه ٽوڪين جو گھٽايو نه آھي.
عام سوال
"model": "openai/gpt-4o" يا "model": "anthropic/claude-sonnet-4". پورو فہرست /models/ يا GET /v1/models تي."stream": true پنھنجي چٽائي جي درخواست ۾ مقرر ڪريو. جواب سيروير-پيغمبر واقعن (SSE) ذريعي موڪليا ويندا.free_ai_usage.tokens_charged ميدان کي هر API جواب ۾ چيڪ ڪريو.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