Free.ai Docs
Szybki start za 60 sekund.
Kompatybilny z OpenAI czat API. Jeden token Nośnika, 400+ narzędzia. Uruchom ten kwir, a następnie przeczytaj dalej.
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!"}]}'Co chcesz zbudować?
Szybkie starty
Chat
POST /v1/chat/
{
"model": "qwen2.5-7b",
"messages": [
{"role": "user", "content": "Hello!"}
]
}Wytwarzanie obrazków
POST /v1/image/generate/
{
"model": "flux",
"prompt": "a quiet cabin at dusk",
"width": 1024,
"height": 1024
}Edycja obrazków
POST /v1/image/edit/
multipart:
image: <file>
prompt: "remove the chair"
operation: "edit"Tekst do wypowiedzi
POST /v1/tts/
{
"model": "kokoro",
"voice": "af_heart",
"text": "Hello there!"
}Przemówienie do tekstu
POST /v1/stt/
multipart:
audio: <file>
model: "whisper-large-v3"
language: "auto"Przetłumacz
POST /v1/translate/
{
"text": "Hello",
"target_lang": "es"
}SDKs
Python
pip install freeai-code
Nodenpm i freeai-code
Idź (nadejdzie)
Ruby (przychodzi)
Albo używać OpenAI SDK — punktowa baza_url at api.free.ai/v1
Przepisy
FAQ
Zarejestruj się na /signup /, potwierdź swój e-mail, i open / account /?tab=api. Kliknij Generować i klawisz Nośnika (sk-free-...) pojawia się. Zapisz to — dla bezpieczeństwa wyświetlamy tylko jeden pełny klucz.
JSON. Odpowiedź /v1/chat/ response odzwierciedla kształt OpenAI: wybory[].message.content dla tekstu, plus obiekt użytkowania, który zgłasza koszty tokena. Audio + punkt końcowy obraz zwraca kopertę JSON z wyjściem_url, share_url i kredyt_ użyty.
Tak — prześlij stream:true na żądania czatu. Odpowiedzi przybywają jako Wydarzenia Server-Sent z tymi samymi danymi: {...} koperta co protokoł streaming OpenAI. Ostateczna wiadomość to dane:[DONE].
Tak. Przekazywanie tablicy narzędzi w schemacie wywołania narzędzi OpenAI. Native-tool-call models zwraca ustrukturyzowane narzędzia_ calls; nienatywne modele wracają do trybu JSON, który emituje ten sam kształt.
Tak. Modele czatu wizyjnego akceptują części treści image_url (URLs lub base64). Dla STT, POST audio jako multipart/form-data do /v1/stt /. Dla PDF, użyj /v1/pdf/extract/ do OCR i czatuj o wynikach.
Miesięczny kapslarz połączenia z planem (1 000 bezpłatny, 10 000 Basic, 100.000 Pro, 1M Business) plus zakupiony token bilans. Nie ma na sekundę gazu. Codzienny bezpłatny basen dotyczy tylko zapytań o stronę internetową, a nie 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.
Podpisujemy każdą koszulkę internetową HMAC-SHA256 nad surowym ciałem. Podpis znajduje się w nagłówku X-Free-Signature (zakodowane hex). Odrzucić wszelkie ładunek, którego podpis nie pasuje do HMAC(your_webhook_ secret, surow_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/ punkt końcowy akceptuje schemat wypełniania zapytania OpenAI Chat i zwraca ten sam kształt odpowiedzi. Większość istniejącego kodu klienta OpenAI działa poprzez zmianę dwóch linii — base_url + api_ key.
Tak — każdy model samorządzony jest otwartym źródłem (Apache 2.0 / MIT). Nasz repo gpu_api jest publiczny, klonuje go, dostarcza GPU i uruchamia ten sam stos wyników. Dla zarządzanej prywatnej instalacji chmury skontaktuj się z nami.
Samodomowców modeli biegną bezpłatnie na basenie 30 000 tokenów dziennych, następnie rachunek surowego tokena. Modele premii są pay-as-you-go: 1,5× detaliczny marking, zmniejszy się do 1,30× $500/30d i $1,15× przy $2 000/30d. Koszt życia jest na każdej stronie modelu i na każdej odpowiedzi API; token top-ups zaczyna się od $1.