API Free.ai
يه کلید API، همه ابزار هوش مصنوعی، حساب ساده
چطور کار میکنه
دریافت کلید 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 ۲٫۵ ۷B | کد | نشانکهای واقعی استفادهشده) ورودی+خروجی ( | Apache 2.0 |
| FLUX.۲ کوچک | تولید تصویر | 5000 نشانه در هر تصویر | Apache 2.0 |
| Kokoro | متن به گفتار | یک نشانه در هر ۴ کاراکتر | Apache 2.0 |
| faster-whisper | تبدیل گفتار به متن | ۴ نشانه در ثانیه صدا | MIT |
| AudioLDM 2 | تولید موسیقی | 2000توکن/نقطه | Apache 2.0 |
| MadLAD-400 | ترجمه (۴۵۰+ صفحه) | نشانکهای واقعی استفادهشده | Apache 2.0 |
| Real-ESRGAN | افزایش مقیاس تصویر | 500 نشانه در هر تصویر | BSD |
| . | حذف زمینه | 500 نشانه در هر تصویر | Apache 2.0 |
| CogVideoX | تولید ویدئوی | 5000توکن/ويديو | Apache 2.0 |
| Demucs | جداسازی صداها | 500 تا توکن در هر آهنگ | MIT |
دسترسی به GPT-4، Claude، Gemini، Llama، DeepSeek، و ۳۴۰+ مدل دیگر. هزینه توکن بر اساس قیمت ارائهدهنده تبدیل به توکن ما است.
| مدل | ارائهدهنده | پیام | یادداشتها |
|---|---|---|---|
| GPT-4 یا کوچک | باز | ~20 | ارزان، سريع |
| Gemini ۲٫۰ فلش | گوگل | ~15 | خيلي سريع |
| ميسترال نيمو | Mistral | ~10 | ارزش زيادي داره |
| DeepSeek نسخه ۳ | DeepSeek | ~30 | استدلال قوي |
| Llama ۳٫۳ ۷۰ب | هدف | ~25 | وزنه باز |
| Claude Sonnet ۴ | انسانساخت | ~400 | کیفیت بالا |
| GPT-4o | باز | ~325 | کیفیت بالا |
| Qwen ۲٫۵ ۷۲ بی | علی بابا | ~40 | بزرگ، توانا |
فهرست کامل مدلهای ۳۴۶+ در /models/. همه از همان نقطه پایانی /v1/chat/ استفاده میکنند - فقط پارامتر model را تغییر دهید.
مدلهای خودمشترک: تو دقيقا به اندازه ي کاراکترهاي استفاده شده پول ميدي بدون هيچ افزايشي
مدلهای خارجی: our_tokens = provider_usd_cost × 100,000 × 1.30
مثال: GPT-4o هزینه ۰٫۰۰۲۵ دلار برای هر ۱۰۰۰ نشانه است. برای ۱۰۰۰ نشانه: ۰٫۰۰۲۵ دلار × ۱۰۰٬۰۰۰ × ۱٫۳۰ = 325 نشانه از حسابت
همۀ نقاط پایانی
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/ | حذف زمینه) 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، ۹۹ زبان) |
POST /v1/music/generate/ | تولید موسیقی از توصیف متن |
POST /v1/music/separate/ | جداسازی صداها/تصنیفها (Demucs) |
POST /v1/write/ | تولید محتوا (مقاله، ایمیل، داستان و غیره) |
POST /v1/code/generate/ | تولید کد در هر زبانی |
POST /v1/summarize/ | خلاصه کردن متن |
POST /v1/humanize/ | ایجاد متن AI به صدای انسانی |
POST /v1/detect/ | تشخیص محتوای تولید شده توسط هوش مصنوعی |
POST /v1/translate/ | ترجمه متن (MadLAD-400، ۴۵۰+ زبان) |
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/دقیقه | قیمت |
|---|---|---|---|
| آزاد | ۳۰K/روز (جمع) | 10 | $0 |
| پایه | 250K | 30 | $5/ماه |
| حرفه اي | 1.25M | 60 | 19 دلار در ماه |
| کار | 6.25M | 120 | 49 دلار در ماه |
| شرکت | سفارشی | سفارشی | تماس |
بستههای توکن موجود: ۲۰/۵ دلار، ۱ میلیون/۱۵ دلار، ۵ میلیون/۴۰ دلار.
پایتون
Python SDK
دسترسی به هر ابزار هوش مصنوعی از کد پایتون شما.
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 Code، Cursor و GitHub Copilot است.
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 tokens free/day. BYOK supported. 346+ models. نشست همگامسازی با Web IDE.
GitHub PyPI IDE وبBYOK) کلید خود را بیاورید ((
از کلیدهای API خود از هر ارائه دهنده استفاده کنید. صفر عوارض، صفر هزينه Free.ai فقط درخواست رو زير نظر داره
| ارائهدهنده | قالب کلید | مدلها | نشانگذاری |
|---|---|---|---|
| باز | sk-proj-xxx | GPT-4o، GPT-4o Mini، o1، o3، و غیره | $0 |
| انسانساخت | sk-ant-xxx | Claude Sonnet ۴، اپوس ۴، هایکو، و غیره | $0 |
| گوگل | AIzaSyxxx | Gemini ۲٫۵ حرفه ای، فلش، و غیره | $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
کليد، مصرف، فاکتور، بدون ثبت، بدون کسر از حساب Free.ai تو
API FAQ
"model": "openai/gpt-4o" یا "model": "anthropic/claude-sonnet-4". فهرست کامل در /apps/ یا GET /v1/models.»stream«: true را در درخواست گپ خود تنظیم کنید. پاسخها از طریق رویدادهای فرستاده شده توسط کارساز (SSE) ارسال میشوند.free_ai_usage.tokens_charged را چک کنید.pip install free-dot-ai. این هر نقطه پایانی را با پاسخهای تایپ شده میپوشاند. برای کمک به کدنویسی، pip install free-dot-ai-code را نصب کنید. این API همچنین OpenAI را دنبال میکند\