Özel uç noktalar ve Base URL

Özel API uç noktası: OpenAI uyumlu API nasıl bağlanır?

Özel API uç noktası ve Base URL nedir; OpenAI uyumlu bir API’yi, relay, proxy ya da gateway hizmetini yalnızca bir adres ve anahtarla nasıl bağlarsınız?

Güncelleme
  • Özel API uç noktası (custom API endpoint), uygulamanızda yerleşik olmayan bir yapay zekâ hizmetinin web adresidir, yani Base URL’idir: OpenAI uyumlu bir API, bir relay (aktarma hizmeti), proxy ya da gateway (ağ geçidi) gibi. Oriveo’da birini bağlamak için genellikle iki şey yeterlidir: bu adres ve bir API anahtarı (API key).
  • Oriveo protokolü sizin yerinize belirler (OpenAI Chat Completions, OpenAI Responses, Anthropic Messages ya da Gemini) ve yalnızca kök adresi girdiğinizde /v1 gibi sürüm yolunu kendisi ekler.
  • Herkese açık adresler HTTPS kullanmalıdır. Üçüncü taraf bir hizmet, içinden geçen her şeyi görebilir; bu yüzden ona harcama limiti olan ayrı bir anahtar verin ve resmi sağlayıcı anahtarınızı asla teslim etmeyin.
iPhone’da Oriveo: bağladığınız sağlayıcıları ve bu ayki harcamayı gösteren sağlayıcı ekranı.

Base URL ya da API uç noktası nedir?

Her yapay zekâ hizmetinin, uygulamaların istek gönderdiği bir web adresi vardır. Geliştiriciler buna Base URL, API endpoint (API uç noktası) ya da istek URL’si der; burada hepsi aynı anlama gelir. Sıradan bir web adresine benzer. Örneğin OpenAI’ınki https://api.openai.com/v1 adresidir.

Oriveo’da 15 yerleşik sağlayıcının adresleri zaten doldurulmuştur; yalnızca anahtar yapıştırırsınız. Özel uç nokta geri kalan her şey içindir: OpenAI uyumlu API sunan bir hizmet, bir şirketin işlettiği bir relay ya da gateway veya kendi sunucunuzda çalıştırdığınız bir gateway.

"OpenAI uyumlu", hizmetin istekleri OpenAI API’siyle aynı biçimde kabul ettiği anlamına gelir; böylece OpenAI için yapılmış uygulamalar onunla konuşabilir. Birçok sağlayıcı ve gateway bu biçimi sunar.

Relay, proxy, gateway: farkı ne?

Bu kelimeler pek kesin kullanılmaz ve bir uygulamayı bağlarken hepsi aynı şekilde çalışır: bir hizmet uygulamanızla model sağlayıcıları arasında durur, isteğinizi alır ve iletir. Bazıları birkaç sağlayıcıyı tek anahtar ve tek fatura arkasında toplar; bazıları ekipler için kullanım denetimi ekler; bazıları da kendi sunucunuzda çalıştırdığınız yazılımlardır.

Oriveo bunların hiçbirini önermez ya da sıralamaz. Hangisini kullanırsanız kullanın, aşağıdaki adımlar aynıdır.

Özel uç nokta bağlamak için ne gerekir?

Genellikle iki şey; ikisi de hizmetin kendi panelinde ya da belgelerinde bulunur:

  • İstek URL’si (Base URL), örneğin https://api.example.com/v1. Hizmet herkese açık internetteyse https:// ile başlamalıdır.
  • Hizmetin size verdiği bir API anahtarı. "Başka anahtar ekle" ile daha fazla anahtar ekleyebilirsiniz.
  • İsteğe bağlı: bağlantıyı diğerlerinden ayırt etmek için bir ad.

Oriveo’da özel uç nokta nasıl eklenir?

Adımlar iPhone, Android ve web’de aynıdır.

  • Sağlayıcılar’ı açın ve + düğmesine (Sağlayıcı Ekle) dokunun.
  • Özel filtresini, ardından Özel aktarma girişini ("Kendi model hizmetinize bağlanın") seçin.
  • "Özel aktarmaya bağlanın" ekranında istek URL’sini ve API anahtarını yapıştırın. "İstek adresi: …" satırı, Oriveo’nun kullanacağı tam adresi gösterir. İleri’ye dokunun.
  • Oriveo bağlantıyı kontrol eder, model listesini okur ve her modelin protokolünü belirler. Bu adım listeyi okur, sohbet mesajı göndermez.
  • İstediğiniz modelleri işaretleyip "Kaydet (N seçili)" düğmesine dokunun. Hizmet modellerini listelemiyorsa "Model kimliğini elle ekle" seçeneğini kullanın.
  • Kaydetmeden önce Oriveo, seçilen ilk modele çok küçük bir istek gönderir. Bu test geçerse bağlantı kaydedilir; başarısız olursa aynı adımda kalırsınız ve sorunu düzeltebilirsiniz.
iPhone’da Oriveo Sağlayıcılar ekranı: sağ üstte + düğmesi ve bağlı sağlayıcıların listesi
Yerleşik sağlayıcılarınızın yanına bir uç nokta eklemek için Sağlayıcılar ekranında + düğmesine dokunup Özel’i seçin.

