Free.ai Xuquuqda
Quickstart in 60 ilbiriqsi.
OpenAI-ka mid ah API chat. Mid ka mid ah Bearer token, 400 + qalab. Run this curl, ka dibna akhriso.
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!"}]}'Maxaad dooneysaa inaad dhisto?
Bilow deg deg ah
Chat
POST /v1/chat/
{
"model": "qwen2.5-7b",
"messages": [
{"role": "user", "content": "Hello!"}
]
}Soosaarka Sawirka
POST /v1/image/generate/
{
"model": "flux",
"prompt": "a quiet cabin at dusk",
"width": 1024,
"height": 1024
}Edit Image
POST /v1/image/edit/
multipart:
image: <file>
prompt: "remove the chair"
operation: "edit"Qoraalka-u-hadalka
POST /v1/tts/
{
"model": "kokoro",
"voice": "af_heart",
"text": "Hello there!"
}Erayo u beddel qoraal
POST /v1/stt/
multipart:
audio: <file>
model: "whisper-large-v3"
language: "auto"_Gaar
POST /v1/translate/
{
"text": "Hello",
"target_lang": "es"
}SDK-yada
Python
pip install freeai-code
Nodenpm i freeai-code
Go (coming)
Ruby (soo socda)
Ama isticmaal OpenAI SDK — dhibic base_url at api.free.ai / v1
Waxyaabaha la cuno
Su'aalaha La Weydiiyo
Ku soo biir /signup/, xaqiiji emailkaaga, oo fur /account/?tab=api. Riix abuuro oo calaamad qaade ah (sk-free-...) ayaa soo muuqata. Kaydi — ammaanka waxaan kaliya muujinaynaa calaamada buuxda mar.
JSON. The / v1 / chat / jawaabta ka muuqataa qaabka OpenAI: choices [].message.content ee qoraalka, iyo sidoo kale wax isticmaalka oo warbixin ku saabsan qiimaha token. Audio + sawirka endpoints soo celin JSON envelope la output_url, share_url, iyo credits_used.
Haa — gudbinta stream:true on chat requests. jawaabaha yimaadaan sida Server-Diray dhacdooyinka la mid ah: {...} envelope sida OpenAI streaming protocol. fariinta ugu dambeysa waa xogta:[DONE].
Haa. Ku gudbi qalab isku dhafan oo ku saabsan OpenAI qalab-dhaqaale schema. Native-tool-call models soo celin dhisan tool_calls; qaabab aan asalka ahayn dib u dhacaan si ay u JSON-mode soo jeedin ah oo soo saarta qaabka isku mid ah.
Haa. aragtida-qaabili chat qaabab aqbalaan image_url qaybaha content (URLs ama base64). STT, POST audio sida multipart / qaabka-data in / v1 / stt /. PDF, isticmaal / v1 / pdf / soo qaado / in OCR iyo wada hadal ku saabsan natiijada.
A bille ah codsiga cagaha la xidhiidha qorshahaaga (1,000 bilaash ah, 10,000 Basic, 100,000 Pro, 1M Business) iyo sidoo kale aad iibsatay token miisaaniyadda. Ma jiro per-second throttle. The maalin kasta oo bilaash ah pool kaliya ku saabsan codsiyada web, ma API wicitaanada.
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.
Waxaan saxiixnaa webhook kasta oo leh HMAC-SHA256 oo ka badan jirka raw. Saxiixa waa X-Free-Saxiixda madaxa (hex-coded). Diid wax kasta oo payload oo saxiixa ma aha mid la mid ah 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.
The / v1 / chat / endpoint aqbalaa OpenAI ChatCompletion codsiga schema iyo soo celin qaabka jawaabta isku mid ah. ugu badan ee jira OpenAI code macaamiisha shaqooyinka by bedelka laba liis — base_url + api_key.
Haa - mid kasta oo ka mid ah moodooyinka la martigeliyey ayaa ah mid furan (Apache 2.0 / MIT). Gpu_api repo waa dadweyne; ku dheji, siiso GPU-gaaga, oo ku rakib isku-darka soo-saarka. Si aad u isticmaasho rakibid daruuro gaar ah oo la maamulo, nala soo xiriir.
Models Premium waa lacag-sida-aad-gasho: 1.50 × iibka, hoos u dhaca 1.30 × at $ 500 / 30d iyo 1.15 × at $ 2,000 / 30d. Qiimaha nool waa bogga moodel kasta iyo jawaabta API kasta; token top-ups waxay ka bilaabaan $ 1.