Endpoint kustom dan Base URL

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.

Diperbarui
  • 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.
Oriveo di iPhone: halaman penyedia, berisi penyedia yang kamu hubungkan dan pengeluaran bulan ini.

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.
Layar Penyedia Oriveo di iPhone dengan tombol + di kanan atas dan daftar penyedia yang terhubung
Ketuk + di layar Penyedia lalu pilih Kustom untuk menambahkan endpoint bersama penyedia bawaanmu.

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.

Perlukah menambahkan /v1 ke alamat?
Yang kamu masukkanYang diminta Oriveo (format OpenAI)
https://api.example.comhttps://api.example.com/v1
https://api.example.com/v1https://api.example.com/v1
https://api.example.com/v1/chat/completionshttps://api.example.com/v1, memakai Chat Completions
https://api.example.com/api/paas/v4https://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.
Base URL penyedia bawaan
PenyediaBase URL kompatibel OpenAI
OpenAIhttps://api.openai.com/v1
Google Geminihttps://generativelanguage.googleapis.com/v1beta/openai/
OpenRouterhttps://openrouter.ai/api/v1
DeepSeekhttps://api.deepseek.com
xAI (Grok)https://api.x.ai/v1
Groqhttps://api.groq.com/openai/v1
Together AIhttps://api.together.ai/v1
Fireworks AIhttps://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.
Kenapa endpoint kustomku tidak bisa terhubung?
Pesan di OriveoYang 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?
Alamat web layanan AI yang bukan bawaan aplikasimu, misalnya API kompatibel OpenAI, relay, atau gateway. Kamu menghubungkannya dengan memasukkan alamat itu (Base URL) dan API key dari layanan tersebut.
Apa itu API kompatibel OpenAI?
API yang menerima permintaan dengan format yang sama seperti API OpenAI, sehingga aplikasi yang dibuat untuk OpenAI bisa memakainya. Banyak penyedia dan gateway menyediakannya, biasanya di alamat yang berakhiran /v1.
Base URL apa yang harus kumasukkan?
Yang tertulis di dokumentasi layanan. Kalau yang diberikan hanya domain, masukkan itu dan Oriveo akan menambahkan /v1 (atau /v1beta untuk format Gemini). Cek baris "Permintaan ke …" sebelum lanjut.
Bisakah endpoint kustom dipakai di iPhone dan Android?
Bisa. Relai khusus ada di aplikasi Oriveo untuk iPhone dan Android serta di aplikasi web. Di iPhone dan Android, aplikasi terhubung langsung ke alamat itu.
Kenapa Oriveo mewajibkan HTTPS?
HTTPS mengenkripsi koneksi, jadi key dan pesanmu tidak dikirim sebagai teks biasa di internet. Untuk server model di jaringan rumah, pakai entri Komputasi lokal.
Amankah memakai relay atau proxy API?
Layanan itu bisa membaca semua yang kamu kirim lewatnya, jadi kepercayaan itu penting. Pakai key yang diberikan layanan itu, jangan pernah key penyedia resmimu, pasang batas belanja, dan jangan kirim informasi sensitif lewat layanan itu.

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.