Free.ai API
يه کلید API، همه ابزارهای هوش مصنوعی، حسابداری ساده
چطور کار میکنه
دریافت کلید API
خرید توکنها، سپس تولید کلید sk-free- خود
تماس با هر نقطه پایانی
گفتگو، تصاویر، 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": "flux-schnell"}'
# 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": "flux-schnell", # 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: "flux-schnell" })
});
// 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 یا وب سایت استفاده کنید.
| مدل | نوع | هزینه نشانه | مجوز |
|---|---|---|---|
| کوئن ۲٫ ۵ ۷ بی | گپ زدن/نوشتن/کد | نشانکهای واقعی استفادهشده) ورودی+خروجی ( | آپاچی ۲٫ ۰ |
| FLUX.1 سریع | تولید تصویر | 1,000 نشانه/تصویر | آپاچی ۲٫ ۰ |
| کوکورو | متن به گفتارName | یک نشانه در هر ۴ نویسه | آپاچی ۲٫ ۰ |
| آهسته تر زمزمه کن | تبدیل گفتار به متنComment | ۴ نشانه در ثانیه صدا | ام آی تی |
| صداLDM ۲ | تولید موسیقی | 2000تاک/شاخ | آپاچی ۲٫ ۰ |
| . اوه ، اوه | ترجمه (۴۵۰+ صفحه) | نشانکهای واقعی استفادهشده | آپاچی ۲٫ ۰ |
| جستجوی واقعی | افزایش مقیاس تصویر | 500 نشانه در هر تصویر | BSD |
| . بله | حذف پسزمینه | 500 نشانه در هر تصویر | آپاچی ۲٫ ۰ |
| CogVideoXName | تولید ویدئو | 5000تاکن/ويديو | آپاچی ۲٫ ۰ |
| دموکس | جداسازی صداها | 500 تا توکن در هر آهنگ | ام آی تی |
دسترسی به GPT-4، Claude، Gemini، Llama، DeepSeek و ۳۴۰ مدل دیگر. هزینه توکن بر اساس قیمت ارائه دهنده تبدیل به توکن ما است.
| مدل | ارائهدهنده | پیام | یادداشتها |
|---|---|---|---|
| مینی GPT-4o | هوش مصنوعی باز | ~20 | ارزان، سريع |
| Gemini 2.0 فلش | گوگل | ~15 | خيلي سريع |
| ميسترال نيمو | میسترال | ~10 | ارزشش رو داره |
| DeepSeek V3Comment | جستجو عمیق | ~30 | استدلال قوی |
| 703. 703. 703. وبگاه رسمی | هدف | ~25 | وزنه باز |
| کلود سونت ۴ | انسانسالارانه | ~400 | کیفیت بالا |
| GPT-4o | هوش مصنوعی باز | ~325 | کیفیت بالا |
| 2.572B کوئن | علی بابا | ~40 | بزرگ، توانا |
فهرست کامل ۳۴۶ مدل در /apps/. همه از همان نقطه پایانی /v1/chat/ استفاده میکنند — فقط پارامتر model را تغییر دهید.
مدلهای خود میزبانیشده: تو دقيقا به اندازه ي کاراکترهاي استفاده شده پول ميدي بدون هيچ افزايشي
مدلهای خارجی: our_tokens = provider_usd_cost × 100,000 × 1.30
مثال: GPT-4o هزینه ۰٫۰۰۲۵ دلار برای هر ۱۰۰۰ نشانه است. برای ۱۰۰۰ نشانه: ۰٫۰۰۲۵ دلار × ۱۰۰٬۰۰۰ × ۱٫۳۰ = 325 نشانه از حسابت
تمام نقاط پایانی
POST /v1/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/ | رونوشت صدا/ویدئو (خفه شدن سریعتر، ۹۹ زبان) |
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/دقیقه | قیمت |
|---|---|---|---|
| آزاد | 5K/روز (جمع) | 10 | $0 |
| پایه | 250K | 30 | 5 دلار در ماه |
| حرفه اي | 1.25M | 60 | 19 دلار در ماه |
| کار | 6.25M | 120 | 49 دلار در ماه |
| شرکت | سفارشی | سفارشی | تماس |
بستههای توکن موجود: ۲۰۰۰۰۰/۵ دلار، ۱ میلیون/۱۵ دلار، ۵ میلیون/۴۰ دلار.
Python SDK و CLI
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"
5K tokens free/day. BYOK supported. 346+ models. نشست همگامسازی با Web IDE.
GitHub PyPI Web IDEBYOK) کلید خود را بیاورید ((
از کلیدهای API خود از هر ارائه دهنده استفاده کنید. صفر عوارض، صفر هزينه Free.ai فقط درخواست رو زير نظر داره
| ارائهدهنده | قالب کلید | مدلها | نشانگذاری |
|---|---|---|---|
| هوش مصنوعی باز | sk-proj-xxx | GPT-4o, GPT-4o مینی، o1، o3، و غیره | $0 |
| انسانسالارانه | sk-ant-xxx | 4. ناصری، علیاکبر، و دیگران. | $0 |
| گوگل | AIzaSyxxx | Gemini 2.5 Pro, Flash, و غیره | $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 دلاري
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 را دنبال میکند\