Free.ai Docs
دەست پێکردنی خێرا لە ٦٠ چرکەدا.
.پێوانەی APIی گفتوگۆکردنی ئۆپن ئای. یەک نیشانەی بارکەر، ٤٠٠+ ئامراز. ئەم کورلە هەڵبگرە، پاشان بخوێنەوە
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"
}SDKs
Python
pip install freeai-code
Nodenpm i freeai-code
چوون
ڕوبی
یان بەکاربهێنە OpenAI SDK — پەرەپێدەری url لە api.free.ai/v1
ڕێنماییەکان
پرسیاری زۆر کراوە
تۆماربکە لە /signup/، ئیمەیڵەکەت پشتڕاستبکە، وە /account/؟tab=api بکەوە. بڕۆ سەر دروستکردن و کلیلی بارکەر (sk-free-...) دەردەکەوێت. بیپارێزە - بۆ ئاسایش ئێمە تەنها کلیلی تەواو نیشان دەدەین.
JSON. وەڵامی /v1/chat/ شێوەی ئۆپن ئایی نیشان دەدات: هەڵبژاردەکان[]. پەیام. شتەکان بۆ نوسراو، هەروەها بەکارهێنانی شت کە ڕاپۆرت دەکات لەسەر نرخی تیک. خاڵەکانی کۆتایی وێنە و دەنگ، کۆپییەکی JSON دەگەڕێنێتەوە لەگەڵ url_دەرچوون، url_بەشکردن، و credits_used.
بەڵێ - بڕۆن بە: ڕاست لەسەر داواکاریەکانی چاوپێکەوتن. وەڵامەکان دێن وەک ڕووداوەکانی خزمەتگوزاری-نێردراو لەگەڵ هەمان زانیاری: {...} پۆلێن وەک پرۆتۆکۆلی OpenAI ڕەوانەکردن. پەیامی کۆتایی بریتییە لە زانیاری: [تەواو].
بەڵێ. ئامرازێکی ئاڕشیڤ بە پێی نەخشەی بانگکردنی ئامرازی ئۆپن ئای بدە. مۆدێلی بانگکردنی ئامرازی نەتەوەیی گەڕانەوەی ئامرازی بانگکردنی رێکخراو؛ مۆدێلی نا نەتەوەیی دەگەڕێنەوە بۆ مۆدێکی JSON کە هەمان شێوەی دەردەکات.
بەڵێ. مۆدێلی چاوپێکەوتنی توانای بینین، بەشێکی ناوەوەی وێنە_url قبوڵ دەکات (URL یان بنکە٦٤). بۆ STT، دەنگەکە بە پۆست بکە وەک بەشێکی زۆر/داتایەکی فۆرم بۆ /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.
ئێمە ئیمزا لەسەر هەموو وێب هۆکێک دەکەین بە HMAC-SHA256 لەسەر لەشەکە. ئیمزاکە لە ناو سەرنامەی ئیمزاکردنی X-Free دایە (بە کۆدی هەژدەگۆشە). هەر بارێکی بەکارهێنەر کە ئیمزاکەی لەگەڵ HMAC (هەوا_وێب_هۆک_سەرەتا، لەش_سەرەتا)دا ناگونجێت ڕەت دەکەینەوە.
{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/ endpoint داواکاریی OpenAI ChatCompletion scheme قبوڵ دەکات و هەمان شێوەی وەڵامدانەوە دەگەڕێنێتەوە. زۆربەی کۆدی کڕیارەکانی OpenAI بە گۆڕینی دوو ڕستە کاردەکات - base_url + api_key.
بەڵێ - هەموو مۆدێلێکی خۆبەخشانە سەرچاوەی کراوەیە (ئاپاچی ٢.٠ / MIT). گەڕانی gpu_apiمان گشتییە؛ دووبارە دروستی بکە، GPU ی خۆت دابین بکە، وە هەمان ستاندەری لێکدانەوە هەڵبگرە. بۆ دابینکردنی هەورێکی تایبەت، پەیوەندیمان پێوە بکە.
مۆدێلی خۆبەخشانە بە خۆڕایی لەسەر 30,000 توكینی ڕۆژانەت بە خۆڕایی دەڕۆیت، پاشان حسابی توكینی خام. مۆدێلی پارە پارە دەدات وەک تۆ دەچیت: 1.50 × فرۆشتن، دابەزینی 1.30 × لە 500 / 30d و 1.15 × لە 2,000 / 30d. نرخی زیندوو لەسەر هەموو پەڕەی مۆدێل و لەسەر هەموو وەڵامی API یە؛ توكینی پەڕەی 1 $ دەست پێدەکات.