API Free.ai

يه کلید API، همه ابزار هوش مصنوعی، حساب ساده

چطور کار میکنه

1
دریافت کلید API

توکن ها رو بخريد، بعدش کليد sk-free-تون رو توليد کنيد

2
فراخوانی هر نقطه پایانی

Chat، تصاویر، TTS، STT، موسیقی، ترجمه - همۀ آن یک API

3
پرداخت در توکن

يه حساب، هر ابزاري که ميخواي با توکن ميخري

آغاز سریع

# 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 ۲٫۵ ۷BChat/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/videoApache 2.0
Stem Separator (Mel-Band RoFormer + SCNet)جداسازی صداها500 تا توکن در هر آهنگMIT + Apache-2.0
مدلهای خارجی مدل هاي 579

دسترسی به 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 نشانه از حسابت

همۀ نقاط پایانی

Chat / LLM
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/modelsList 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
پایه250K30$5/ماه
حرفه اي1.25M6019 دلار در ماه
کار6.25M12049 دلار در ماه
شرکتسفارشیسفارشیتماس

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-xxxGPT-4o, GPT-4o Mini, o1, o3, و غیره$0
انسان‌ساختsk-ant-xxxClaude Sonnet 4, Opus 4, Haiku, و غیره$0
گوگلAIzaSyxxxGemini 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

حساب‌های رایگان روزانه ۳۰ توکن دریافت می‌کنند برنامه‌های پرداختی توکن‌های بیشتری و محدودیت‌های نرخ بالاتری را ارائه می‌دهند.

نه! همان توکن، همان قیمت. توازن توکن شما بین وب سایت و API مشترک است. هر کدام را استفاده کنید، همان هزینه را پرداخت کنید.

همان نقطه پایانی، فقط پارامتر مدل را تغییر دهید. برای مثال: "model": "openai/gpt-4o" or "model": "anthropic/claude-sonnet-4". فهرست کامل در /models/ یا GET /v1/models.

بله! نقطه پایانی /v1/chat/ از قالب تکمیل گپ OpenAI پیروی می‌کند. می‌توانید از هر SDK همگام با OpenAI استفاده کنید - فقط نشانی وب پایه را به https://api.free.ai تغییر دهید و از کلید API Free.ai خود استفاده کنید.

بله! تنظیم » جریان «: true در درخواست گپ‌زنی‌تان. پاسخ‌ها از طریق رویدادهای فرستاده شده کارساز (SSE) تحویل می‌شوند.

شما پاسخ 402 را با پیام خطا دریافت خواهید کرد. توکن‌های بیشتری را در /pricing/ خریداری کنید یا منتظر بازنشانی مجموعهٔ روزانه رایگان خود باشید. مدل‌های خود میزبانی همیشه در محدوده‌های روزانه در دسترس هستند.

بله! همه مدل هاي خود ميزبان تحت مجوز MIT/Apache 2.0 هستند. محتواي توليد شده براي استفاده تجاري مال شماست.

خود میزبان: روی GPU ما اجرا می‌شود. ارزان‌ترین، سریع‌ترین، خصوصی‌ترین. خارجی: به ارائه‌دهنده مدل پیشکار می‌شود. دسترسی به GPT-4، Claude، Gemini و بیشتر. به دلیل هزینه‌های API ارائه‌دهنده، توکن‌های بیشتری هزینه می‌کند.

از صفحه حساب خود در /account/ بازدید کنید یا free_ai_usage.tokens_charged را در هر پاسخ API بررسی کنید.

Yes! Install our Python SDK: 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

ما هدف 99.9% uptime را داریم. برنامه‌های شرکتی شامل تضمین SLA هستند. /health را برای وضعیت زمان واقعی بررسی کنید.

ایمیل hello@free.ai یا بازدید /contact/. Pro+ برنامه‌ها پشتیبانی اولویت دارند. پاسخ‌های خطا شامل یک error_id برای اشکال‌زدایی است.

دوست Free.ai رو به دوستانت بگو

رتبه این صفحه