Free.ai mga dokumento
Ang 60 ay isang taon sa kalendaryo.
OpenAI-kapareho chat API. Isang bearer token, 400 + mga tool. Patakbuhin ang curl na ito, pagkatapos ay basahin ang.
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!"}]}'
Ano ang gusto mong bumuo?
Mga Quickstarts
Chat
POST /v1/chat/
{
"model": "qwen2.5-7b",
"messages": [
{"role": "user", "content": "Hello!"}
]
}
Image henerasyon
POST /v1/image/generate/
{
"model": "flux",
"prompt": "a quiet cabin at dusk",
"width": 1024,
"height": 1024
}
I-edit ang imahe
POST /v1/image/edit/
multipart:
image: <file>
prompt: "remove the chair"
operation: "edit"
Teksto sa pananalita
POST /v1/tts/
{
"model": "kokoro",
"voice": "af_heart",
"text": "Hello there!"
}
Pagsasalita sa teksto
POST /v1/stt/
multipart:
audio: <file>
model: "whisper-large-v3"
language: "auto"
Isalin
POST /v1/translate/
{
"text": "Hello",
"target_lang": "es"
}
Mga SDK
Python
pip install freeai-code
Nodenpm i freeai-code
Pumunta (darating)
Ruby (darating)
O gamitin ang OpenAI SDK — point base_url sa api.free.ai/v1
Mga Recipe
FAQ
Mag-sign up sa /signup/, kumpirmahin ang iyong email, at buksan ang /account/?tab=api. I-click ang Bumuo at isang Bearer key (sk-free-...) ay lilitaw. I-save ito — para sa seguridad lamang namin ipakita ang buong key ng isang beses.
Ang /v1/chat/ na tugon ay sumasalamin sa hugis ng OpenAI: choices[].message.content para sa teksto, at isang bagay na paggamit na nag-uulat ng gastos ng token. Ang mga audio + imahe na mga endpoint ay nagbabalik ng isang JSON na envelope na may output_url, share_url, at credits_used.
Oo — pumasa stream: totoo sa mga kahilingan chat. Tugon dumating bilang Server-Ipadala Kaganapan sa parehong data: {...} envelope bilang ang OpenAI streaming protocol. Ang huling mensahe ay data: [DONE].
Oo. Ipasa ang isang tool array bawat OpenAI tool-pagtawag schema. Native-tool-call modelo bumalik naka-istraktura tool_calls; non-native modelo mahulog pabalik sa isang JSON-mode prompt na emits ang parehong hugis.
Para sa STT, POST audio bilang multipart/form-data sa /v1/stt/. Para sa PDF, gamitin ang /v1/pdf/extract/ sa OCR at makipag-chat tungkol sa resulta.
Isang buwanang tawag cap nakatali sa iyong plano (1,000 libreng, 10,000 Basic, 100,000 Pro, 1M Business) pati na rin ang iyong binili token balanse. Walang per-second throttle. Ang araw-araw na libreng pool ay nalalapat lamang sa web requests, hindi API tawag.
Para sa raw API, ang OpenAI SDKs (Python + Node) at karamihan sa mga LLM frameworks (LangChain, LlamaIndex, Vercel AI SDK) trabaho — itakda ang base_url sa https://api.free.ai/v1 at ang iyong Bearer key.
Mag-sign kami ng bawat webhook na may HMAC-SHA256 sa ibabaw ng raw na katawan. Ang lagda ay sa X-Free-Signature header (hex-encoded). Tanggihan ang anumang payload na ang lagda ay hindi tumutugma sa HMAC (your_webhook_secret, raw_body).
Ang 402 = out of credits (ang tugon ay kasama ang pag-upgrade ng URL + kakulangan sa mga token). 429 = araw-araw na pool exhausted (web lamang). 400 = error sa pagpapatunay. 5xx = ang aming problema; subukan muli sa eksponensiyal na backoff.
Ang /v1/chat/ endpoint ay tumatanggap ng OpenAI ChatCompletion request schema at nagbabalik ng parehong hugis ng tugon. Karamihan sa mga umiiral na OpenAI client code ay gumagana sa pamamagitan ng pagbabago ng dalawang linya — base_url + api_key.
Oo — bawat self-hosted modelo ay open-source (Apache 2.0 / MIT). Ang aming gpu_api repo ay pampubliko; clone ito, supply ang iyong GPU, at patakbuhin ang parehong konklusyon stack. Para sa isang pinamamahalaang pribadong cloud i-install, makipag-ugnay sa amin.
Self-hosted modelo tumakbo libre sa iyong 30,000-token araw-araw pool, pagkatapos ay bill ang raw token count. Premium modelo ay pay-as-you-go: 1.50 × retail markup, drop sa 1.30 × sa $ 500 / 30d at 1.15 × sa $ 2,000 / 30d. Live gastos ay sa bawat modelo ng pahina at sa bawat API tugon; token top-ups simula sa $ 1.