Lewati ke konten
apicat

Chat completion (OpenAI-compatible)

Membuat chat completion dengan model Gemini via notegpt. Sepenuhnya kompatibel dengan OpenAI SDK: atur `base_url` ke `https://api.apicat.me/api/v1/ai/notegpt-gemini` lalu panggil `client.chat.completions.create(...)`. Mendukung streaming SSE (`"stream": true`), riwayat percakapan, dan pencarian web. Endpoint ini terbuka: API key tidak diperlukan.

POST/api/v1/ai/notegpt-gemini/chat/completions
openaichatgeminissestreaming

Parameter

Authorizationopsional
header

Bearer token API. Tidak wajib: endpoint ini terbuka. Isi hanya bila instance Anda mengaktifkan API key.

string

Body

model

ID model yang dipakai. Daftar model tersedia di endpoint /models.

string
messageswajib

Daftar pesan percakapan. Setiap item punya role (`system`, `user`, `assistant`) dan content (string).

array
stream

Jika true, respons dikembalikan sebagai Server-Sent Events dengan chunk `data: {...}` dan penanda `data: [DONE]`.

boolean
temperature

Kreativitas jawaban (0.0 - 1.0).

number
max_tokens

Batas panjang jawaban. Diabaikan oleh upstream bila tidak diisi.

integer
web_search

Aktifkan pencarian web realtime untuk pertanyaan faktual terkini.

boolean
conversation_id

ID percakapan. Kirim ulang nilai yang sama untuk melanjutkan konteks.

string
language

Bahasa jawaban: `auto`, `id`, `en`, dan lainnya.

string
tone

Nada jawaban, misalnya `default`, `friendly`, `formal`.

string
length

Panjang jawaban: `short`, `moderate`, `long`.

string

Contoh respons

HTTP 200
{
  "id": "chatcmpl-7BbYbOszxpEQ9PVXopRuqAzm",
  "object": "chat.completion",
  "created": 1792472262,
  "model": "gemini-3.1-flash-lite",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Laut adalah hamparan air asin yang luas dan dalam."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 5,
    "completion_tokens": 12,
    "total_tokens": 17
  }
}

Error

400invalid_request_errorField `messages` wajib diisi minimal satu pesan. 'messages' must contain at least one message.
404model_not_foundID model tidak dikenal. Ambil daftar model yang valid dari `/models`. The model 'xyz' does not exist.
429rate_limit_exceededTerlalu banyak request dari alamat IP yang sama. Tunggu sebentar lalu coba lagi. Rate limit exceeded. Slow down and retry shortly.
502upstream_errorLayanan di belakang apicat gagal atau sedang dibatasi. Coba lagi sebentar. Upstream request failed: ...

Playground

Coba langsung

POST Siap

Request

Ctrl atau Cmd + Enter untuk menjalankan.

API ini terbuka. Isi hanya bila instance Anda memakai API key.

Response

streamed

Catatan

Endpoint ini meneruskan permintaan ke https://notegpt.io/api/v2/chat/stream di latar belakang. Batas waktu satu permintaan streaming adalah 120 detik. Rate limit berlaku per alamat IP.

Endpoint lain