Endpoint API kustom: cara menghubungkan API kompatibel OpenAI
Apa itu endpoint API kustom dan Base URL, serta cara menghubungkan API kompatibel OpenAI, relay, proxy, atau gateway cukup dengan alamat dan key.
- Endpoint API kustom adalah alamat web, atau Base URL, dari layanan AI yang bukan bawaan aplikasimu, misalnya API yang kompatibel dengan OpenAI, relay, proxy, atau gateway. Di Oriveo, biasanya kamu hanya butuh dua hal untuk menghubungkannya: alamat itu dan sebuah API key.
- Oriveo mengenali protokolnya untukmu (OpenAI Chat Completions, OpenAI Responses, Anthropic Messages, atau Gemini) dan menambahkan path versi, seperti /v1, kalau kamu hanya memasukkan alamat dasarnya.
- Alamat publik wajib memakai HTTPS. Layanan pihak ketiga bisa melihat semua yang kamu kirim lewat layanan itu, jadi beri key terpisah dengan batas belanja, dan jangan pernah menyerahkan key resmi dari penyedia.

Apa itu Base URL atau endpoint API?
Setiap layanan AI punya alamat web tujuan aplikasi mengirim permintaan. Developer menyebutnya Base URL, endpoint API, atau URL permintaan; di sini artinya sama. Bentuknya seperti alamat web biasa. Milik OpenAI, misalnya, adalah https://api.openai.com/v1.
Di Oriveo, alamat 15 penyedia bawaan sudah terisi, jadi kamu cukup menempelkan key. Endpoint kustom dipakai untuk semua layanan lain: layanan yang menawarkan API kompatibel OpenAI, relay atau gateway yang dijalankan sebuah perusahaan, atau gateway yang kamu jalankan di server sendiri.
"Kompatibel OpenAI" (OpenAI-compatible) berarti layanan itu menerima permintaan dengan format yang sama seperti API OpenAI, sehingga aplikasi yang dibuat untuk OpenAI bisa berkomunikasi dengannya. Banyak penyedia dan gateway menawarkan format ini.
Relay, proxy, gateway: apa bedanya?
Istilah-istilah ini sering dipakai bergantian, dan untuk menghubungkan aplikasi cara kerjanya sama: sebuah layanan berada di antara aplikasimu dan penyedia model, menerima permintaanmu, lalu meneruskannya. Ada yang menaruh beberapa penyedia di balik satu key dan satu tagihan; ada yang menambahkan kontrol pemakaian untuk tim; ada juga yang berupa software yang kamu jalankan di server sendiri.
Oriveo tidak merekomendasikan atau memeringkat satu pun. Apa pun yang kamu pakai, langkah di bawah tetap sama.
Apa yang dibutuhkan untuk menghubungkan endpoint kustom?
Biasanya dua hal, keduanya dari dasbor atau dokumentasi layanan itu:
- URL permintaan (Base URL), misalnya https://api.example.com/v1. Alamatnya harus diawali https:// kalau layanan itu ada di internet publik.
- API key yang diterbitkan layanan itu untukmu. Kamu bisa menambah key lain lewat "Tambah kunci lain".
- Opsional: nama koneksi, supaya mudah dibedakan dari koneksi lain.
Cara menambahkan endpoint kustom di Oriveo
Langkahnya sama di iPhone, Android, dan web.
- Buka Penyedia lalu ketuk tombol + (Tambahkan Penyedia).
- Pilih chip Kustom, lalu Relai khusus ("Hubungkan layanan model Anda sendiri").
- Di layar "Hubungkan relai khusus", tempel URL permintaan dan API key. Baris "Permintaan ke …" menampilkan alamat lengkap yang akan dipakai Oriveo. Ketuk Berikutnya.
- Oriveo memeriksa koneksi, membaca daftar model, dan mengenali protokol tiap model. Langkah ini membaca daftar tanpa mengirim pesan chat.
- Centang model yang kamu inginkan lalu ketuk "Simpan (N dipilih)". Kalau layanannya tidak mencantumkan model, pakai "Tambahkan ID model secara manual".
- Sebelum menyimpan, Oriveo mengirim satu permintaan kecil ke model pertama yang dipilih. Koneksi tersimpan kalau tes itu lolos; kalau gagal, kamu tetap di langkah yang sama dan bisa memperbaikinya.

