Lewati ke isi dokumentasi
Mulai cepat

Mulai cepat

Tiga langkah dari nol ke request pertama.

Mulai7 bagianAPI v1
Di halaman ini7 bagian

Ringkasan#

MenvoraRouter menjual akses model AI dengan saldo prabayar Rupiah. Kamu membuat API key di konsol, mengisi saldo lewat QRIS, lalu memanggil model lewat salah satu rutenya. Untuk chat, bentuk request-nya sama seperti SDK OpenAI, jadi SDK yang sudah kamu pakai cukup diarahkan ke base URL di sini. Gambar, audio, vektor, dan decisions punya rute sendiri di host yang sama.

Yang perlu kamu tahu sebelum mulai, supaya tidak ada kejutan di tengah jalan:

  • Dua permukaan chat. Bentuk OpenAI di POST /v1/chat/completions lewat base https://api.menvorainterasia.com/v1, dan bentuk Anthropic di POST /v1/messages lewat base https://api.menvorainterasia.com. Dua base URL itu berbeda, dan tidak ada jalur dari yang satu ke yang lain: klien yang salah base mendapat 404. Lihat Format Anthropic.
  • Rute lain di luar chat. Gambar lewat POST /v1/images/generations dan POST /v1/images/edits; audio lewat POST /v1/audio/speech (teks ke suara) dan POST /v1/audio/transcriptions (suara ke teks); vektor lewat POST /v1/embeddings; klasifikasi dari state lewat POST /v1/decisions, yang bentuknya native dan bukan bentuk chat. Semuanya sinkron — tidak ada streaming — dan satuannya dibahas di artikelnya masing-masing. Lihat Gambar dan Audio.
  • Kapabilitas model menentukan rute. Tiap model membawa daftar kemampuannya di katalog: chat, vision, image, audio, embeddings. Rute hanya menerima model yang mendeklarasikan kemampuan yang dipakai rute itu, dan penolakannya terjadi sebelum saldo ditahan: nilai false dijawab 422 capability_mismatch, sedangkan flag yang tidak dinyatakan sama sekali dijawab 422 capabilities_not_declared. Jadi model chat belum tentu bisa dipakai untuk gambar atau vektor, dan sebaliknya. Gambar juga masih bisa kamu kirim di dalam pesan chat sebagai bagian image_url; itu input untuk model yang menerimanya, bukan pembuatan gambar, dan rute chat sendiri hanya memeriksa chat. Rincian gerbangnya di Gambar.
  • Tool calling tersedia. Model bisa meminta menjalankan fungsimu, dan kodemu yang menjalankannya. Lihat Pemanggilan tool.
  • Saldo tidak pernah minus. Estimasi biaya ditahan dulu sebelum request dikirim ke model. Setelah selesai, yang ditagih adalah pemakaian sebenarnya — sampai maksimum 3× estimasi, dan tidak pernah melebihi saldomu.
  • Satu key untuk semuanya. Satu key berlaku untuk semua model yang aktif, dan bisa kamu batasi sendiri nilai belanjanya.

Tiga langkah#

Tidak perlu kartu kredit, tidak perlu menunggu persetujuan.

  1. 1.
    Buat key

    Masuk ke konsol, buka halaman API key, lalu buat satu key. Key diawali sk-menv- dan nilai lengkapnya hanya ditampilkan sekali, saat dibuat. Yang tersimpan di server cuma hash-nya, jadi tidak ada cara menampilkannya lagi. Salin dan simpan saat itu juga.

  2. 2.
    Isi saldo

    Buka halaman Top up dan bayar dengan QRIS. Nominal minimum yang berlaku ditampilkan di halaman itu, dibaca dari server, bukan angka yang ditulis di dokumentasi ini, karena MenvoraRouter bisa mengubahnya.

    Saldo bertambah hanya setelah penyedia pembayaran mengonfirmasi. Kembali dari halaman QRIS tidak mengkreditkan apa pun.

  3. 3.
    Panggil

    Kirim request pertamamu.

    curl
    curl https://api.menvorainterasia.com/v1/chat/completions \
      -H "Authorization: Bearer sk-menv-..." \
      -H "Content-Type: application/json" \
      -d '{
        "model": "deepseek-flash-v4.1",
        "messages": [{"role": "user", "content": "Halo!"}]
      }'

