Developer

Dokumentasi API

Referensi integrasi Gemmapool AI Gateway — kompatibel dengan SDK OpenAI dan Anthropic, satu API key untuk berbagai penyedia model.

Base URLhttps://gemmapool.web.id/v1
rocket_launch

Mulai Cepat

Dari akun baru sampai request pertama.

  1. 1

    Buat akun

    Daftar di portal member. Credit gratis aktif otomatis untuk akun baru.

  2. 2

    Top-up Credit

    Pilih paket dan bayar via QRIS. Saldo bertambah otomatis.

  3. 3

    Generate API key

    Buat key dari dashboard, atur batas anggaran bila perlu.

  4. 4

    Arahkan klien Anda

    Ubah base URL ke https://gemmapool.web.id/v1 dan gunakan API key tersebut.

lock

Autentikasi

Semua request wajib menyertakan API key.

Kirim API key pada header Authorization dengan format Bearer. Key yang bocor harus segera dicabut dari dashboard.

bash
Authorization: Bearer sk-gmp-xxxxxxxxxxxxxxxx
api

Endpoint

Ringkasan endpoint yang tersedia.

MethodPathKeteranganTipe
POST/v1/chat/completionsChat & generasi kode (format OpenAI)Chat
POST/v1/messagesChat (format Anthropic Claude)Chat
POST/v1/responsesOpenAI Responses APIChat
GET/v1/modelsDaftar model yang tersediaModel
GET/v1/models/info?id=Metadata satu modelModel
POST/v1/images/generationsGenerasi gambar dari teksMedia
POST/v1/embeddingsMembuat text embeddingMedia
POST/v1/audio/speechText-to-speechMedia
POST/v1/audio/transcriptionsSpeech-to-textMedia
chat

Chat Completions

Endpoint utama untuk chat dan generasi kode.

cURL
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
  }'
stream

Streaming

Kirim token secara bertahap untuk respons real-time.

Tambahkan "stream": true untuk menerima Server-Sent Events. Setiap chunk berisi delta token.

bash
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
  }'
deployed_code

Daftar Model

Ambil model yang tersedia untuk akun Anda.

bash
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.

image

Media & Embeddings

Gambar, embedding, dan audio.

images
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
  }'
embeddings
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"
  }'
error

Kode Error

Respons error mengikuti format OpenAI.

KodeNamaKeterangan
400Bad RequestBody request tidak valid atau field wajib tidak ada.
401UnauthorizedAPI key tidak ada atau tidak valid.
403ForbiddenAPI key dinonaktifkan atau tidak punya akses ke model.
404Not FoundModel atau endpoint tidak ditemukan.
429Rate LimitedMelebihi batas request per menit. Cek header Retry-After.
500Server ErrorKesalahan internal gateway. Coba lagi beberapa saat.
502Upstream ErrorPenyedia model sedang bermasalah atau timeout.
json
{
  "error": {
    "message": "Rate limit exceeded",
    "type": "rate_limit_error"
  },
  "retryAfter": 12
}
speed

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.
terminal

Integrasi Klien

Konfigurasi cepat untuk tools populer.

Cursor logo

Cursor

Settings → Models → OpenAI API Key & Base URL

Claude Code logo

Claude Code

Set ANTHROPIC_BASE_URL dan ANTHROPIC_AUTH_TOKEN

OpenCode logo

OpenCode

Tambahkan sebagai Custom Provider di Settings

Codex CLI logo

Codex CLI

Daftarkan provider pada konfigurasi Codex

Cline logo

Cline

Pilih provider OpenAI Compatible

Continue logo

Continue

Tambahkan model dengan provider openai

Untuk semua klien, gunakan base URL https://gemmapool.web.id/v1 dan API key Anda.