Free.ai Docs
شروع سریع تا 60 ثانیه
API گفتگوی سازگار با OpenAI. یک نشانه حامل، ۴۰۰+ ابزار. این خم را اجرا کنید، سپس ادامه دهید.
curl https://api.free.ai/v1/chat/ \
-H "Authorization: Bearer sk-free-YOUR-KEY" \
-H "Content-Type: application/json" \
-d '{"model":"qwen2.5-7b","messages":[{"role":"user","content":"Hello!"}]}'ميخواي چي بسازي؟
شروع سریع
Chat
POST /v1/chat/
{
"model": "qwen2.5-7b",
"messages": [
{"role": "user", "content": "Hello!"}
]
}تولید تصویر
POST /v1/image/generate/
{
"model": "flux",
"prompt": "a quiet cabin at dusk",
"width": 1024,
"height": 1024
}ویرایش تصویر
POST /v1/image/edit/
multipart:
image: <file>
prompt: "remove the chair"
operation: "edit"متن به گفتارName
POST /v1/tts/
{
"model": "kokoro",
"voice": "af_heart",
"text": "Hello there!"
}تبدیل گفتار به متن
POST /v1/stt/
multipart:
audio: <file>
model: "whisper-large-v3"
language: "auto"ترجمه
POST /v1/translate/
{
"text": "Hello",
"target_lang": "es"
}SDKها
Python
pip install freeai-code
Nodenpm i freeai-code
برو
روبی (در راه)
یا از OpenAI SDK استفاده کنید — point base_url at api.free.ai/v1
دستورالعمل
پرسش و پاسخ
در /signup/ ثبت نام کنید ، ایمیل خود را تأیید کنید ، و /account/?tab=api را باز کنید. تولید را فشار دهید و یک کلید حامل (sk-free-...) ظاهر میشود. ذخیره کنید — برای امنیت ما کلید کامل را فقط یک بار نمایش میدهیم.
JSON. پاسخ /v1/chat/ شکل OpenAI را نشان میدهد: choices[].message.content برای متن، به علاوه یک شیء استفاده که هزینه توکن را گزارش میدهد.
بله — گذر دادن جریان: درست در درخواستهای گپ. پاسخها به عنوان رویدادهای ارسال شده توسط سرور با همان پوشه داده: {...} به عنوان پروتکل جریان OpenAI میآیند. پیام نهایی داده: [انجام شده] است.
بله. یک آرایه ابزار را بر اساس طرح فراخوانی ابزار OpenAI منتقل کنید. مدلهای فراخوانی ابزار بومی tool_calls ساختاری را برمیگردانند؛ مدلهای غیر بومی به یک دستور حالت JSON که شکل مشابهی را تولید میکند، باز میگردند.
بله. مدلهای گپ قابلیت دید بخشهای محتوای image_url را (URLها یا base64) میپذیرند. برای STT، صدا را به عنوان multipart/form-data به /v1/stt/ ارسال کنید. برای PDF، از /v1/pdf/extract/ برای OCR استفاده کنید و در مورد نتیجه گپ بزنید.
یک حد تماس ماهانه به برنامه شما متصل است (۱۰۰۰ رایگان، ۱۰ پایه، ۱۰۰۰ پرو، ۱ میلیون کسب و کار) به علاوه توازن توکن خریداری شده شما. هیچ محدودیتی بر اساس ثانیه وجود ندارد. مجموعه رایگان روزانه فقط برای درخواستهای وب اعمال میشود، نه برای تماسهای API.
freeai-code on npm + PyPI for our Coder IDE wrapper. For the raw API, the OpenAI SDKs (Python + Node) and most LLM frameworks (LangChain, LlamaIndex, Vercel AI SDK) work — set base_url to https://api.free.ai/v1 and your Bearer key.
ما هر webhook را با HMAC-SHA256 در بدنه خام امضا میکنیم. امضای در سرآیند X-Free-Signature (رمزگذاری هگزی) است. هر بار مفید که امضای آن با HMAC(your_webhook_secret, raw_body) تطابق ندارد را رد کنید.
{error:{message, type, code}}. 402 = out of credits (response includes upgrade URL + shortfall in tokens). 429 = daily pool exhausted (web only). 400 = validation error. 5xx = our problem; retry with exponential backoff.
نقطه پایانی /v1/chat/ طرحواره درخواست OpenAI ChatCompletion را میپذیرد و همان شکل پاسخ را برمیگرداند. بیشتر کدهای مشتری موجود OpenAI با تغییر دو خط کار میکند — base_url + api_key.
بله — هر مدل خود میزبانی شده منبع باز است (آپاچی ۲٫۰ / MIT). ذخیرهگاه gpu_api ما عمومی است؛ آن را شبیه سازی کنید، پردازنده گرافیکی خود را تأمین کنید، و همان پشته استنتاج را اجرا کنید. برای نصب ابر خصوصی مدیریت شده، با ما تماس بگیرید.
مدلهای پریمیوم به صورت پرداخت در هنگام استفاده هستند: 1.50× مارکت خرده فروشی، کاهش به 1.30× در $500/30d و 1.15× در $2,000/30d. هزینه زنده در هر صفحه مدل و در هر پاسخ API است؛ توکنهای اضافه از $1 شروع میشود.