Free.ai Docs
Qala ngokushesha emaminithini angama-60.
I-OpenAI-compatible chat API. I-Bearer token eyodwa, 400+ amathuluzi. Sebenzisa le curl, bese ufunda.
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!"}]}'Ufuna ukwakha yini?
Isiqalo esikhawulelwe
Chat
POST /v1/chat/
{
"model": "qwen2.5-7b",
"messages": [
{"role": "user", "content": "Hello!"}
]
}Ukukhiqizwa kwesithombe
POST /v1/image/generate/
{
"model": "flux",
"prompt": "a quiet cabin at dusk",
"width": 1024,
"height": 1024
}Hlela isithombe
POST /v1/image/edit/
multipart:
image: <file>
prompt: "remove the chair"
operation: "edit"Umbhalo kumazwi
POST /v1/tts/
{
"model": "kokoro",
"voice": "af_heart",
"text": "Hello there!"
}Ukukhuluma ku-imeyli
POST /v1/stt/
multipart:
audio: <file>
model: "whisper-large-v3"
language: "auto"Guqulela
POST /v1/translate/
{
"text": "Hello",
"target_lang": "es"
}I-SDKs
Python
pip install freeai-code
Nodenpm i freeai-code
Iya (kuyafika)
i-Ruby (izoba)
Noma sebenzisa i-OpenAI SDK — khomba i-base_url ku-api.free.ai/v1
Izithako
Imibuzo ebuzwa kaningi
Ubhalise ku /signup/, qinisekisa i-imeyili yakho, bese uvula /account/?tab=api. Chofoza yenza futhi isithonjana somsebenzisi (sk-free-...) sizovela. Gcina - ngenxa yokuphepha sizobonisa isithonjana esigcwele kabili.
JSON. U /v1/chat/ uphendula umbala we OpenAI: choices[].message.content for the text, plus a use object that reports token cost. Isithombe + isiqephu sesithombe sibuyisela i-JSON envelope nge output_url, share_url, ne credits_used.
Yebo — dlulisa umsuka:true kumibuzo yokuxoxa. Izinsiza zifika njengezimo ezithunyelwe-ngu-Isisebenzisi ngedatha efanayo: {...} envelope njenge-OpenAI stream protocol. Umlayezo wokugcina yi-data:[DONE].
Yebo. Phatha ithuluzi le-array nge-OpenAI tool-calling scheme. Amamodeli we-native-tool-call abuyisela ama-tool_calls afakwe kahle; amamodeli anga-native abuyela emuva ku-JSON-mode prompt ekhipha ifomu elifanayo.
Yebo. Amamodeli okukhuluma akwazi ukukubona amukela ama-image_url aqukethe ama-parts (ama-URL noma i-base64). U-STT, thumela umsindo njengengxenye eminingi/ifomu-data ku /v1/stt/. U-PDF, sebenzisa /v1/pdf/extract/ ku-OCR bese ukhuluma ngemiphumela.
Izinga lokunweba lonyaka elihlobene ne-plan yakho (1,000 mahhala, 10,000 Basic, 100,000 Pro, 1M Business) kanye ne-token yakho ethengisiwe. Akukho lutho oluzokwehla ngesekondi. Izinga lokunweba losuku lonke lisebenza kuphela kuma-web requests, hhayi kuma-API calls.
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.
Sifaka isitifiketi kunoma iyiphi i-webhook nge-HMAC-SHA256 phezu kwengxenye emnyama. Isitifiketi sikhona kwi-X-Free-Signature header (hex-encoded). Sula noma iyiphi impahla esebenzayo enesitifiketi esingalingani ne-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.
I /v1/chat/ endpoint ivuma i OpenAI ChatCompletion isicelo seschema futhi ibuyisela umphumela ofanayo. Ikhodi yekhasimende le OpenAI ekhona isebenza ngokuguqula imigqa emibini — base_url + api_key.
Yebo - yonke imodeli egcinwe ngokwayo ivulekile (Apache 2.0 / MIT). I-gpu_api repo yethu ivela kumphakathi; iklonwe, ihlinzeka nge-GPU yakho, futhi iqhube i-inference stack efanayo. Ukufaka i-cloud elawulwayo, xhumana nathi.
Amamodeli akhokhelwayo akhokhelwa ngokukhokha-njengoba-uhamba: 1.50 × ukuhweba okuncane, ukuwa 1.30 × ku- $ 500 / 30d no-1.15 × ku- $ 2,000 / 30d. Izindleko eziphilayo zitholakala kukhasi ngalinye lemodeli futhi kunoma iyiphi impendulo ye-API; ama-token top-ups aqala ku- $ 1.