Mau mengatur semuanya sendiri? Pakai Penyiapan manual
Penyiapan manual menaruh semuanya di satu halaman: alamat, key, ID model, nama koneksi (opsional), dan protokol default, yang awalnya diatur otomatis. Ketuk "Verifikasi dan simpan". Kalau pengecekan gagal, belum ada yang tersimpan, dan kartu error yang muncul menyediakan tombol "Tetap simpan (belum diverifikasi)" kalau kamu ingin menyimpan koneksinya dan mengetesnya nanti.
Apakah Oriveo mengenali protokol secara otomatis?
Sebagian besar, ya. Layanan AI memakai salah satu dari beberapa format permintaan, yang disebut protokol. Oriveo mendukung empat: OpenAI Chat Completions, OpenAI Responses, Anthropic Messages, dan Gemini generateContent.
Oriveo memutuskannya per model. Kalau layanan memberi informasi tentang model itu, Oriveo memakainya; kalau tidak, Oriveo memilih kandidat yang paling mungkin berdasarkan keluarga modelnya. Saat kamu menyimpan, model pertama yang dipilih dites dengan permintaan sungguhan; model lainnya dicek belakangan, saat kamu mulai memakainya.
Jadi dalam kebanyakan kasus, alamat dan key sudah cukup. Kalau dokumentasi layanan menyebut protokol tertentu, atau ada model yang gagal dicek, pilih protokolnya sendiri di Penyiapan manual.
Perlukah menambahkan /v1 ke alamat?
Biasanya tidak. Kalau kamu hanya memasukkan alamat dasarnya, seperti https://api.example.com, Oriveo menambahkan path versi standar sesuai protokolnya: /v1 untuk format OpenAI dan Anthropic, /v1beta untuk Gemini.
Kalau alamatnya sudah berisi versi, seperti /api/paas/v4, Oriveo mempertahankannya. Kalau kamu menempelkan endpoint lengkap yang berakhiran /chat/completions, /responses, /messages, atau :generateContent, Oriveo membuang akhiran itu dan memakainya untuk mengetahui protokol yang dipakai layanan.
Cek baris "Permintaan ke …" sebelum mengetuk Berikutnya. Kalau pengecekan menampilkan "Alamat mungkin mengarah ke halaman web. Periksa apakah /v1 terlewat.", bandingkan alamatmu dengan dokumentasi layanan.
| Yang kamu masukkan | Yang diminta Oriveo (format OpenAI) |
|---|---|
| https://api.example.com | https://api.example.com/v1 |
| https://api.example.com/v1 | https://api.example.com/v1 |
| https://api.example.com/v1/chat/completions | https://api.example.com/v1, memakai Chat Completions |
| https://api.example.com/api/paas/v4 | https://api.example.com/api/paas/v4 |
Alamat apa saja yang diizinkan?
Oriveo mengikuti beberapa aturan untuk melindungi key-mu:
- Alamat publik harus diawali https://. Alamat http:// di internet publik tidak bisa dites atau disimpan.
- Alamat yang berisi nama pengguna dan kata sandi, atau parameter query (apa pun setelah tanda "?"), tidak diterima. Oriveo tidak pernah mencoba API key dari parameter query.
- Alamat http:// biasa di jaringan rumah atau VPN pribadi, seperti server model di komputermu sendiri, masuk lewat entri terpisah Komputasi lokal (di iPhone: Komputasi lokal & LAN), bukan Relai khusus.
- Di iPhone dan Android, aplikasi terhubung langsung ke alamat itu.
- Di aplikasi web, URL permintaan publik diteruskan melalui server Oriveo untuk mengatasi batasan CORS browser (aturan keamanan browser yang memblokir banyak permintaan langsung). API key-mu hanya berada di memori selama permintaan itu, tidak pernah disimpan atau dicatat. Alamat jaringan lokal terhubung langsung dari perangkatmu, dan HTTPS tetap wajib di kedua kasus; alamat http:// biasa di jaringan rumah butuh aplikasi iPhone atau Android beserta entri Komputasi lokal-nya.
- Key hanya disimpan di perangkat ini dan tidak diunggah lewat sinkronisasi cloud.
Base URL penyedia bawaan
Di Oriveo kamu tidak membutuhkannya: cukup pilih penyedia berdasarkan namanya. Daftar ini ada karena orang sering mencarinya untuk alat lain. Masing-masing adalah alamat resmi yang kompatibel OpenAI menurut dokumentasi penyedianya, per 18 November 2026.
- Anthropic menyebut lapisan kompatibel OpenAI miliknya ditujukan untuk pengujian dan perbandingan, dan panduan memulai (quickstart) Mistral tidak menyebut API-nya kompatibel OpenAI. Tambahkan keduanya sebagai penyedia bawaan saja.
| Penyedia | Base URL kompatibel OpenAI |
|---|---|
| OpenAI | https://api.openai.com/v1 |
| Google Gemini | https://generativelanguage.googleapis.com/v1beta/openai/ |
| OpenRouter | https://openrouter.ai/api/v1 |
| DeepSeek | https://api.deepseek.com |
| xAI (Grok) | https://api.x.ai/v1 |
| Groq | https://api.groq.com/openai/v1 |
| Together AI | https://api.together.ai/v1 |
| Fireworks AI | https://api.fireworks.ai/inference/v1 |
| MiniMax (internasional) | https://api.minimax.io/v1 |
| Z.ai (internasional) | https://api.z.ai/api/paas/v4/ |
| Qwen (wilayah Singapura) | https://dashscope-intl.aliyuncs.com/compatible-mode/v1 |
| Kimi (internasional) | https://api.moonshot.ai/v1 |
| SiliconFlow (internasional) | https://api.siliconflow.com/v1 |
Amankah memakai relay atau API pihak ketiga?
Hati-hati. Layanan apa pun yang berada di antara kamu dan model bisa membaca prompt, file yang kamu lampirkan, dan jawabannya, serta menetapkan harganya sendiri. Oriveo tidak bisa melihat isi layanan itu atau menjaminnya.
- Jangan pernah memberikan API key dari akun penyedia resmimu ke layanan pihak ketiga. Pakai key yang diterbitkan layanan itu untukmu.
- Buat key terpisah untuk Oriveo, dan pasang batas belanja atau simpan saldo kecil saja di key itu kalau layanannya memungkinkan.
- Jangan kirim kata sandi, nomor identitas, atau pekerjaan rahasia lewat layanan yang tidak kamu percayai.
- Cek pemakaianmu di dasbor layanan itu sendiri. Angka biaya di Oriveo adalah perkiraan; catatan layanan itu yang menjadi acuan akhir.
- Kalau key bocor, hapus di dasbor layanan lalu buat yang baru.
Kenapa endpoint kustomku tidak bisa terhubung?
Oriveo memberi tahu masalahnya dalam satu baris. Pesannya, sesuai tulisan di aplikasi:
- Untuk kode seperti 401, 402, dan 429, panduan error API key kami menjelaskan arti masing-masing.
| Pesan di Oriveo | Yang perlu dicek |
|---|---|
| Alamat mungkin mengarah ke halaman web. Periksa apakah /v1 terlewat. | Bandingkan alamat dengan dokumentasi layanan; tambahkan atau hapus path versinya |
| Kunci tidak valid. | Salin ulang key dari dasbor layanan |
| Kunci ini tidak punya izin melihat daftar model. Anda dapat menambahkan model secara manual. | Tambahkan sendiri ID model di langkah berikutnya |
| Tidak dapat terhubung. Periksa jaringan atau proxy Anda. | Cek koneksi internet dan pastikan alamatnya bisa dijangkau |
| Layanan di alamat ini sedang membatasi laju permintaan. | Tunggu sebentar lalu coba lagi |
| Koneksi ini tidak dapat menghubungi penyedia upstream-nya. | Akun milik layanan itu di baliknya mungkin tidak valid, kehabisan kredit, atau terkena batas laju; hubungi pengelolanya |
Pertanyaan umum seputar aplikasi
Apa itu endpoint API kustom?
Apa itu API kompatibel OpenAI?
Base URL apa yang harus kumasukkan?
Bisakah endpoint kustom dipakai di iPhone dan Android?
Kenapa Oriveo mewajibkan HTTPS?
Amankah memakai relay atau proxy API?
Bacaan terkait
Dari blog
Hubungkan layanan model milikmu sendiri
Buka aplikasi web atau unduh Oriveo untuk iPhone atau Android, pilih Relai khusus, lalu tempel alamat dan key dari layananmu.
Belum punya API key? Mulai dengan Oriveo Free.