Free.ai Docs
Snel starten over 60 seconden.
OpenAI-compatibele chat API. One Bearer token, 400+ tools. Voer deze krul uit en lees verder.
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!"}]}'Wat wil je bouwen?
Snelstarten
Chat
POST /v1/chat/
{
"model": "qwen2.5-7b",
"messages": [
{"role": "user", "content": "Hello!"}
]
}Afbeeldingsgeneratie
POST /v1/image/generate/
{
"model": "flux",
"prompt": "a quiet cabin at dusk",
"width": 1024,
"height": 1024
}Afbeelding bewerken
POST /v1/image/edit/
multipart:
image: <file>
prompt: "remove the chair"
operation: "edit"Tekst naar spraak
POST /v1/tts/
{
"model": "kokoro",
"voice": "af_heart",
"text": "Hello there!"
}Toespraak naar tekst
POST /v1/stt/
multipart:
audio: <file>
model: "whisper-large-v3"
language: "auto"Vertalen
POST /v1/translate/
{
"text": "Hello",
"target_lang": "es"
}SDK's
Python
pip install freeai-code
Nodenpm i freeai-code
Ga (komend)
Ruby (komend)
Of gebruik de OpenAI SDK-punt base_url op api.free.ai/v1
Recepten
Veelgestelde vragen
Schrijf je in bij /signup/, bevestig je e-mail en open /account/?tab=api. Klik op Genereren en er verschijnt een Bearer-toets (sk-free-...). Bewaar het voor de veiligheid, we tonen alleen de volledige sleutel één keer.
JSON. De /v1/chat/respons weerspiegelt de OpenAI-vorm: keuzes[].message.content voor de tekst, plus een gebruiksobject dat tokenkosten rapporteert. Audio + beeldeindpunten geven een JSON-envelop terug met output_url, share_url en credits_used.
Ja, pass stream:true on chat requests. Reacties komen aan als Server-Sent Events met dezelfde gegevens: {...} envelop als het OpenAI streaming protocol. Het laatste bericht is data: [DOEN].
Ja. Geef een gereedschapsarray door per de OpenAI-tool-calling schema. Native-tool-call modellen geven gestructureerde tool_calls terug; niet-native modellen vallen terug naar een JSON-mode prompt die dezelfde vorm uitstraalt.
Ja. Vision-compatible chat modellen accepteren image_url content parts (URLs of base64). Voor STT, POST audio als multipart/form-data naar /v1/stt/. Gebruik voor PDF /v1/pdf/extract/ naar OCR en praat over het resultaat.
Een maandelijkse call cap gebonden aan uw plan (1.000 gratis, 10.000 Basic, 100.000 Pro, 1M Business) plus uw gekochte token saldo. Er is geen per seconde gas. De dagelijkse gratis zwembad alleen van toepassing op webverzoeken, niet API-oproepen.
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.
We ondertekenen elke webhook met HMAC-SHA256 over het ruwe lichaam. De handtekening staat in de X-Free-Handtekening header (hex-gecodeerd). Verwerp elke lading waarvan de handtekening niet overeenkomt met 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.
Het /v1/chat/-eindpunt accepteert het OpenAI ChatCcompleter-verzoekschema en geeft dezelfde responsvorm terug. De meeste bestaande OpenAI clientcode werkt door twee regels te veranderen: base_url + api_key.
Ja, elk zelf-gehost model is open-source (Apache 2.0 / MIT). Onze gpu_api repo is openbaar; kloon het, lever uw GPU, en voer dezelfde gevolgtrekking stack. Voor een managed private cloud installatie, neem contact met ons op.
Zelf-gehoste modellen draaien gratis op uw 30.000-token dagelijkse zwembad, dan factuur de ruwe token tellen. Premium modellen zijn pay-as-you-go: 1,50× retail markup, dalend tot 1,30× bij $500/30d en 1,15× bij $2.000/30d. Live kosten is op elke modelpagina en op elke API-respons; token top-ups beginnen bij $1.