Free.ai Dokumenti
Quickstart f'60 sekonda.
OpenAI-kompatibbli chat API. One Bearer token, 400 + għodod. Mexxi dan curl, imbagħad aqra fuq.
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!"}]}'X'tixtieq tibni?
Bidu mgħaġġel
Chat
POST /v1/chat/
{
"model": "qwen2.5-7b",
"messages": [
{"role": "user", "content": "Hello!"}
]
}Ġenerazzjoni ta’ immaġni
POST /v1/image/generate/
{
"model": "flux",
"prompt": "a quiet cabin at dusk",
"width": 1024,
"height": 1024
}Editja l-immaġni
POST /v1/image/edit/
multipart:
image: <file>
prompt: "remove the chair"
operation: "edit"Test għal diskors
POST /v1/tts/
{
"model": "kokoro",
"voice": "af_heart",
"text": "Hello there!"
}Diskors għal test
POST /v1/stt/
multipart:
audio: <file>
model: "whisper-large-v3"
language: "auto"Ittraduċi
POST /v1/translate/
{
"text": "Hello",
"target_lang": "es"
}SDKs
Python
pip install freeai-code
Nodenpm i freeai-code
Go (li ġej)
Ruby (li ġejjin)
Jew uża l-OpenAI SDK — punt base_url fil api.free.ai/v1
Riċetti
Mistoqsijiet Frekwenti
Irreġistra fuq /signup/, ikkonferma l-email tiegħek, u tiftaħ /account/?tab=api. Ikklikkja Iġġenera u tidher ċavetta tal-Bearer (sk-free-...) Ħażinha — għas-sigurtà nuru ċ-ċavetta sħiħa darba biss.
JSON. It-tweġiba /v1/chat/ tirrifletti l-forma OpenAI: choices[].message.content għat-test, flimkien ma' oġġett ta' użu li jirrapporta l-ispiża tat-token. Audio + image endpoints jirritorna envelop JSON b'output_url, share_url, u credits_used.
Iva — jgħaddu stream:true fuq talbiet chat. Tweġibiet jaslu bħala Avvenimenti Mibgħuta-Server bl-istess data: {...} envelope bħala l-OpenAI streaming protokoll. Il-messaġġ finali huwa data:[MADE].
Iva. Pass a tools array per l-iskema OpenAI tool-sejħa. mudelli nattivi-għodda-sejħa jirritorna tool_calls strutturati; mudelli mhux nattivi jaqgħu lura għal JSON-modalità prompt li jarmi l-istess forma.
Iva. Il-mudelli taċ-chat li jistgħu jaraw jaċċettaw partijiet tal-kontenut image_url (URLs jew base64). Għal STT, POST l-awdjo bħala multipart/form-data għal /v1/stt/. Għal PDF, uża /v1/pdf/extract/ għall-OCR u iċċettja dwar ir-riżultat.
Limitu ta'sejħa ta' kull xahar marbut mal-pjan tiegħek (1,000 b'xejn, 10,000 Bażiku, 100,000 Pro, 1M Negozju) flimkien mal-bilanċ tat-token mixtri tiegħek.M'hemm l-ebda throttle kull sekonda.Il-pool b'xejn ta' kuljum japplika biss għal talbiet tal-web, mhux sejħiet API.
Għall-API mhux maħdum, l-OpenAI SDKs (Python + Node) u ħafna mill-oqfsa LLM (LangChain, LlamaIndex, Vercel AI SDK) jaħdmu — issettja base_url għal https://api.free.ai/v1 u ċ-ċavetta Bearer tiegħek.
Aħna niffirmaw kull webhook b'HMAC-SHA256 fuq il-korp mhux maħdum. Il-firma hija fl-intestatura X-Free-Signature (hex-encoded). Irrifjuta kwalunkwe payload li l-firma tiegħu ma taqbilx ma' 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.
Il-punt aħħari /v1/chat/ jaċċetta l-iskema tat-talba OpenAI ChatCompletion u jirritorna l-istess forma ta' tweġiba.Ħafna mill-kodiċi tal-klijent OpenAI eżistenti jaħdem billi jinbidlu żewġ linji — base_url + api_key.
Iva — kull mudell awto-ospitat huwa open-source (Apache 2.0 / MIT). gpu_api repo tagħna huwa pubbliku; klona, ipprovdi l-GPU tiegħek, u tmexxi l-istess inferenza stack. Għal installazzjoni sħaba privata ġestita, ikkuntattjana.
Mudelli awto-ospitati jimxu b'xejn fuq il-pool ta'kuljum tiegħek ta'30,000 token, imbagħad iħallsu l-għadd tat-tokens mhux maħdum. Mudelli premium huma pay-as-you-go: 1.50 × markatura bl-imnut, li taqa'għal 1.30 × f'$ 500/30d u 1.15 × f'$ 2,000/30d.