Dokumentasi

Cara kerja FreeAll AI

FreeAll AI berdiri di antara aplikasi Anda dan puluhan penyedia AI. Aplikasi memanggil satu endpoint; gateway yang mengurus kunci mana yang dipakai, model mana yang masih punya kuota, dan apa yang dilakukan saat sebuah kunci kehabisan jatah.

Langkah 1

Alur satu request

Setiap panggilan melewati empat tahap sebelum menyentuh penyedia AI. Kalau salah satu tahap menolak, request berhenti di situ dan aplikasi Anda menerima alasannya.

1
Autentikasi
Header Authorization dicocokkan dengan API key Anda. Yang disimpan di database hanya hash-nya, jadi kunci asli tidak bisa dibaca ulang siapa pun.
2
Rate limit
Kuota harian per API key dan batas lonjakan per menit diperiksa. Kalau habis, balasannya 429 beserta perkiraan waktu pulih.
3
AiManager
Inti sistem. Menyusun daftar kunci yang boleh dipakai, lalu mencobanya satu per satu bersama model cadangannya.
4
Pencatatan
Hasilnya — berhasil atau gagal, berapa percobaan, berapa milidetik — ditulis ke RequestLog untuk riwayat dan perhitungan kuota.

Langkah 2

Fallback berlapis

Ini bagian yang membedakan FreeAll AI dari sekadar coba-ulang. Penyedia gratis menghitung kuota per model, bukan per akun — jadi model yang kehabisan jatah belum tentu berarti kuncinya habis.

Apa yang terjadi pada tiap jenis kegagalan

Balasan penyedia	Artinya	Tindakan gateway
429	Kuota model habis	Coba model berikutnya pada kunci yang sama
404	Model sudah dipensiunkan	Coba model berikutnya pada kunci yang sama
401 / 403	Kunci ditolak permanen	Kunci dinonaktifkan otomatis, lanjut ke kunci berikutnya
5xx	Gangguan sementara	Dicatat, lanjut ke percobaan berikutnya

Menyembuhkan diri

Kalau model cadangan yang akhirnya berhasil, model itu dinaikkan menjadi model utama. Request berikutnya langsung memakai yang terbukti jalan, tidak lagi membuang satu percobaan ke model yang sedang habis.

Langkah 3

Kunci siapa dipakai siapa

Kunci yang Anda daftarkan bersifat pribadi. Pengguna lain dan pengunjung demo tidak pernah menyentuhnya — kuota yang Anda bayar atau Anda kumpulkan tetap milik Anda.

Kunci pribadi

Bawaan setiap kunci yang Anda tambahkan. Hanya dipakai akun Anda, dan selalu dicoba lebih dulu sebelum yang lain.

Provider Publik

Kunci yang sengaja dibagikan admin. Menjadi cadangan bagi semua pengguna sekaligus tenaga untuk demo di halaman depan yang bisa dicoba tanpa mendaftar.

Kuota dan batas

Ada tiga lapis pembatas dengan tujuan berbeda. Semuanya berjalan sebelum request menyentuh penyedia AI.

Batas	Siapa yang mengatur	Berlaku untuk
Kuota harian API key	Anda sendiri	Tiap API key, agar satu aplikasi tidak menghabiskan semuanya
Kuota Provider Publik	Admin	Pengguna yang belum membawa kunci sendiri. Lepas begitu Anda menambahkan kunci pribadi
Batas lonjakan	Sistem	Mengikuti paket langganan, per API key

Referensi API

Satu endpoint untuk semua penyedia. Uji langsung tanpa menulis kode lewat Playground.

Request

curl -X POST https://api.freeall.ai/v1/chat \
  -H "Authorization: Bearer sk-freeall-xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Halo!"}'

Response

{
  "success": true,
  "response": "Halo juga!",
  "provider": "groq",
  "model": "llama-3.1-8b-instant",
  "attempts": 3,
  "latencyMs": 812,
  "fallbacks": [
    { "provider": "gemini", "status": 429,
      "error": "Quota exceeded" }
  ]
}

Bentuk body lain

Selain prompt, endpoint menerima percakapan multi-giliran lewat messages, serta opsi temperature, max_tokens, provider untuk memaksa satu penyedia.

Kode status

Kode	Arti
200	Berhasil. Cek `attempts` untuk tahu berapa percobaan yang dilalui.
400	Body tidak valid — `prompt` atau `messages` tidak ada, atau formatnya salah.
401	API key hilang, salah, atau sudah dinonaktifkan.
429	Kuota harian atau batas lonjakan terlampaui. Lihat header `Retry-After`.
503	Tidak ada kunci provider yang bisa dipakai, atau semuanya gagal.

13 penyedia dikenali otomatis

Tempel API key apa adanya — penyedianya dikenali dari bentuk kunci, dan model yang masih aktif ditanyakan langsung ke sumbernya.

GroqgratisGoogle GeminigratisAnthropic (Claude)OpenRoutergratisCerebrasgratisNVIDIA NIMgratisxAI (Grok)Fireworks AIOpenAIDeepSeekMistral AIgratisTogether AIgratisSambaNovagratis

Siap mencoba?

Daftar, tempel satu API key gratisan, lalu panggil endpoint yang sama dari aplikasi Anda.

Mulai gratis