Free.ai Docs
Manomboka haingana ao anatin'ny 60 segondra.
APIn'ny resadresaka mifanaraka amin'ny OpenAI. Token iray, fitaovana mihoatra ny 400. Alefaso ity curl ity, dia vakio hatrany.
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!"}]}'Inona no tianao haorina?
Fandefasana haingana
Chat
POST /v1/chat/
{
"model": "qwen2.5-7b",
"messages": [
{"role": "user", "content": "Hello!"}
]
}Famoronana sary
POST /v1/image/generate/
{
"model": "flux",
"prompt": "a quiet cabin at dusk",
"width": 1024,
"height": 1024
}Hanova sary
POST /v1/image/edit/
multipart:
image: <file>
prompt: "remove the chair"
operation: "edit"Soratra ho teny miresaka
POST /v1/tts/
{
"model": "kokoro",
"voice": "af_heart",
"text": "Hello there!"
}Soratra ho an'ny feo
POST /v1/stt/
multipart:
audio: <file>
model: "whisper-large-v3"
language: "auto"Dikan-teny
POST /v1/translate/
{
"text": "Hello",
"target_lang": "es"
}SDK
Python
pip install freeai-code
Nodenpm i freeai-code
Mandehana
Ruby (ho avy)
Na mampiasa ny OpenAI SDK — mametraka ny base_url ao amin'ny api.free.ai/v1
Recipes
FAQ
Misoratra anarana ao amin'ny /signup/, manamafy ny adiresy mailakao, ary manokatra ny /account/?tab=api. Tsindrio ny Mamorona ary haseho ny famaha Bearer (sk-free-...) Raiketo io — noho ny fiarovana dia indroa fotsiny no asehontsika ny famaha feno.
JSON. Ny valin'ny /v1/chat/ dia mifanaraka amin'ny endrika OpenAI: choices[].message.content ho an'ny lahabolana, ary ny zavatra ampiasaina izay mitatitra ny vidin'ny token. Ny endpoints audio + image dia mamerina goavambe JSON misy output_url, share_url, ary credits_used.
Eny — omeo ny stream:true amin'ny fangatahana resadresaka. Ny valinteny dia tonga amin'ny endrika Zava-miseho nalefa avy amin'ny mpizara miaraka amin'ny data: {...} envelope mitovy amin'ny fifanarahana fandefasana mivantana OpenAI. data:[DONE] no hafatra farany.
Eny. Mandefa mariky ny fitaovana araka ny drafitra antso fitaovana OpenAI. Ny modely antso fitaovana nativa dia mamerina tool_calls miorina; ny modely tsy nativa dia miverina amin'ny fanontaniana JSON-mode izay mamoaka endrika mitovy.
Eny. Manaiky ny ampahany amin'ny votoatin'ny image_url (URL na base64) ireo modelin'ny resaka afaka mijery. Ho an'ny STT, mandefa audio amin'ny endrika multipart/form-data mankany amin'ny /v1/stt/. Ho an'ny PDF, mampiasa ny /v1/pdf/extract/ ho an'ny OCR ary miresaka momba ny vokatra.
Ny fetra isan-kerinandro amin'ny antso mifandraika amin'ny drafitrao (1,000 maimaimpoana, 10,000 Basic, 100,000 Pro, 1M Business) ary ny saldo token-nao. Tsy misy fameperana isan-segondra. Ny antso an-tserasera ihany no ahitana ny fetra isan-kerinandro.
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.
Manao sonia amin'ny HMAC-SHA256 ny webhook tsirairay eo ambonin'ny vatana tsy voavadika. Ao anatin'ny lohateny X-Free-Signature (mifototra amin'ny hexadecimal) ny sonia. Alefaso izay payload tsy mifanaraka amin'ny HMAC(ny_raharaha_maizina_amin'ny_webhook_oanao, vatana tsy voavadika) ny sonia.
{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.
Ny /v1/chat/ endpoint dia mandray ny drafitra OpenAI ChatCompletion ary mamaly amin'ny endrika mitovy. Ny ankamaroan'ny rindran'asa mpivatsy OpenAI dia miasa amin'ny fanovana andalana roa — base_url + api_key.
Eny — loharano misokatra (Apache 2.0 / MIT) ny modely tsirairay mipetraka manokana. Ho an'ny rehetra ny gpu_api repo-ntsika; adikao, omeo ny GPU-nao, ary alefao ny inference stack mitovy amin'izany. Raha mila fametrahana amin'ny rahona manokana, mifandraisa aminay.
Ny modely mikarakara tena dia mandeha maimaimpoana amin'ny tahirin-kevitrao isan'andro 30.000, avy eo mandoa ny isan'ny tokens tsy voatanisa. Ny modely premium dia mandoa araka ny ataonao: 1.50 × ny vidiny, miakatra ho 1.30 × amin'ny $ 500 / 30d ary 1.15 × amin'ny $ 2.000 / 30d. Ny vidiny mivantana dia eo amin'ny pejy tsirairay amin'ny modely sy amin'ny valiny API tsirairay; ny token top-ups dia manomboka amin'ny $ 1.