Free.ai Dokumentum
Gyorsindítás 60 másodperc múlva.
OpenAI-kompatibilis chat API. Egy Beaver token, 400+ eszközök. Futtassa ezt a fürtöt, majd olvassa tovább.
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!"}]}'
Mit akarsz építeni?
Gyorsindítások
Chat
POST /v1/chat/
{
"model": "qwen2.5-7b",
"messages": [
{"role": "user", "content": "Hello!"}
]
}
Képgenerálás
POST /v1/image/generate/
{
"model": "flux",
"prompt": "a quiet cabin at dusk",
"width": 1024,
"height": 1024
}
Képszerkesztés
POST /v1/image/edit/
multipart:
image: <file>
prompt: "remove the chair"
operation: "edit"
Szöveg a beszédhez
POST /v1/tts/
{
"model": "kokoro",
"voice": "af_heart",
"text": "Hello there!"
}
Beszéd a szöveghez
POST /v1/stt/
multipart:
audio: <file>
model: "whisper-large-v3"
language: "auto"
Fordítás
POST /v1/translate/
{
"text": "Hello",
"target_lang": "es"
}
SDK-k
Python
pip install freeai-code
Nodenpm i freeai-code
Menj, menj!
Ruby (bejövő)
Vagy api.free.ai/v1 ponthoz használja az OpenAI SDK-t.
Receptek
GYIK
Regisztráljon /signup/, erősítse meg az e-mailt, és nyissa meg /account/?tab=api. Kattintson a Generation és a Beader kulcs (sk-free-...) jelenik meg. Mentse el a biztonsági mi csak megjeleníti a teljes kulcs egyszer.
JSON. A /v1/chat/ response tükrözi az OpenAI alakját: chooses[].message.content for the text, plus a use object that reports token cost. Audio + image végpontok JSON boríték visszaküldése kimeneti_url, share_url, and credits_used.
A válaszok a Server-Sent Event-ként érkeznek, ugyanazokkal az adatokkal: {...} borítékkal, mint az OpenAI streaming protokoll. Az utolsó üzenet az adat:[DONE].
Igen. Passzold az eszközsort az OpenAI eszközhívó séma szerint. Native-tool-call modellek vissza strukturált eszköz_calls; nem-native modellek visszaesnek egy JSON-mód prompt, amely kibocsátja ugyanazt a formát.
Igen. Vision-cappable chat modellek elfogad kép_url tartalom alkatrészek (URLs vagy base64). STT, POST audio mint multipart/form-data to /v1/stt/. PDF, használd /v1/pdf/ kivonat / OCR és chat az eredményről.
A havi hívási sapkát a tervedhez kötötted (1000 ingyenes, 10 000 Basic, 100 000 Pro, 1M Business), plusz a megvásárolt token egyenlegedet. Nincs másodpercenkénti gázpedál. A napi ingyenes medence csak a webes kérésekre vonatkozik, nem az API hívásokra.
A nyers API-hoz az OpenAI SDK-k (Python + Node) és a legtöbb LLM keretrendszer (LangChain, LlamaIndex, Vercel AI SDK) működnek — állítsd a base_url-t https://api.free.ai/v1-re és a Bearer kulcsodat.
Minden webhook-ot a HMAC-SHA256-tal írunk alá a nyers test felett. Az aláírás az X-Free-Authorization fejlécben (hex-kódolva) található. Minden olyan rakományt elutasítunk, amelynek aláírása nem egyezik a HMAC-val (your_webhook_tread, 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.
A /v1/chat/ végpont elfogadja az OpenAI ChatCelement kérését, és ugyanazt a válaszformát adja vissza. A legtöbb létező OpenAI klienskód két sor megváltoztatásával működik: base_url + api_key.
Igen, minden önszálló modell nyílt forráskódú (Apache 2.0 / MIT). A gpu_api repó nyilvános; klónozza, szállítsa a GPU-t, és futtassa ugyanazt a következtetés stack. Egy irányított privát felhő telepítés, lépjen kapcsolatba velünk.
Önálló modellek fut ingyen a 30.000-token napi medence, majd számlázza a nyers token szám. Premium modellek fizetős-a-you-go: 1.50× kiskereskedelmi jelölés, csökken 1.30× $500/30d és 1.15× $2000/30d. Élő költség van minden modell oldalon és minden API válasz; token top-ups kezdődik $1.