Entegrasyon rehberleri · 2026-10-06

Veri paylaşmadan güvenli LLM API entegrasyonu

LLMTR'de veri saklamama, anahtar kısıtları, model işleme konumu ve 402/403 hata yönetimiyle güvenli LLM API entegrasyonu adımları.

Basit şema: uygulamadan LLMTR'ye gelen istek, ortam değişkenindeki API anahtarı ve seçilen dil modeli; anahtarın üzerinde harcama limiti, son kullanma, model kapsamı ve IP kısıtı kutuları.

Kısa yanıt: Veri paylaşımı ve anahtar kısıtları

LLMTR (llmtr.com), Türkiye'de ve global sağlayıcılarda barındırılan dil modellerine tek, OpenAI uyumlu API'den erişim veren bir gateway'dir. https://llmtr.com/v1 üzerinden veri paylaşımı açısından doğru sağlayıcıyı model kimliğiyle seçin; LLMTR istem ve yanıt gövdelerini saklamaz. Anahtar kısıtları ise spending_limit_exceeded ve model_not_allowed hata türlerini doğrudan belirler.

Güvenli entegrasyon için üç konu birlikte yönetilir: hizmetin sakladığı veriler, API anahtarının korunması ve hangi sağlayıcının her isteği işlediği. Anahtarı ortam değişkeninde tutun, her uygulama ve ortam için ayrı anahtar kullanın, bütçe sınırı koyun ve yalnızca görev için gereken alanları gönderin. Model kapsamı ve IP kısıtı anahtarı yalnızca gereken işlere sınırlar. Bir uygulamaya özel anahtar, iptal işlemini diğer uygulamalardan bağımsız tutar.

Veri paylaşmadan güvenli entegrasyon için LLM API nasıl seçilir?

Bir LLM API'sini veri paylaşımı olmadan kullanmak için saklama, anahtar koruması ve işleme konumunu birlikte değerlendirin. LLMTR istem ve yanıt gövdelerini saklamaz; yalnızca model kimliği, token sayıları, gecikme, durum kodu, USD maliyeti ve anahtarın ilk 12 karakteri gibi istek metadatasını tutar. Bu metadatalar istem veya yanıt içeriğinin yerini almaz.

API anahtarının ham değeri yalnızca bir kez gösterilir; LLMTR, anahtarın kendisi yerine özetini saklar. Anahtarı LLMTR_API_KEY gibi bir ortam değişkenine yazın, tarayıcı koduna veya kaynak koda koymayın. Oluşturma sırasında ya da Edit ekranında harcama limiti, son kullanma, model kapsamı ve IP kısıtı tanımlayabilirsiniz. Bu değişiklikler bir sonraki istekten itibaren uygulanır.

Anahtar üzerindeki kontroller

Bir uygulamanın üretim, geliştirme ve test ortamları için ayrı anahtar kullanın; bu yaklaşım anahtarları bağımsız olarak iptal etmeyi kolaylaştırır. Sabit bir etkin anahtar sayısı sınırı yoktur, ancak her anahtarın amacı ve sahibi açıkça ayrılmalıdır. Bu ayrım test ve dağıtım erişimlerini ayırır.

Anahtarı otomatik çalışan her uygulamada mutlaka harcama limitiyle sınırlandırın. IP kısıtı, isteğin LLMTR'ye ulaştığı genel adresi denetler; NAT veya proxy arkasındaysanız çıkış adresini listeleyin. Model kapsamı en fazla 50 model, IP kısıtı ise en fazla 20 IPv4/IPv6 adresi veya CIDR aralığı kabul eder.

LLMTR'deki API anahtarı kısıtları (tümü isteğe bağlı, 2026-10-06 kontrol edildi)
KısıtlamaNe yaparAşıldığında
Harcama limiti (USD)Anahtarın harcayabileceği toplam tutarı sınırlar402 spending_limit_exceeded
Son kullanmaAnahtarı 7, 30 veya 90 gün sonra veya seçilen tarihte kapatır401 auth_error
Model kapsamıAnahtarı seçilen modellerle sınırlar; en fazla 50 model403 model_not_allowed
IP kısıtıAnahtarı listelenen IPv4/IPv6 adresleri ve CIDR aralıklarıyla sınırlar; en fazla 20403 permission_error

Kısıt hatalarının kodda işlenmesi

Aşağıdaki Python örneği, LLMTR_API_KEY değerini ortamdan okur ve APIStatusError yakalayarak HTTP durum kodu ile hata türünü gösterir. Bu desen, spending_limit_exceeded, model_not_allowed ve permission_error yanıtlarını ayırt eder; ilgili anahtar kısıtının hangisinin aşıldığını gösterir. Durum kodu ile hata türünü birlikte değerlendirebilirsiniz burada. Kısıt değişiklikleri bir sonraki istekten itibaren geçerlidir.

402 ve 403 yanıtları geçici hatalar değil, yapılandırma sinyalleridir; aynı isteği döngüde yeniden denemeyin. 402 spending_limit_exceeded için harcama limitini, 403 model_not_allowed için model kapsamını, 403 permission_error için IP kısıtını gözden geçirin. 401 auth_error ise son kullanma durumunda anahtarın kapalı olduğunu gösterir; bu da yeniden deneme döngüsüne değil, anahtarın Edit üzerinden yeniden yapılandırılmasına yol açar.

