Mulai cepat
Tiga langkah dari nol ke request pertama.
Di halaman ini7 bagianTutup
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/completionslewat basehttps://api.menvorainterasia.com/v1, dan bentuk Anthropic diPOST /v1/messageslewat basehttps://api.menvorainterasia.com. Dua base URL itu berbeda, dan tidak ada jalur dari yang satu ke yang lain: klien yang salah base mendapat404. Lihat Format Anthropic. - Rute lain di luar chat. Gambar lewat
POST /v1/images/generationsdanPOST /v1/images/edits; audio lewatPOST /v1/audio/speech(teks ke suara) danPOST /v1/audio/transcriptions(suara ke teks); vektor lewatPOST /v1/embeddings; klasifikasi dari state lewatPOST /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: nilaifalsedijawab422capability_mismatch, sedangkan flag yang tidak dinyatakan sama sekali dijawab422capabilities_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 bagianimage_url; itu input untuk model yang menerimanya, bukan pembuatan gambar, dan rute chat sendiri hanya memeriksachat. 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.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.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.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.
| Kebutuhan | Endpoint | Bentuk | Catatan |
|---|---|---|---|
| Chat atau teks | POST /v1/chat/completions | JSON | Bentuk SDK yang sudah kamu pakai |
| Klien Anthropic | POST /v1/messages | JSON | Base URL root, tanpa /v1 |
| Membuat gambar | POST /v1/images/generations | JSON | n mengalikan tagihan |
| Mengedit gambar | POST /v1/images/edits | JSON | Sumber di image atau image_url |
| Teks ke suara | POST /v1/audio/speech | JSON | Ditagih per 1.000 karakter input |
| Suara ke teks | POST /v1/audio/transcriptions | multipart | Part file wajib; per menit |
| Vektor | POST /v1/embeddings | JSON | Ditagih token input saja |
| Klasifikasi dari state | POST /v1/decisions | JSON | Butuh 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#
| Gejala | Penyebab | Solusi |
|---|---|---|
401 | Key salah, terpotong, atau sudah dicabut. | buat key baru di halaman API key, salin utuh saat ditampilkan |
404 | model_not_found: id model salah ketik, atau path-nya salah. | pakai persis deepseek-flash-v4.1, pastikan base URL berakhir /v1 |
402 | insufficient_balance: saldo tidak cukup. | top up QRIS dari konsol, lalu ulangi request-nya |
429 | Batas per menit atau batas konkurensi terlewati. | tunggu selama header retry-after menyebutkan, lalu ulangi; lihat Batas laju |
422 | capability_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
statedan daftar pertanyaan, dalam bentuk native.