Free.ai وثيقة
البداية السريعة في 60 ثانية
.. API متوافق مع OpenAI.. رمز واحد لحامل, 400+ أداة..
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"تحويل النص إلى كلمة
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"
}مجموعات برامج الحاسوب
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 للنص، بالإضافة إلى كائن استخدام يبلغ عن تكلفة الرموز.
نعم — تمرير stream:true على طلبات المحادثة. تصل الردود كأحداث مرسلة من الخادم مع نفس المظروف data: {...} مثل بروتوكول تدفق OpenAI.
نعم. تمر مصفوفة أدوات حسب مخطط استدعاء الأدوات OpenAI. النماذج الأصلية لاستدعاء الأدوات تعيد tool_calls منظمة؛ النماذج غير الأصلية تعود إلى نداءات JSON-mode التي تصدر نفس الشكل.
نعم، نماذج المحادثة القادرة على الرؤية تقبل أجزاء من محتوى image_url (URLs أو base64). وبالنسبة لـ STT، أرسل الصوت كبيانات متعددة الأجزاء/نموذج إلى /v1/stt/. وبالنسبة لـ PDF، استخدم /v1/pdf/extract/ لتحديد الصورة بالتعرف البصري على الحروف والتحدث عن النتيجة.
حد أقصى للمكالمات الشهرية مرتبط بخطة عملك (1,000 مجاني، 10,000 أساسي، 100,000 برو، 1M أعمال) بالإضافة إلى رصيد الرموز المشتراة. لا يوجد ضغط على كل ثانية. المجموع اليومي المجاني ينطبق فقط على طلبات الويب، وليس مكالمات 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 header ( hex-encoded). رفض أي payload الذي لا يطابق التوقيع 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.
نعم - كل نموذج مستضاف ذاتيا هو مفتوح المصدر (أباتشي 2.0 / معهد ماساتشوستس للتكنولوجيا). مخزن gpu_api الخاص بنا عام؛ استنسخه، وزود وحدة المعالجة المركزية الخاصة بك، وتشغيل نفس كومة الاستنتاجات. للحصول على تثبيت سحابي خاص مدارة، يرجى الاتصال بنا.
تقوم النماذج المستضافة ذاتيا بالعمل مجانًا على مجمعك اليومي من الرموز 30،000، ثم تقوم بفرض رسوم على عدد الرموز الخام. وتدفع النماذج العالية الجودة حسب استخدامها: 1.50 × علامة التجزئة، وتنخفض إلى 1.30 × عند 500 دولار / 30 يوم و 1.15 × عند 2،000 دولار / 30 يوم. التكلفة الحية هي على كل صفحة نموذج وعلى كل استجابة API؛ تبدأ رموز التغذية من $ 1.