Anahtarı ortam değişkeninden okuyan ve 402 ile 403 kısıt yanıtlarını yakalayan Python örneği.

import os
from openai import OpenAI, APIStatusError

# The key lives in an environment variable, never in source code or the browser.
client = OpenAI(base_url="https://llmtr.com/v1", api_key=os.environ["LLMTR_API_KEY"])

try:
    reply = client.chat.completions.create(
        model="llmtr/qwen3-8-27b",
        messages=[{"role": "user", "content": "Draft a reply to this support ticket: ..."}],
    )
    print(reply.choices[0].message.content)
except APIStatusError as error:
    # 402 spending_limit_exceeded, 403 model_not_allowed and 403 permission_error
    # come from the restrictions set on the key.
    print(error.status_code, error.response.json()["error"]["type"])

Veriyi uygun işleme konumunda tutma

Dokümantasyona göre llmtr/qwen3-8-27b ve llmtr/ornith-1-35b, LLMTR tarafından Türkiye'de barındırılır. llmtr/ornith-1-35b için istekler LLMTR'nin Türkiye'deki sunucularında işlenir ve üçüncü taraf sağlayıcıya iletilmez. TR rozeti yalnızca Türkiye'de barındırma bölgesini belirtir; satırı LLMTR'nin işlettiğini söylemez. İşleme ve aktarım ayrıntıları model sayfasındaki veri politikasında kontrol edilmelidir.

EU rozeti taşıyan GreenPT satırları ise sağlayıcıya göre Avrupa Birliği içinde işlenir. Settings altında kendi sağlayıcı anahtarınızı kaydederseniz anahtar veritabanında şifrelenmiş olarak saklanır ve sonrasında yalnızca maskeli biçimde gösterilir. Veri minimizasyonu için görevin gerektirdiği alanları gönderin; kişisel tanımlayıcıları istekten önce maskeleyin. Bu ayrım içerik gönderilmeden önce veri minimizasyonuyla birlikte uygulanır.

LLMTR ile başlamak: hesap, kredi, anahtar ve ilk istek

Adım 1: llmtr.com üzerinde hesap oluşturun ve e-posta adresinizi doğrulayın. Adım 2: Dashboard'daki güvenli ödeme ekranından kredi yüklemesi yapın. İstenen yükleme tutarının üzerine yalnızca bir kez %8 platform marjı eklenir: 10,00 $ kredi için 10,80 $ tahsil edilir. Platform marjı model fiyatlarına eklenmez; her API çağrısı, model kataloğundaki fiyat üzerinden krediden düşülür.

Adım 3: Dashboard > API Keys bölümünde bir API anahtarı oluşturun. Ham anahtar yalnızca bir kez gösterilir; LLMTR_API_KEY gibi bir ortam değişkeninde saklayın. Adım 4: OpenAI uyumlu herhangi bir SDK'da yalnızca base_url değerini https://llmtr.com/v1 yapın, api_key için LLMTR_API_KEY ortam değişkenini kullanın ve ilk isteği gönderin. Dashboard kullanım sayfasında anahtar bazında kullanım ve harcama görünür. Aynı anahtar ve kredi bakiyesi katalogdaki her model için çalışır; model değiştirmek yalnızca model dizesini değiştirmek demektir.

LLMTR API entegrasyonu

Hesap ve kredi oluşturma, API anahtarını güvenli saklama ve ilk OpenAI uyumlu isteği gönderme adımları.

  1. Hesap oluşturma. llmtr.com üzerinde hesap oluşturun ve e-posta adresinizi doğrulayın.
  2. Kredi yükleme. Dashboard'daki güvenli ödeme ekranından kredi ekleyin. İstenen tutarın üzerine bir kez %8 platform marjı uygulanır; model fiyatlarına marj eklenmez.
  3. API anahtarı oluşturma. Dashboard > API Keys bölümünde anahtar oluşturun. Ham değeri görüntülediğinizde LLMTR_API_KEY ortam değişkenine kaydedin.
  4. İlk isteği gönderme. OpenAI uyumlu SDK yapılandırmasında base_url değerini https://llmtr.com/v1 yapın, api_key için LLMTR_API_KEY ortam değişkenini kullanın ve isteği gönderin.

Sık sorulan sorular

LLM API istemlerimi saklıyor mu?

LLMTR istem ve yanıt gövdelerini saklamaz. Yalnızca model kimliği, token sayıları, gecikme, durum kodu, USD maliyeti ve anahtarın ilk 12 karakteri gibi istek metadatasını tutar.

Sızan bir API anahtarının neler yapabileceğini nasıl sınırlarım?

Harcama limiti, son kullanma, en fazla 50 model için model kapsamı ve en fazla 20 IPv4/IPv6 adresi ya da CIDR aralığı için IP kısıtı ekleyin. IP kısıtında NAT veya proxy arkasındaysanız çıkış adresini listeleyin.

403 model_not_allowed ne anlama geliyor?

Bu yanıt, API anahtarının model kapsamında kullanılan model kimliğinin yer almadığını gösterir. Kapsam en fazla 50 model belirleyebilir; kullanılacak modeli kapsama ekleyin veya kapsamı oluştururken doğru modeli seçin.

İlgili yazılar