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 3.6 35B | 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 تاکون/ويديو | Apache 2.0 |
| Stem Separator (Mel-Band RoFormer + SCNet) | جداسازی صداها | 500 تا توکن در هر آهنگ | MIT + Apache-2.0 |
دسترسی به GPT-6، Claude، Gemini، Llama، DeepSeek و بقیه مدلهای 575. هزینه توکن بر اساس قیمت ارائهدهنده تبدیل به توکنهای ما است.
| مدل | ارائهدهنده | ~Tokens per message) ۵۰۰ ورودی، ۳۰۰ خروجی ( |
|---|---|---|
| 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 نشانه های prompt، بنابراین 1,000 نشانه های prompt هزینه $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/ | مقیاسبندی ۲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/embeddings/ | متن توکار: BGE-M3 پیشفرض، یا "model": "embeddinggemma-2" برای EmbeddingGemma 2 (768 dims, dimensions 128 to 768, input_type query or document) |
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/ماه | درخواستهای API/دقیقه | قیمت |
|---|---|---|---|---|
| آزاد | 30,000 a day (free pool) | 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 پیشفرض، در صورت درخواست بالا میرود | تماس |
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.
# 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 tokens free/day. BYOK supported. 575 models. نشست همگامسازی با Web IDE.
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. | مدلهاي 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
"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