Pakai dari kode#

Bentuk request dan response mengikuti SDK-nya. Permukaan OpenAI lewat POST /v1/chat/completions, permukaan Anthropic lewat POST /v1/messages. Yang berubah hanya base_url dan api_key.

curl https://api.menvorainterasia.com/v1/chat/completions \
  -H "Authorization: Bearer sk-menv-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-flash-v4.1",
    "messages": [{"role": "user", "content": "Halo!"}]
  }'

Permukaan Anthropic, lewat SDK Anthropic atau curl:

curl https://api.menvorainterasia.com/v1/messages \
  -H "x-api-key: sk-menv-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-flash-v4.1",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Halo!"}]
  }'

Memilih rute#

Satu key dan satu saldo, tapi rutenya dipilih dari yang kamu butuhkan. Chat bukan jalan masuk ke semuanya: gambar, suara, dan vektor punya rute sendiri.

Pilih dari kebutuhannya, bukan dari rute yang paling kamu kenal. Semua jalur berikut memakai key dan saldo yang sama.

KebutuhanEndpointBentukCatatan
Chat atau teksPOST /v1/chat/completionsJSONBentuk SDK yang sudah kamu pakai
Klien AnthropicPOST /v1/messagesJSONBase URL root, tanpa /v1
Membuat gambarPOST /v1/images/generationsJSONn mengalikan tagihan
Mengedit gambarPOST /v1/images/editsJSONSumber di image atau image_url
Teks ke suaraPOST /v1/audio/speechJSONDitagih per 1.000 karakter input
Suara ke teksPOST /v1/audio/transcriptionsmultipartPart file wajib; per menit
VektorPOST /v1/embeddingsJSONDitagih token input saja
Klasifikasi dari statePOST /v1/decisionsJSONButuh kapabilitas chat; bentuk native

Semua rute media memakai base https://api.menvorainterasia.com/v1, sama seperti permukaan OpenAI — hanya permukaan Anthropic yang base-nya root. Yang menentukan rute mana yang menerima request-mu bukan cuma path-nya, tapi juga kapabilitas model yang kamu sebut di model. Rute menolak lebih dulu — sebelum saldo ditahan — kalau model tidak mendeklarasikan kemampuan yang dipakai rute itu. Rincian field dan satuan tagih tiap rute ada di Gambar, Audio, Embeddings, dan Decisions.

Cek koneksi#

Kalau ada yang tidak jalan, dua perintah ini memisahkan masalah key dari masalah jaringan. Keduanya publik dan tidak butuh key, jadi hasilnya hanya bergantung pada host-nya.

Troubleshooting#

GejalaPenyebabSolusi
401Key salah, terpotong, atau sudah dicabut.buat key baru di halaman API key, salin utuh saat ditampilkan
404model_not_found: id model salah ketik, atau path-nya salah.pakai persis deepseek-flash-v4.1, pastikan base URL berakhir /v1
402insufficient_balance: saldo tidak cukup.top up QRIS dari konsol, lalu ulangi request-nya
429Batas per menit atau batas konkurensi terlewati.tunggu selama header retry-after menyebutkan, lalu ulangi; lihat Batas laju
422capability_mismatch atau capabilities_not_declared: model yang kamu sebut tidak mendeklarasikan kemampuan yang dipakai rute itu.pilih model yang punya flag itu di katalog; lihat Gambar

Langkah berikutnya#

  • Autentikasi : header, key mana untuk permukaan mana, dan pencabutan key.
  • Chat completions : parameter yang diterima dan bentuk response-nya.
  • Format Anthropic : permukaan kedua untuk SDK Anthropic, [CC], dan klien Messages API.
  • Pemanggilan tool : model meminta menjalankan fungsimu, dan cara membalas hasilnya.
  • Streaming : token datang bertahap, dan penanda akhirnya.
  • Gambar : POST /v1/images/generations, POST /v1/images/edits, dan gerbang kapabilitasnya.
  • Audio : teks ke suara dan transkripsi multipart, beserta satuan tagihnya.
  • Embeddings : vektor dari satu string atau sekumpulan string, ditagih token input.
  • Decisions : klasifikasi dari state dan daftar pertanyaan, dalam bentuk native.