Free.ai Docs
Завяршэнне будаўніцтва за 60 дзён.
API чата, сумяшчальны з OpenAI. Адзін знак носителя, 400+ інструментаў. Запусціце гэты curl, а потым чытайце далей.
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!"
}
Праграма пераўтварэння мовы ў тэкстName
POST /v1/stt/
multipart:
audio: <file>
model: "whisper-large-v3"
language: "auto"
Пераклад
POST /v1/translate/
{
"text": "Hello",
"target_lang": "es"
}
Сродкі праграмавання
Python
pip install freeai-code
Nodenpm i freeai-code
Ісці (прыходзіць)
Ruby (будзе)
Або выкарыстоўвайце OpenAI SDK — паказвайце base_url на api.free.ai/v1
Рэцэпты
Частыя пытанні
Зарэгіструйцеся ў / signup /, пацвердзіце свой адрас электроннай пошты і адкрыйце / account /? tab=api. Націсніце Стварыць, і з' явіцца ключ на носьбіта (sk- free-...) Захаваць яго - для бяспекі мы паказваем поўны ключ толькі адзін раз.
JSON. Адказ / v1 / chat / адлюстроўвае форму OpenAI: choices[]. message. content для тэксту, плюс аб' ект выкарыстання, які паведамляе кошт токенаў. Канечнасць Audio + image вяртае канвэрт JSON з output_ url, share_ url і credits_ used.
Дазволіць - перадаваць stream:true пры запыце чата. Адказы прыходзяць як падзеі, адпраўленыя серверам, з тымі ж самымі даннымі: {...} канвэрт, як і пратакол OpenAI. Канчатковае паведамленне - data:[DONE].
Так. Перадайце масіў інструментаў па схеме выкліку інструментаў OpenAI. Нацыянальныя мадэлі выкліку інструментаў вяртаюць структураваныя tool_calls; ненацыянальныя мадэлі вяртаюцца да запыту рэжыму JSON, які выводзіць той жа выгляд.
Так. Модулі чата з падтрымкай відэа прымаюць часткі зместу image_url (URL або base64). Для STT, POST гук як multipart/form-data у /v1/stt/. Для PDF, выкарыстоўвайце /v1/pdf/extract/ для OCR і абмяркоўвайце вынік.
Месячны ліміт выклікаў, звязаны з вашым планам (1000 бясплатных, 10 Basic, 10 Pro, 1M Business) плюс ваш куплены баланс. Няма секунднай скідкі. Штодзённы бясплатны рэсурс дзейнічае толькі на запыты ў Сеціве, не на выклікі 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( ваш_ 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 / прымае схему запыту OpenAI ChatCompletion і вяртае той жа адказ. Большасць існуючых кліентаў 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.