Mulai Cepat
Dari akun baru sampai request pertama.
- 1
Buat akun
Daftar di portal member. Credit gratis aktif otomatis untuk akun baru.
- 2
Top-up Credit
Pilih paket dan bayar via QRIS. Saldo bertambah otomatis.
- 3
Generate API key
Buat key dari dashboard, atur batas anggaran bila perlu.
- 4
Arahkan klien Anda
Ubah base URL ke https://gemmapool.web.id/v1 dan gunakan API key tersebut.
Autentikasi
Semua request wajib menyertakan API key.
Kirim API key pada header Authorization dengan format Bearer. Key yang bocor harus segera dicabut dari dashboard.
Authorization: Bearer sk-gmp-xxxxxxxxxxxxxxxxEndpoint
Ringkasan endpoint yang tersedia.
| Method | Path | Keterangan | Tipe |
|---|---|---|---|
| POST | /v1/chat/completions | Chat & generasi kode (format OpenAI) | Chat |
| POST | /v1/messages | Chat (format Anthropic Claude) | Chat |
| POST | /v1/responses | OpenAI Responses API | Chat |
| GET | /v1/models | Daftar model yang tersedia | Model |
| GET | /v1/models/info?id= | Metadata satu model | Model |
| POST | /v1/images/generations | Generasi gambar dari teks | Media |
| POST | /v1/embeddings | Membuat text embedding | Media |
| POST | /v1/audio/speech | Text-to-speech | Media |
| POST | /v1/audio/transcriptions | Speech-to-text | Media |
Chat Completions
Endpoint utama untuk chat dan generasi kode.
curl -X POST https://gemmapool.web.id/v1/chat/completions \
-H "Authorization: Bearer API_KEY_ANDA" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet",
"messages": [
{ "role": "user", "content": "Halo Gemmapool!" }
],
"max_tokens": 1000
}'Streaming
Kirim token secara bertahap untuk respons real-time.
Tambahkan "stream": true untuk menerima Server-Sent Events. Setiap chunk berisi delta token.
curl -N -X POST https://gemmapool.web.id/v1/chat/completions \
-H "Authorization: Bearer API_KEY_ANDA" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet",
"messages": [{ "role": "user", "content": "Tulis puisi singkat" }],
"stream": true
}'Daftar Model
Ambil model yang tersedia untuk akun Anda.
curl https://gemmapool.web.id/v1/models \
-H "Authorization: Bearer API_KEY_ANDA"Gunakan nilai id dari respons sebagai parameter model. Katalog dan tarif per model tersedia di dashboard member.
Media & Embeddings
Gambar, embedding, dan audio.
curl -X POST https://gemmapool.web.id/v1/images/generations \
-H "Authorization: Bearer API_KEY_ANDA" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/dall-e-3",
"prompt": "Kucing astronot di bulan, gaya sinematik",
"size": "1024x1024",
"n": 1
}'curl -X POST https://gemmapool.web.id/v1/embeddings \
-H "Authorization: Bearer API_KEY_ANDA" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/text-embedding-3-small",
"input": "Gemmapool AI Gateway"
}'Kode Error
Respons error mengikuti format OpenAI.
| Kode | Nama | Keterangan |
|---|---|---|
| 400 | Bad Request | Body request tidak valid atau field wajib tidak ada. |
| 401 | Unauthorized | API key tidak ada atau tidak valid. |
| 403 | Forbidden | API key dinonaktifkan atau tidak punya akses ke model. |
| 404 | Not Found | Model atau endpoint tidak ditemukan. |
| 429 | Rate Limited | Melebihi batas request per menit. Cek header Retry-After. |
| 500 | Server Error | Kesalahan internal gateway. Coba lagi beberapa saat. |
| 502 | Upstream Error | Penyedia model sedang bermasalah atau timeout. |
{
"error": {
"message": "Rate limit exceeded",
"type": "rate_limit_error"
},
"retryAfter": 12
}Batas & Biaya
Bagaimana pemakaian dihitung.
- Setiap request dipotong Credit berdasarkan token input, cache, dan output.
- Tarif berbeda per model; tarif tercantum pada katalog model di dashboard.
- Batas request per menit berlaku per API key.
- Gunakan header Retry-After saat menerima respons 429.
- Credit tidak kedaluwarsa dan tidak memiliki biaya langganan bulanan.
Integrasi Klien
Konfigurasi cepat untuk tools populer.
Cursor
Settings → Models → OpenAI API Key & Base URL
Claude Code
Set ANTHROPIC_BASE_URL dan ANTHROPIC_AUTH_TOKEN

OpenCode
Tambahkan sebagai Custom Provider di Settings

Codex CLI
Daftarkan provider pada konfigurasi Codex

Cline
Pilih provider OpenAI Compatible

Continue
Tambahkan model dengan provider openai
Untuk semua klien, gunakan base URL https://gemmapool.web.id/v1 dan API key Anda.