Free.ai Docs
Hurtigstart om 60 sekunder.
OpenAI-kompatibel chat API. One Bearer token, 400 + værktøjer. Kør denne krølle, og læs videre.
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!"}]}'Hvad vil du bygge?
Quickstarts
Chat
POST /v1/chat/
{
"model": "qwen2.5-7b",
"messages": [
{"role": "user", "content": "Hello!"}
]
}Billedgenerering
POST /v1/image/generate/
{
"model": "flux",
"prompt": "a quiet cabin at dusk",
"width": 1024,
"height": 1024
}Billedredigering
POST /v1/image/edit/
multipart:
image: <file>
prompt: "remove the chair"
operation: "edit"Tekst til tale
POST /v1/tts/
{
"model": "kokoro",
"voice": "af_heart",
"text": "Hello there!"
}Tale til tekst
POST /v1/stt/
multipart:
audio: <file>
model: "whisper-large-v3"
language: "auto"Oversæt
POST /v1/translate/
{
"text": "Hello",
"target_lang": "es"
}SDK
Python
pip install freeai-code
Nodenpm i freeai-code
Kør (på vej)
Ruby (kommer)
Eller brug OpenAI SDK punkt base_url på api.free.ai/v1
Opskrifter
Ofte stillede spørgsmål
Tilmeld dig på /signup/, bekræfte din e-mail, og åbne /account /?tab=api. Klik på Generer og en Bearer nøgle (sk-free-...) vises. Gem det ~ for sikkerhed, vi kun vise den fulde nøgle én gang.
JSON. Den /v1/chat/ respons afspejler OpenAI form: choices[].message. content for teksten, plus et brug objekt, der rapporterer symbolske omkostninger. Audio + billede endpoints returnerer en JSON konvolut med output_url, share_url, og credits_used.
Ja! Pass stream: sand på chat anmodninger. Svar ankommer som Server- Sendt Begivenheder med de samme data: {...} konvolut som OpenAI streaming protokol. Den endelige meddelelse er data: [DONE].
Ja. Passer et værktøj array pr OpenAI værktøj-calling skema. Native-tool-call modeller returnere strukturerede værktøj_calls; ikke-native modeller falder tilbage til en JSON-mode prompt, der udsender den samme form.
Ja. Vision-stand chat modeller accepterer image_url indhold dele (URLs eller base64). For STT, POST lyd som multipart / form-data til /v1/stt /. For PDF, brug /v1/pdf/extract / til OCR og chat om resultatet.
En månedlig opkaldshætte bundet til din plan (1.000 gratis, 10.000 Basic, 100.000 Pro, 1M Business) plus din købte symbolske balance. Der er ingen per-sekund gasspjæld. Den daglige gratis pool gælder kun for web-anmodninger, ikke API-opkald.
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.
Vi underskriver hver webhook med HMAC-SHA256 over den rå krop. Underskriften er i X-Free-Underskrift header (hex-kodet). Afvis enhver nyttelast, hvis signatur ikke matcher 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.
Den /v1/chat/ endpoint accepterer OpenAI ChatCompletion anmodning skema og returnerer den samme respons form. De fleste eksisterende OpenAI klientkode virker ved at ændre to linjer ~ base_url + api_key.
Ja! Hver selvhostet model er open source (Apache 2.0 / MIT). Vores gpu_api repo er offentlig; klone det, levere din GPU, og køre den samme inferens stak. For en styret privat cloud installation, kontakt os.
Selv-hostet modeller køre gratis på din 30.000-token daglig pool, så fakturere rå token tæller. Premium modeller er pay-as-you-go: 1.50× detail markup, falder til 1.30× på $ 500/30d og 1.15× på $ 2.000/30d. Live omkostninger er på hver model side og på hver API svar; token top-ups starter på $1.