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 3.6 35BChat/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
مدلهای خارجی مدل هاي 575

دسترسی به GPT-6، Claude، Gemini، Llama، DeepSeek و بقیه مدل‌های 575. هزینه توکن بر اساس قیمت ارائه‌دهنده تبدیل به توکن‌های ما است.

مدلارائه‌دهنده~Tokens per message) ۵۰۰ ورودی، ۳۰۰ خروجی (
GPT-4o-miniOpenAI~286
Mistral NemoMistral~100
Llama 3.3 70B InstructMeta~639
Qwen2.5 72B InstructQwen~337
DeepSeek V3DeepSeek~493
GPT-4oOpenAI~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 نرخ استاندارد است. حساب‌ها با هزینه ماهانه بالا، نرخ پایین‌تری پرداخت می‌کنند.

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

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/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/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/ماهدرخواست‌های API/دقیقهقیمت
آزاد30,000 a day (free pool)1,00060$0
پایه250,00010,000120ماهي $5
حرفه اي1,250,000100,000300ماهي $19
کار6,250,0001,000,000600ماهي $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-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.مدل‌هاي 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

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

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

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

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

بله! تنظیم » جریان «: 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 همراه نیست.

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

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

بيشتر ميخواي؟ ثبت‌نام رایگان: 30,000 توکن در روز ثبت نام

به این صفحه امتیاز دهید