Free.ai Docs
Nhazi n'ime sekọnd 60.
OpenAI-compatible chat API. Otu Bearer token, 400+ tools. Run this curl, then read on.
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!"}]}'Gịnị ka ịchọrọ ịrụ?
Nhazi
Chat
POST /v1/chat/
{
"model": "qwen2.5-7b",
"messages": [
{"role": "user", "content": "Hello!"}
]
}Kewapụta inyogo
POST /v1/image/generate/
{
"model": "flux",
"prompt": "a quiet cabin at dusk",
"width": 1024,
"height": 1024
}Dezie inyogo
POST /v1/image/edit/
multipart:
image: <file>
prompt: "remove the chair"
operation: "edit"Tẹ́ètị̀ ka ọ̀sụ̀sụ̀
POST /v1/tts/
{
"model": "kokoro",
"voice": "af_heart",
"text": "Hello there!"
}Nsụgharị
POST /v1/stt/
multipart:
audio: <file>
model: "whisper-large-v3"
language: "auto"Banye
POST /v1/translate/
{
"text": "Hello",
"target_lang": "es"
}SDKs
Python
pip install freeai-code
Nodenpm i freeai-code
Gaa (na-abịa)
Ruby (na-abịa)
Ma ọ bụ jiri OpenAI SDK — pịa base_url na api.free.ai/v1
Nhazi
Ajụjụ ndị na-emekarị
Nweta akaụntụ na /nweta akaụntụ/, hụ na ị na-ekwenye imeelụ gị, wee mepee /akaụntụ/?tab=api. Pịa Bipụta ma kii Bearer (sk-free-...) ga-egosi. Chekwaa ya - maka nchekwa anyị na-egosi naanị kii zuru ezu otu oge.
JSON. /v1/chat/ nzaghachi ahụ na-egosipụta OpenAI: nhọrọ[]. ozi.ihe n'ime maka ngwe ahụ, nakwa ihenhọrọ ojieme nke na-egosipụta ego token. Audio + inyogo ngwụcha-ọnụọgụgụ na-eziga envelopu JSON na output_url, share_url, na credits_used.
Ya - banye n'okporo: eziokwu na arịrịọ nkata. Ndepụta nzaghachi na-abịa dịka ihenhọrọ ndị a bịaara sava na data dị ka: {...} envelopu dịka OpenAI n'okporo protokol. Ozi nke ikpeazụ bụ data:[DONE].
Ee. Kpụga araya ihenhọrọ n'ime OpenAI ihenhọrọ-akpọrọ schema. Ihenhọrọ-akpọrọ-ihenhọrọ-ọdịiche na-eziga ihenhọrọ_ọdịiche emeredịkachọrọ; ihenhọrọ ndị na-abụghị ndị ọbụla na-apụ n'ihu na JSON-mode n'ihi na ọ na-eweta ụdị dị ka nke ahụ.
Ee. Nlebara anya-ekwenyere na-enwe ike ịgwakọta móòdù na-anabata akụkụ nke ihenhọrọ_url (URLs mọọbụ base64). Maka STT, POST ụda dịka multipart/fómù-data na /v1/stt/. Maka PDF, jiri /v1/pdf/extract/ ka OCR ma gwakọta banyere nsonaazụ ahụ.
N'ụbọchị ọbụla, a ga-akpọ gị oku na-ejikọta ya na usoroiheomume gị (1,000 free, 10,000 Basic, 100,000 Pro, 1M Business) nakwa ego nke ịzụrụ. Enweghị n'ime sekọnd ọbụla. Ọtụtụ ụbọchị ọbụla na-emetụta naanị arịrịọ weebụ, ọ bụghị 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.
Anyị na-eziga webụhooks niile na HMAC-SHA256 n'elu ụbụrụ ahụ. Ọnụọgụgụ ahụ dị na X-Free-Signature header (hex-encoded). Wepụ ọbụla payload nke ụkpụrụ ahụ anaghị adịcha 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/ ngwụcha-ọnụọgụgụ na-anabata OpenAI ChatCompletion nkwekọrịta schema nakwa na-eziga n'ihu ọha nke ọbụla. Ọtụtụ n'ime ihenhọrọ ndị dị ugbua nke OpenAI na-arụ ọrụ site n'ịgbanwe laịnụ abụọ - base_url + api_key.
Ee - ọbụna-ọ
Self-na-