Free.ai dokumentë
Fillimi i shpejtë për 60 sekonda.
API e bisedimeve e përshtatshme me OpenAI. Një token i mbajtësit, më shumë se 400 instrumente. Ekzekuto këtë kurl, pastaj vazhdo lexuesin.
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!"}]}'Çfarë do të ndërtosh?
Fillimi i shpejtë
Chat
POST /v1/chat/
{
"model": "qwen2.5-7b",
"messages": [
{"role": "user", "content": "Hello!"}
]
}Gjenerati
POST /v1/image/generate/
{
"model": "flux",
"prompt": "a quiet cabin at dusk",
"width": 1024,
"height": 1024
}Ndrysho figurën
POST /v1/image/edit/
multipart:
image: <file>
prompt: "remove the chair"
operation: "edit"Teksti në fjalë
POST /v1/tts/
{
"model": "kokoro",
"voice": "af_heart",
"text": "Hello there!"
}Fjalë në tekst
POST /v1/stt/
multipart:
audio: <file>
model: "whisper-large-v3"
language: "auto"Përkthe
POST /v1/translate/
{
"text": "Hello",
"target_lang": "es"
}SDK
Python
pip install freeai-code
Nodenpm i freeai-code
Shko (po vjen)
Ruby (në pritje)
Ose përdor OpenAI SDK — point base_url në api.free.ai/v1
Recepta
FAQ
Regjistrohu tek /signup/, konfirmo emailin tënd dhe hap /account/?tab=api. Kliko Gjenero dhe shfaqet një kyç i përmbajtjes (sk-free-...) Ruaje atë — për siguri shfaqim kyçin e plotë vetëm një herë.
JSON. Përgjigja /v1/chat/ pasqyron formën OpenAI: choices[].message.content për tekstin, plus një objekt përdorimi që raporton koston e token. Pikat e fundit audio + imazh kthejnë një zarf JSON me output_url, share_url dhe credits_used.
Po — kalo stream:true tek kërkesat e bisedimeve. Përgjigjet vijnë si Evente të dërguar nga serveri me të njëjtin zarf të të dhënave: {...} si protokolli i transmetimit OpenAI. Mesazhi përfundimtar është data:[DONE].
Po. Përcille një array instrumentesh sipas skemës së thirrjeve të instrumentit OpenAI. Modelet e thirrjeve të instrumenteve native kthejnë thirrje të strukturuara; modelet jo-native kthehen tek një kërkesë e modalitetit JSON që nxjerr të njëjtën formë.
Po. Modelet e chat-it me aftësi vizuale pranojnë pjesë të përmbajtjes image_url (URL-a ose base64). Për STT, POST audio si multipart/form-data në /v1/stt/. Për PDF, përdor /v1/pdf/extract/ për OCR dhe bisedo për rezultatin.
Një limit muajtar i telefonatave i lidhur me planin tuaj (1,000 falas, 10,000 Bazë, 100,000 Pro, 1M Biznes) plus balanci i token-it të blerë. Nuk ka kufizim për sekond. Pool-i i përditshëm i lirë aplikohet vetëm tek kërkesat web, jo tek thirrjet 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.
Ne firmosim çdo webhook me HMAC-SHA256 mbi trupin e papërpunuar. Firmosja është në header X-Free-Signature (e koduar me heks). Refuzo çdo ngarkim që nuk përputhet me 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.
Pika e fundit /v1/chat/ pranon skemën e kërkesës OpenAI ChatCompletion dhe kthen të njëjtën formë përgjigjeje. Shumica e kodit ekzistues të klientëve OpenAI punon duke ndryshuar dy rreshta — base_url + api_key.
Po — çdo model i vetë-pritur është me burim të hapur (Apache 2.0 / MIT). Repo jonë gpu_api është publike; klonoje atë, furnizoje GPU-në tënde dhe kryej të njëjtin stack inference. Për një instalim të menaxhuar në re private, kontakto me ne.
Modelet e vetë-hostuara funksionojnë pa pagesë në poolin tuaj të përditshëm 30,000 token, pastaj faturoni numrin e tokenit të papërpunuar. Modelet Premium janë të paguajnë-si-ju-shkon: 1.50 × shitje me pakicë, duke rënë në 1.30 × në $ 500 / 30d dhe 1.15 × në $ 2,000 / 30d. Kostoja e gjallë është në çdo faqe modeli dhe në çdo përgjigje API; token top-ups fillojnë në $ 1.