Free.ai Docs
Începe rapid în 60 de secunde.
API de chat compatibilă cu OpenAI. Un token de Bearer, 400+ instrumente. Executați acest curl, apoi citiți pe.
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!"}]}'Ce vrei să construieşti?
Porniri rapide
Chat
POST /v1/chat/
{
"model": "qwen2.5-7b",
"messages": [
{"role": "user", "content": "Hello!"}
]
}Generarea imaginii
POST /v1/image/generate/
{
"model": "flux",
"prompt": "a quiet cabin at dusk",
"width": 1024,
"height": 1024
}Editează imaginea
POST /v1/image/edit/
multipart:
image: <file>
prompt: "remove the chair"
operation: "edit"Text la discurs
POST /v1/tts/
{
"model": "kokoro",
"voice": "af_heart",
"text": "Hello there!"
}Discursul în text
POST /v1/stt/
multipart:
audio: <file>
model: "whisper-large-v3"
language: "auto"Traduce
POST /v1/translate/
{
"text": "Hello",
"target_lang": "es"
}SDK
Python
pip install freeai-code
Nodenpm i freeai-code
Du-te (venind)
Ruby (venind)
Sau folosiți SDK OpenAI — punct base_url la api.free.ai/v1
Rețete
Întrebări
Înregistrează-te la /signup /, confirmă e-mail-ul, și deschide /cont /?tab=api. Faceți clic pe Generație și apare o cheie Bearer (gratuit-...). Salvați-l — pentru securitate afișăm cheia completă doar o dată.
JSON. /v1/chat/ respons oglindă forma OpenAI: opțiuni[].message.content pentru text, plus un obiect de utilizare care raportează costul de token. Audio + puncte de referință de imagine returnează un plic JSON cu output_url, share_url, și credits_utilizat.
Da — pass stream:true la cererile de chat. Răspunsurile sosesc ca Server-Send Evenimente cu aceleași date: {...} plic cu protocolul OpenAI de streaming. Mesajul final este datele:[DONE].
Da. Pasează un array de unelte în cadrul schemei OpenAI de apel la unelte. Modelele de apel la unelte native returnează instrumentele de apel_calls structurate; modelele non-native cad înapoi la un prompt JSON-mode care emite aceeași formă.
Da. Modelele de chat visibile acceptă piese de conținut image_url (URL sau base64). Pentru STT, audio POST ca multipart/form-data pentru /v1/stt /. Pentru PDF, utilizați /v1/pdf/extract/ pentru OCR și discutați despre rezultat.
Un capac de apel lunar legat de planul dvs. (1000 gratis, 10.000 Basic, 100.000 Pro, 1M Business) plus soldul dvs. achiziţionat. Nu există nici un a doua lichid. Piscina gratuită zilnic se aplică numai cererilor web, nu apeluri API.
Pentru API-ul brut, SDK-urile OpenAI (Python + Node) și majoritatea cadrelor LLM (LangChain, LlamaIndex, Vercel AI SDK) funcționează — setați base_url la https://api.free.ai/v1 și cheia dvs. Bearer.
Semnăm fiecare webhook cu HMAC-SHA256 deasupra corpului crud. Semnătura este în headerul X-Free-Signature (encodat hex). Respinge orice sarcina pe care semnătura nu se potrivește HMAC(wu_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 acceptă schema de cerere OpenAI ChatCompletion și returnează aceeași formă de răspuns. Cel mai mare cod client OpenAI funcționează prin modificarea două linii — base_url + api_key.
Da — fiecare model auto-hosted este open-source (Apache 2.0 / MIT). Reporul nostru gpu_api este public; clona-l, furniza GPU-ul și rula același stack de inferințe. Pentru o instalație de cloud privat gestionat, contactați-ne.
Modelele auto-gazdă rulează gratuit pe piscina ta zilnică de 30.000 de token, apoi fact numărul de jetonuri brute. Modelele premium sunt pay-as-you-go: 1.50× markup cu amănuntul, cazând la 1.30× la $500/30d și 1.15× la $2.000/30d. Costul live este pe fiecare pagina de model și pe fiecare răspuns API; token top-ups începe la $ 1.