Free.ai Docs
Quickstart dalam 60 detik.
API percakapan yang kompatibel dengan OpenAI. Satu token, 400+ perkakas. Jalankan ikal ini, lalu baca lagi.
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!"}]}'
Apa yang ingin kau bangun?
Quickstarts
Chat
POST /v1/chat/
{
"model": "qwen2.5-7b",
"messages": [
{"role": "user", "content": "Hello!"}
]
}
Generasi gambar
POST /v1/image/generate/
{
"model": "flux",
"prompt": "a quiet cabin at dusk",
"width": 1024,
"height": 1024
}
Sunting gambar
POST /v1/image/edit/
multipart:
image: <file>
prompt: "remove the chair"
operation: "edit"
Teks ke pidato
POST /v1/tts/
{
"model": "kokoro",
"voice": "af_heart",
"text": "Hello there!"
}
Pidato ke teks
POST /v1/stt/
multipart:
audio: <file>
model: "whisper-large-v3"
language: "auto"
Terjemahkan
POST /v1/translate/
{
"text": "Hello",
"target_lang": "es"
}
SDK
Python
pip install freeai-code
Nodenpm i freeai-code
Go (datang)
Ruby (datang)
Atau gunakan SDK OpenAI titik base_url di api.free.ai/v1
Resep
PSD
Mendaftar di /signup/, mengkonfirmasi email anda, dan buka /account/?tab=api. Klik Hasilkan dan kunci Bearer (sk-free-...) muncul. Simpan itu ▪ untuk keamanan kita hanya menampilkan kunci penuh sekali.
JSON. The /v1/chat/ respon cermin bentuk OpenAI: pilihan[].message.content untuk teks, ditambah objek penggunaan yang melaporkan biaya token. Gambar + audio kembali amplop JSON dengan output_url, share_url, dan kredit_usused.
Ya, aliran lewat:true pada permintaan percakapan. Tanggapan tiba sebagai Acara Server dengan data yang sama: {...} amplop sebagai protokol streaming OpenAI. Pesan terakhir adalah data:[DONE].
Ya. Berikan sebuah array alat pada skema OpenAI. Model asli-tool-call kembali struktur tool_call; model non-native jatuh kembali ke prompt JSON-mode yang memancarkan bentuk yang sama.
Ya. Model percakapan yang dapat dilihat menerima bagian isi image_url (URL atau base64). Untuk STT, audio POST sebagai multipart/form-data ke /v1/stt/. Untuk PDF, gunakan /v1/pdf/extract/ ke OCR dan chatting mengenai hasilnya.
Sebuah panggilan bulanan yang terikat pada rencana Anda (1,000 gratis, 10.000, 100.000 Pro, 1M Business) ditambah keseimbangan token yang dibeli Anda.
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.
Kami menandatangani setiap webhook dengan HMAC-SHA256 di atas tubuh mentah. Tanda tangan tersebut ada di header X-Free-Signature (hex-encoded). Tolak semua muatan yang tanda tangannya tidak cocok dengan 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.
/v1/chat/point menerima permintaan skema OpenAI ChatCompletion dan mengembalikan bentuk respon yang sama. Kode klien OpenAI yang sudah ada bekerja dengan mengubah dua baris base_url + api_key.
Ya, setiap model yang disuplai sendiri adalah open-source (Apache 2.0 / MIT). gpu_api repo kami adalah publik; klon itu, memasok GPU Anda, dan menjalankan stack inference yang sama.
Model berhostalgia berjalan bebas pada kolam harian 30.000 token Anda, kemudian tagihan jumlah token mentah. model Premium adalah pay-as-you-go: 1.50× ritel markup, menjatuhkan sampai 1,30× pada $ 500/30d dan 1.15× pada $ 2.000/30d. Biaya hidup adalah pada setiap model dan pada setiap respon API; token top-up mulai dari $ 1.15×.