Free.ai Docs
Жылдам старт 60 секунддан кийин.
OpenAI-компатибельный чат API. Один носитель, 400+ инструментов. Запустите эту программу, а затем продолжайте читать.
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!"}]}'Эмне курууну каалайсыз?
Жылдам старт
Chat
POST /v1/chat/
{
"model": "qwen2.5-7b",
"messages": [
{"role": "user", "content": "Hello!"}
]
}Сүрөттү жаратуу
POST /v1/image/generate/
{
"model": "flux",
"prompt": "a quiet cabin at dusk",
"width": 1024,
"height": 1024
}Сүрөттү оңдоо
POST /v1/image/edit/
multipart:
image: <file>
prompt: "remove the chair"
operation: "edit"Тексттен сүйлөмгө
POST /v1/tts/
{
"model": "kokoro",
"voice": "af_heart",
"text": "Hello there!"
}Сөздөн текстке
POST /v1/stt/
multipart:
audio: <file>
model: "whisper-large-v3"
language: "auto"Котормо
POST /v1/translate/
{
"text": "Hello",
"target_lang": "es"
}SDKs
Python
pip install freeai-code
Nodenpm i freeai-code
Жөнөтүү
Ruby (жаңыланууда)
Же OpenAI SDK колдоно аласыз — point base_url at api.free.ai/v1
Рецепттер
Кайсы
/signup/ дарегине катталып, электрондук дарегиңизди тастыктап, /account/?tab=api ачыңыз. Жаңы ключ пайда болот. Аны сактоо үчүн, коопсуздук үчүн, биз толук ачкычты бир жолу гана көрсөтөбүз.
JSON. /v1/chat/ жооп OpenAI формасын чагылдырган: текст үчүн choices[].message.content, плюс колдонуу объекти, ал токендин баасын билдирет. Аудио + сүрөттүн аяктоо пункттары output_url, share_url жана credits_used менен JSON конвертти кайтарат.
Да — чат-запросу stream:true өткөрүү. Жауаптар серверден жөнөтүлгөн окуялар катары келет, OpenAI поток протоколу сыяктуу эле дата: {...} конверт менен. Акыркы билдирүү data:[DONE].
Да. OpenAI-tool-call схемасына ылайык tools-масивди өткөрүү. Native-tool-call моделдери структураланган tool_calls кайтарат; non-native моделдери ошол эле форманы чыгаруучу JSON-mode суроосуна кайтып келишет.
Да. Визуалдык чат моделдери image_url мазмун бөлүгүн (URLs же base64) кабыл алат. STT үчүн, аудиону multipart/form-data катары /v1/stt/ге POST кылыңыз. PDF үчүн, OCR үчүн /v1/pdf/extract/ колдонуп, натыйжа жөнүндө чатта сүйлөшүңүз.
Планга ылайык айлык чалуулардын чектөөсү (1000 акысыз, 10 негизи, 10 профессионал, 1М бизнес) жана сатып алынган токендердин балансы. Секунддук чектөө жок. Күнүнө акысыз чалуулардын чектөөсү веб-запростарга гана тиешелүү, API-запростарга тиешелүү эмес.
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.
Биз ар бир webhook-ду HMAC-SHA256 менен сырсөздөрүнүн үстүнөн кол коюп коёбуз. Кол коюу X-Free-Signature заголовогунда (шестнадцатеричная кодировка) болот. HMAC(your_webhook_secret, 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.
/v1/chat/ endpoint принимает OpenAI ChatCompletion request scheme и возвращает тот же ответный формат. Большинство существующих OpenAI клиентских кодов работает с двумя строками — base_url + api_key.
Да — бардык өздүк хостингдеги моделдер ачык булактуу (Apache 2.0 / MIT). Биздин gpu_api репозиторийибиз коомдук; аны клондоңуз, GPUңузду камсыз кылыңыз, жана ошол эле инференциялык стекти иштетиңиз. Башкарылган жеке облак орнотуу үчүн биз менен байланышыңыз.
Өз алдынча хосттолгон моделдер сиздин 30,000-токен күндүк пулуңузга акысыз иштешет, андан кийин сырьё токендердин саны боюнча эсепке алынат. Премиум моделдер сиз колдонгондо төлөнөт: 1.50 × сатуу маркировкасы, 1.30 × $500/30d жана 1.15 × $2,000/30d. Жаңы баасы ар бир модель бетинде жана ар бир API жооп; токендердин топ-устары $1ден башталат.