Dokumentasi MeowAPI

MeowAPI adalah gateway API AI multi-provider yang kompatibel penuh dengan format OpenAI. Kalau kode kamu sudah pakai SDK OpenAI, cukup ganti base_url dan api_key — selesai. Bayar sesuai pemakaian pakai kredit.

Autentikasi

Semua request butuh API key kamu di header Authorization sebagai Bearer token. Buat & kelola key di halaman API Keys. Key hanya ditampilkan sekali saat dibuat — simpan baik-baik.

Authorization: Bearer mk-liv...xxxx

Jangan pernah taruh API key di kode frontend/publik. Pakai hanya di server.

Quick start

Kirim request chat pertama kamu. Contoh di bawah pakai model claude-fable-5.

curl https://meowapi.me/v1/chat/completions \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "meow-fast",
    "messages": [
      { "role": "user", "content": "Halo, apa kabar?" }
    ]
  }'

Chat completions

Endpoint POST /chat/completions. Parameter mengikuti spesifikasi OpenAI: model, messages, temperature, top_p, max_tokens, dan stream.

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "meow-fast",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Halo! Baik, ..." },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 24,
    "total_tokens": 36,
    "meowapi": {
      "upstream_prompt_tokens": 6942,
      "prompt_overhead_tokens": 6930,
      "cached_tokens": 0,
      "cache_write_tokens": 0,
      "cost_idr": 1
    }
  }
}

Streaming

Set stream: true untuk menerima token secara bertahap via Server-Sent Events (SSE). Setiap chunk diawali data: dan diakhiri data: [DONE].

stream = client.chat.completions.create(
    model="meow-fast",
    messages=[{"role": "user", "content": "Tulis puisi singkat."}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta.content or ""
    print(delta, end="", flush=True)

Sebagian model mengirim jejak penalaran di delta.reasoning_content sebelum jawaban akhirnya masuk ke delta.content. Field itu opsional — abaikan saja kalau kamu hanya butuh jawaban. Token penalaran dihitung sebagai token output oleh penyedia, jadi ikut tertagih seperti token jawaban.

for chunk in stream:
    d = chunk.choices[0].delta
    think = getattr(d, "reasoning_content", None)
    if think:
        print(think, end="", flush=True)   # proses berpikir
    if d.content:
        print(d.content, end="", flush=True)  # jawaban

Model tersedia

Ambil daftar model lewat GET /models, atau lihat di dashboard. Berikut model aktif saat ini:

Beberapa model bertanda Gratis — model itu tidak memotong kredit sama sekali, dipakai untuk uji coba dan promo. Status gratis bisa dicabut kapan saja tanpa pemberitahuan, jadi periksa tabel ini lagi sebelum menyandarkan pemakaian besar padanya.

Kode error

Error mengikuti format OpenAI: { "error": { "message", "type", "code" } }.

Harga & billing

Kamu ditagih per token sesuai tarif tiap model (input & output dihitung terpisah). Saldo dipotong otomatis tiap request berhasil. Kalau saldo habis, request dibalas 402 insufficient_quota sampai kamu top-up. Cek pemakaian real-time di halaman Usage.

usage.prompt_tokens adalah token yang benar-benar ditagih — jadi prompt_tokens × tarif selalu cocok dengan riwayat transaksimu.

Sebagian provider upstream menyuntikkan prompt tersembunyi milik mereka sendiri (system prompt tooling, direktif) yang muncul di hitungan token mereka padahal bukan kamu yang mengirim. Token itu tidak kami tagih. Blok tambahan usage.meowapi menampilkan angka aslinya secara terbuka: upstream_prompt_tokens (klaim provider), prompt_overhead_tokens (yang dipotong), cached_tokens, cache_write_tokens, dan cost_idr. Blok itu di luar spesifikasi OpenAI, jadi SDK resmi mengabaikannya dengan aman.