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 | Chat/Write/Code | نشانکهای واقعی استفادهشده) ورودی+خروجی ( | 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 | تولید ویدئوی | 30,000 tokens/video | Apache 2.0 |
| Stem Separator (Mel-Band RoFormer + SCNet) | جداسازی صداها | 500 تا توکن در هر آهنگ | MIT + Apache-2.0 |
دسترسی به GPT-6، Claude، Gemini، Llama، DeepSeek و بقیه مدلهای 579. هزینه توکن بر اساس قیمت ارائهدهنده تبدیل به توکنهای ما است.
| مدل | ارائهدهنده | پیام | یادداشتها |
|---|---|---|---|
| GPT-4 یا کوچک | باز | ~20 | ارزان، سريع |
| Gemini ۲٫۰ فلش | گوگل | ~15 | خيلي سريع |
| ميسترال نيمو | Mistral | ~10 | ارزش زيادي داره |
| DeepSeek نسخه ۳ | DeepSeek | ~30 | استدلال قوي |
| Llama ۳٫۳ ۷۰ب | هدف | ~25 | وزنه باز |
| Claude Sonnet ۴ | انسانساخت | ~400 | کیفیت بالا |
| GPT-4o | باز | ~325 | کیفیت بالا |
| Qwen ۲٫۵ ۷۲ بی | علی بابا | ~40 | بزرگ، توانا |
فهرست کامل مدلهای 579 در /models/. همهٔ آنها از همان نقطهٔ پایانی /v1/chat/ استفاده میکنند - فقط پارامتر model را تغییر دهید.
مدلهای خودمشترک: تو دقيقاً به اندازه ي يه جعبه پول ميدي بدون هيچ افزايشي
مدلهای خارجی: our_tokens = provider_usd_cost × 100,000 × 1.30
مثال: GPT-4o هزینه $0.0025 برای هر 1K نشانه prompt. برای 1,000 نشانه: $0.0025 × 100,000 × 1.30 = 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/ | صداها/ستونها جدا (Mel-Band RoFormer + SCNet) |
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/دقیقه | قیمت |
|---|---|---|---|
| آزاد | 30K/ روز (جمع) | 10 | $0 |
| پایه | 250K | 30 | $5/ماه |
| حرفه اي | 1.25M | 60 | 19 دلار در ماه |
| کار | 6.25M | 120 | 49 دلار در ماه |
| شرکت | سفارشی | سفارشی | تماس |
Token packs available: 200K/$5, 1M/$15, 5M/$40. Tokens never expire.
پایتون
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"
PyPI
PyPI
دستیار کدگذاری CLI
جایگزین آزاد و متنباز برای Claude Code، Cursor و GitHub Copilot.
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 tokens free/day. BYOK supported. 579 models. نشست همگامسازی با Web IDE.
PyPI PyPI IDE وبBYOK) کلید خود را بیاورید ((
از کلیدهای API خود از هر ارائه دهنده استفاده کنید. صفر عوارض، صفر هزينه Free.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. | مدلهاي 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 تو
API FAQ
"model": "openai/gpt-4o" or "model": "anthropic/claude-sonnet-4". فهرست کامل در /models/ یا GET /v1/models. » جریان «: 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