Her şeyi kendiniz mi ayarlamak istiyorsunuz? Manuel kurulumu kullanın

Manuel kurulum her şeyi tek sayfada toplar: adres, anahtar, bir model kimliği, isteğe bağlı bir bağlantı adı ve otomatik olarak başlayan varsayılan protokol. "Doğrula ve kaydet" düğmesine dokunun. Kontrol başarısız olursa henüz hiçbir şey kaydedilmez; bağlantıyı tutup sonra test etmek isterseniz hata kartı "Yine de kaydet (doğrulanmadı)" seçeneğini sunar.

Oriveo protokolü otomatik algılar mı?

Çoğunlukla evet. Yapay zekâ hizmetleri birkaç istek biçiminden birini kullanır; bunlara protokol denir. Oriveo dördünü destekler: OpenAI Chat Completions, OpenAI Responses, Anthropic Messages ve Gemini generateContent.

Kararı model model verir. Hizmetin bir model hakkında verdiği bilgi varsa onu kullanır; yoksa modelin ailesine bakarak olası adayları seçer. Kaydettiğinizde seçilen ilk model gerçek bir istekle test edilir; diğerleri daha sonra, onları kullanmaya başladığınızda kontrol edilir.

Bu yüzden çoğu durumda adres ve anahtar yeterlidir. Hizmetin belgeleri belirli bir protokolü adıyla veriyorsa ya da bir model kontrolden geçemezse protokolü Manuel kurulumda kendiniz seçin.

Adrese /v1 eklemem gerekir mi?

Genellikle hayır. Yalnızca kök adresi, örneğin https://api.example.com girerseniz Oriveo protokolün standart sürüm yolunu ekler: OpenAI ve Anthropic biçimleri için /v1, Gemini için /v1beta.

Adreste zaten bir sürüm varsa, örneğin /api/paas/v4, Oriveo onu korur. /chat/completions, /responses, /messages ya da :generateContent ile biten tam bir uç nokta yapıştırırsanız Oriveo bu sonu kaldırır ve hizmetin hangi protokolü kullandığını anlamak için ondan yararlanır.

İleri’ye dokunmadan önce "İstek adresi: …" satırını kontrol edin. Kontrol "Adres bir web sayfasını gösteriyor olabilir. /v1 eksik mi, kontrol edin." derse adresinizi hizmetin belgeleriyle karşılaştırın.

Adrese /v1 eklemem gerekir mi?
Girdiğiniz adresOriveo’nun istek gönderdiği adres (OpenAI biçimi)
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, Chat Completions ile
https://api.example.com/api/paas/v4https://api.example.com/api/paas/v4

Hangi adreslere izin veriliyor?

Oriveo anahtarınızı korumak için birkaç kurala uyar:

  • Herkese açık adresler https:// ile başlamalıdır. Herkese açık internetteki bir http:// adresi test edilemez ve kaydedilemez.
  • İçinde kullanıcı adı ve parola olan ya da sorgu parametresi ("?" işaretinden sonraki her şey) içeren adresler kabul edilmez. Oriveo hiçbir zaman sorgu parametrelerindeki API anahtarlarını denemez.
  • Ev ağınızdaki ya da özel bir VPN’deki düz http:// adresleri, örneğin kendi bilgisayarınızdaki bir model sunucusu, Özel aktarma yerine ayrı yerel işlem girişinden eklenir (iPhone’da "Yerel ve LAN işlem gücü", Android’de "Yerel işlem").
  • iPhone ve Android’de uygulama adrese doğrudan bağlanır.
  • Web uygulamasında herkese açık istek URL’leri, tarayıcının CORS kısıtlamalarını aşmak için Oriveo sunucusu üzerinden iletilir (CORS, birçok doğrudan isteği engelleyen bir tarayıcı güvenlik kuralıdır). API anahtarınız yalnızca o istek boyunca bellekte tutulur, asla saklanmaz veya günlüğe yazılmaz. Yerel ağ adresleri cihazınızdan doğrudan bağlanır ve her iki durumda da HTTPS gereklidir; ev ağınızdaki düz bir http:// adresi için iPhone ya da Android uygulaması ve onun yerel işlem girişi gerekir.
  • Anahtarlar yalnızca bu cihazda kalır, bulut senkronizasyonuyla yüklenmez.

Yerleşik sağlayıcıların Base URL’leri

Oriveo’da bunlara ihtiyacınız yok: sağlayıcıyı adıyla seçersiniz. Başka araçlar için sık arandıkları için listeliyoruz. Her biri, 18 Kasım 2026 itibarıyla sağlayıcının belgelerinde verilen resmi OpenAI uyumlu adrestir.

  • Anthropic, OpenAI uyumlu katmanını test ve karşılaştırma amaçlı olarak tanımlıyor; Mistral’ın hızlı başlangıç rehberi ise API’sini OpenAI uyumlu olarak tanımlamıyor. İkisini de yerleşik sağlayıcı olarak ekleyin.
