Free.ai API

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

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

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

خرید توکن‌ها، سپس تولید کلید sk-free- خود

2
تماس با هر نقطه پایانی

گفتگو، تصاویر، 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": "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)
متن به گفتارName
POST /v1/tts/تولید گفتار) Kokoro, Piper, MeloTTS, Chatterbox (
POST /v1/tts/stream/جریان TTS (قطعات صوتی زمان واقعی)
تبدیل گفتار به متنComment
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/تشخیص محتوای تولید شده توسط هوش مصنوعی
ترجمه & OCR‌
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/دقیقهقیمت
آزاد5K/روز (جمع)10$0
پایه250K305 دلار در ماه
حرفه اي1.25M6019 دلار در ماه
کار6.25M12049 دلار در ماه
شرکتسفارشیسفارشیتماس

بسته‌های توکن موجود: ۲۰۰۰۰۰/۵ دلار، ۱ میلیون/۱۵ دلار، ۵ میلیون/۴۰ دلار.

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 IDE

BYOK) کلید خود را بیاورید ((

از کلیدهای API خود از هر ارائه دهنده استفاده کنید. صفر عوارض، صفر هزينه Free.ai فقط درخواست رو زير نظر داره

ارائه‌دهندهقالب کلیدمدلهانشان‌گذاری
هوش مصنوعی بازsk-proj-xxxGPT-4o, GPT-4o مینی، o1، o3، و غیره$0
انسان‌سالارانهsk-ant-xxx4.  ناصری، علی‌اکبر، و دیگران.$0
گوگلAIzaSyxxxGemini 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

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

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

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

Yes! The /v1/chat/ endpoint follows the OpenAI chat completions format. You can use any OpenAI-compatible SDK — just change the base URL to https://api.free.ai and use your Free.ai API key.

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

شما یک پاسخ ۴۰۲ با پیام خطا دریافت خواهید کرد. توکن‌های بیشتری را در /pricing/ خریداری کنید یا منتظر بازنشانی روزانه استخر آزاد خود باشید. مدل‌های خود میزبانی شده همیشه در محدوده‌های روزانه در دسترس هستند.

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

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

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

بله! SDK پایتون ما را نصب کنید: pip install free-dot-ai. این هر نقطه پایانی را با پاسخ‌های تایپ شده می‌پوشاند. برای کمک به کدنویسی، pip install free-dot-ai-code را نصب کنید. این API همچنین OpenAI را دنبال می‌کند\

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

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

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

رتبه بندی این صفحه