Free.ai Docs
Brzi start za 60 sekundi.
OpenAI-kompatibilni API za razgovor. Jedan nosilac, preko 400 alata. Pokreni ovaj curl, a zatim čitaj dalje.
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!"}]}'Šta želiš da izgradiš?
Brzi start
Chat
POST /v1/chat/
{
"model": "qwen2.5-7b",
"messages": [
{"role": "user", "content": "Hello!"}
]
}Generiranje slika
POST /v1/image/generate/
{
"model": "flux",
"prompt": "a quiet cabin at dusk",
"width": 1024,
"height": 1024
}Izmijeni sliku
POST /v1/image/edit/
multipart:
image: <file>
prompt: "remove the chair"
operation: "edit"Tekst u govor
POST /v1/tts/
{
"model": "kokoro",
"voice": "af_heart",
"text": "Hello there!"
}Pretvorba govora u tekst
POST /v1/stt/
multipart:
audio: <file>
model: "whisper-large-v3"
language: "auto"Prevedi
POST /v1/translate/
{
"text": "Hello",
"target_lang": "es"
}SDK
Python
pip install freeai-code
Nodenpm i freeai-code
Idi.
Ruby (dolazi)
Ili koristite OpenAI SDK — point base_url at api.free.ai/v1
Recepti
FAQ
Prijavite se na /signup/, potvrdite svoj email, i otvorite /account/?tab=api. Kliknite na Generiraj i pojavit će se nosilac ključa (sk-free-...) Spremite ga - zbog sigurnosti prikazujemo puni ključ samo jednom.
JSON. Odgovor /v1/chat/ zrcali OpenAI oblik: choices[].message.content za tekst, plus objekt upotrebe koji izvještava o cijeni tokena. Audio + slikovne krajnje tačke vraćaju JSON omotnicu sa output_url, share_url, i credits_used.
Da — proslijedi stream:true na zahtjeve za razgovor. Odgovori stižu kao događaji poslani sa servera sa istim podacima: {...} omotnica kao OpenAI protokol za streaming. Konačna poruka je data:[DONE].
Da. Proslijedi niz alata po OpenAI shemi pozivanja alata. Modeli sa nativnim pozivom alata vraćaju strukturirane tool_calls; modeli koji nisu nativni vraćaju se na JSON-mode prompt koji emitira isti oblik.
Da. Modeli za razgovor koji podržavaju vid prihvaćaju dijelove sadržaja image_url (URL-ove ili base64). Za STT, POST audio kao multipart/form-data u /v1/stt/. Za PDF, koristite /v1/pdf/extract/ za OCR i razgovarajte o rezultatu.
Mjesečno ograničenje poziva vezano za vaš plan (1,000 besplatnih, 10,000 osnovnih, 100,000 profesionalnih, 1M poslovnih) plus vaša kupljena bilanca tokena. Nema usporavanja po sekundi. Dnevni besplatni fond se odnosi samo na web zahtjeve, ne API pozive.
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.
Svaki webhook se potpisuje sa HMAC-SHA256 preko sirovog tijela. Potpis je u X-Free-Signature zaglavlju (heksadecimalno kodirano). Odbaci svaki korisni teret čiji se potpis ne podudara sa HMAC(vaša_tajna_webhooka, sirovo_tijelo).
{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.
Krajnja tačka /v1/chat/ prihvaća OpenAI ChatCompletion zahtjevnu shemu i vraća isti oblik odgovora. Većina postojećeg OpenAI klijentskog koda radi mijenjanjem dvije linije — base_url + api_key.
Da — svaki model koji se sam hostira je otvoreni kod (Apache 2.0 / MIT). Naš gpu_api repo je javni; kloniraj ga, isporuči svoj GPU, i pokreni isti inference stack. Za upravljanu privatnu instalaciju u oblaku, kontaktiraj nas.
Samohosting modeli rade besplatno na vašem dnevnom bazenu od 30.000 tokena, a zatim naplaćuju sirovi broj tokena.Premium modeli su pay-as-you-go: 1.50× maloprodajna marža, pada na 1.30× na $500/30d i 1.15× na $2.000/30d.