Yerleşik sağlayıcıların Base URL’leri
SağlayıcıOpenAI uyumlu Base URL
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 (uluslararası)https://api.minimax.io/v1
Z.ai (uluslararası)https://api.z.ai/api/paas/v4/
Qwen (Singapur bölgesi)https://dashscope-intl.aliyuncs.com/compatible-mode/v1
Kimi (uluslararası)https://api.moonshot.ai/v1
SiliconFlow (uluslararası)https://api.siliconflow.com/v1

Relay ya da üçüncü taraf API kullanmak güvenli mi?

Dikkatli olun. Sizinle model arasındaki her hizmet, istemlerinizi (prompt), eklediğiniz dosyaları ve yanıtları okuyabilir ve kendi fiyatlarını belirler. Oriveo onun içini göremez ve ona kefil olamaz.

  • Resmi sağlayıcı hesabınızın API anahtarını üçüncü taraf bir hizmete asla vermeyin. Hizmetin size verdiği anahtarı kullanın.
  • Oriveo için ayrı bir anahtar oluşturun; hizmet izin veriyorsa bir harcama limiti koyun ya da üzerinde küçük bir bakiye tutun.
  • Güvenmediğiniz bir hizmet üzerinden parola, kimlik numarası ya da gizli iş bilgisi göndermeyin.
  • Kullanımınızı hizmetin kendi panelinden kontrol edin. Oriveo’nun maliyet rakamları tahminidir; kesin olan hizmetin kayıtlarıdır.
  • Bir anahtar sızarsa onu hizmetin panelinden silip yenisini oluşturun.

Özel uç noktam neden bağlanmıyor?

Oriveo neyin ters gittiğini tek satırda söyler. Türkçe arayüzdeki mesajlar:

  • 401, 402 ve 429 gibi kodların her birinin ne anlama geldiğini API key hataları rehberimiz açıklıyor.
Özel uç noktam neden bağlanmıyor?
Oriveo’daki mesajNeye bakmalı
Adres bir web sayfasını gösteriyor olabilir. /v1 eksik mi, kontrol edin.Adresi hizmetin belgeleriyle karşılaştırın; sürüm yolunu ekleyin ya da kaldırın
Anahtar geçersiz.Anahtarı hizmetin panelinden yeniden kopyalayın
Bu anahtarın model listesine erişim izni yok. Modelleri elle ekleyebilirsiniz.Model kimliğini sonraki adımda kendiniz ekleyin
Bağlanılamıyor. Ağınızı veya proxy ayarınızı kontrol edin.İnternet bağlantınızı ve adrese erişilebildiğini kontrol edin
Bu adresteki hizmet istekleri sınırlıyor.Biraz bekleyip yeniden deneyin
Bu bağlantı üst sağlayıcısına ulaşamadı.Arkadaki hizmetin kendi hesabı geçersiz, kredisi bitmiş ya da hız sınırına takılmış olabilir; hizmeti işleten kişiyle iletişime geçin

Uygulamayla ilgili sık sorulan sorular

Özel API uç noktası nedir?
Uygulamanızda yerleşik olmayan bir yapay zekâ hizmetinin web adresidir: OpenAI uyumlu bir API, bir relay ya da gateway gibi. Onu bu adresi (Base URL) ve hizmetten aldığınız bir API anahtarını girerek bağlarsınız.
OpenAI uyumlu API nedir?
İstekleri OpenAI’ınkiyle aynı biçimde kabul eden bir API’dir; böylece OpenAI için yapılmış uygulamalar onu kullanabilir. Birçok sağlayıcı ve gateway böyle bir API sunar; adresi genellikle /v1 ile biter.
Base URL olarak ne girmeliyim?
Hizmetin belgelerinde yazanı. Belgeler yalnızca bir alan adı veriyorsa onu girin; Oriveo /v1’i (Gemini biçimi için /v1beta’yı) ekler. Devam etmeden önce "İstek adresi: …" satırını kontrol edin.
Özel uç noktayı iPhone ve Android’de kullanabilir miyim?
Evet. Özel aktarma, iPhone ve Android için Oriveo uygulamalarında ve web uygulamasında var. iPhone ve Android’de uygulama adrese doğrudan bağlanır.
Oriveo neden HTTPS istiyor?
HTTPS bağlantıyı şifreler; böylece anahtarınız ve mesajlarınız internette düz metin olarak dolaşmaz. Ev ağınızdaki bir model sunucusu için yerel işlem girişini kullanın.
API relay ya da proxy kullanmak güvenli mi?
İçinden geçen her şeyi okuyabilir, bu yüzden güven önemlidir. Hizmetin size verdiği anahtarı kullanın, resmi sağlayıcı anahtarınızı asla vermeyin, bir harcama limiti koyun ve hassas bilgileri ondan uzak tutun.

İlgili yazılar

Blogdan

Kendi model hizmetinize bağlanın

Web uygulamasını açın ya da Oriveo’yu iPhone veya Android için indirin, Özel aktarma girişini seçin ve hizmetinizden aldığınız adresi ve anahtarı yapıştırın.

Henüz API anahtarınız yok mu? Oriveo Free ile başlayın.