Free.ai Docs
60 sekunt içinde çalt başla
OpenAI-hoşlaşýan gürleş API. Bir Berer tokeni, 400+ esbaplar. Bu curl'i işlet, soňra oka.
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!"}]}'Sen näme gurmak isleýärsiň?
Tiz Başlanç
Chat
POST /v1/chat/
{
"model": "qwen2.5-7b",
"messages": [
{"role": "user", "content": "Hello!"}
]
}Resim
POST /v1/image/generate/
{
"model": "flux",
"prompt": "a quiet cabin at dusk",
"width": 1024,
"height": 1024
}Resim Editle
POST /v1/image/edit/
multipart:
image: <file>
prompt: "remove the chair"
operation: "edit"Metinden söze
POST /v1/tts/
{
"model": "kokoro",
"voice": "af_heart",
"text": "Hello there!"
}Sözden metin
POST /v1/stt/
multipart:
audio: <file>
model: "whisper-large-v3"
language: "auto"Terjime
POST /v1/translate/
{
"text": "Hello",
"target_lang": "es"
}SDK
Python
pip install freeai-code
Nodenpm i freeai-code
_Git
Ruby (geljekde)
Ýoksa OpenAI SDK ullan — api.free.ai/v1 adresinde basa_url ullan
Reçeteler
Gynançly Soraglar
/signup/ adresinde ýaz, e-poçtuňyzy tassykla we /account/?tab=api aç. Bejer we bir Berjer adyny (sk-free-...) görkez. Gaýd et - howpsuzlyk üçin biz doly adyny diňe bir gezek görkezýäris.
JSON. /v1/chat/ jogap OpenAI şekili aňladýar: choices[].message.content metin üçin, plus bir ulanmak zady ki token bahasyny habar berýär. Ses + resim soň noktalary output_url, share_url, we credits_used bilen bir JSON envelope gaýtarýar.
Eý — gürleşmek soraglar üçin stream:true geç. Jawalar OpenAI gürleşmek protokoly ýaly bir zat bilen Serwer-Gitdiren Wajyplyklar bolup gelýärler: {...} envelope. Soñky habar data:[DONE].
Eý. OpenAI alet-çakyş skemasyna görä bir alet arşiwi geç. Öz-alet-çakyş modelleri gurlan alet_çakyşlary gaýtarýar; öz-alet-çakyş bolmadyk modeller şol bir şekili çykarýan JSON-mode soraga dolanyp geler.
Eý. Görmek ukyply gürleşiş modelleri image_url mazmun böleklerini kabul edýär (URLs ýa base64). STT üçin, POST audio multipart/form-data to /v1/stt/. PDF üçin, OCR üçin /v1/pdf/extract/ ullan we netije barada gürleş.
Bir aýlyk jaň çäklendirmesi planyňyza baglanyşykly (1,000 free, 10,000 Basic, 100,000 Pro, 1M Business) plus siziň satyn alan token balansy. Bir sekuntda durdurmak ýok. Her günki jaň çäklendirmesi diňe web soramalara degişli, API jaňlar däl.
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.
Biz her bir webhook'y HMAC-SHA256 bilen hamyrdan aşa imzalaýarys. Imza X-Free-Signature başlygda (hex-encoded) bar. Emzasy HMAC(your_webhook_secret, raw_body) bilen gabat gelmeýän her bir payload'y ret et.
{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.
/v1/chat/ ahyryny kabul edýä OpenAI ChatCompletion soragy skemasyny we şol bir jogap şekili gaýtarýar. Eklemeli OpenAI kliýent kodynyň köpüsi iki hat üýtgedip işleýär — base_url + api_key.
Eý — her bir öz-özüne-hoşlaşan mody açyk çeşmedir (Apache 2.0 / MIT). Biziň gpu_api repomyz halk üçindir; ony klonlaň, GPU-nyza beriň, we şol bir inference stack-y işlediň. Tertiplenen hususy bulut oýnamak üçin bize ýüz tutyň.
Öz-özüne hosted modeller siziň 30,000-token günlük poolyňyzda mugt işleýär, soňra ösümlik token sany üçin töleg kabul edýär. Premium modeller, siz gitýän ýaly töleg alýarlar: 1.50× retail markup, $500/30d-de 1.30×-e düşýän we $2,000/30d-de 1.15×-e düşýän. Live cost is on every model page and on every API response; token top-ups start at $1.