Entegrasyon rehberleri · 2026-09-20
EVREN API'sini LLMTR üzerinden kullanmak: kendi anahtarınızla tek uçtan
EVREN modelleri LLMTR katalogunda beş satır olarak duruyor ve kendi EVREN anahtarınızla çalışıyor. Anahtarı nasıl tanıtırsınız, istekte ne gider, hangi hatayı ne zaman görürsünüz ve bu satırlarda hangi özelliklerin sunulmadığı.
Kısa cevap
EVREN modellerini LLMTR üzerinden çağırabilirsiniz ve anahtar sizin kalır. EVREN konsolundan aldığınız API anahtarını bir kez LLMTR'ye tanıtırsınız, sonra modeli diğer bütün modeller gibi aynı uçtan çağırırsınız.
EVREN'e doğrudan da bağlanabilirsiniz; LLMTR üzerinden bağlanmanın farkı, aynı kodun Türkiye'de barınan başka modellere ve global modellere de ulaşmasıdır. Model kimliğini değiştirmek dışında hiçbir şey değişmez.
Katalogdaki beş EVREN satırı
EVREN on bir model yayımlıyor; bunların sohbet modeli olarak tarif edilen beşi LLMTR katalogunda. Gömme, yeniden sıralama, OCR ve konuşma tanıma satırları henüz burada değil.
Bağlam ve modalite değerleri EVREN'in kendi yayımladığı model tablosundan alınmıştır.
| Model kimliği | Bağlam | Girdi |
|---|---|---|
| evren/deepseek-v4-flash-tr | 1.000.000 | Metin |
| evren/glm-5.3-fp8 | 512.000 | Metin |
| evren/gemma-4-31b | 256.000 | Metin, görsel |
| evren/qwen3.8-flash-next | 256.000 | Metin, görsel, video |
| evren/qwen3-vl-30b | 256.000 | Metin, görsel, video |
Anahtarınızı bir kez tanıtın
Bu satırlar, katalogdaki diğer modellerden farklı olarak, siz bir EVREN anahtarı kaydetmeden çalışmaz. Kaydetme işlemi bir kez yapılır ve isteklerinizde tekrar edilmez.
Anahtar kaydedildikten sonra bir daha gösterilmez; yalnızca son dört karakteri görünür. Kaybederseniz EVREN konsolundan yenisini oluşturup Ayarlar'dan değiştirirsiniz.
- EVREN konsolundan bir API anahtarı oluşturun ve EVREN'in kullanım şartlarını kabul edin.
- LLMTR'de Ayarlar bölümündeki kendi sağlayıcı anahtarlarınız kartına anahtarı yapıştırın.
- Modeli her zamanki gibi çağırın; istekte yalnızca LLMTR anahtarınız gider.
EVREN satırına ilk istek
curl "$LLMTR_BASE_URL/v1/chat/completions" \
-H "Authorization: Bearer llmtr-your_key" \
-H "Content-Type: application/json" \
-d '{
"model": "evren/glm-5.3-fp8",
"messages": [
{ "role": "user", "content": "Bu sozlesmedeki fesih maddelerini ozetle." }
],
"max_tokens": 4096
}'İstekte ne gidiyor, ne gitmiyor
İsteğinizin kimlik doğrulama başlığında yalnızca LLMTR anahtarınız bulunur. EVREN anahtarınızı istek gövdesine veya başlığa koymazsınız; o anahtar kaydettiğiniz yerde durur ve yalnızca sizin isteğinizi göndermek için kullanılır.
Anahtar yüksek şifreleme ile saklanır ve kaldırdığınız anda kullanılamaz hâle gelir. Bir daha size de gösterilmez.
İstek ve yanıt gövdeleri veritabanımıza yazılmaz. Kullanım kaydı modeli, token sayılarını, mesaj adedini, maliyeti, durum kodunu ve süreyi tutar. İsteği işleyen üçüncü taraf model sağlayıcısı kayıt tutabilir ve bunu her model kartı yazar; EVREN satırlarında o sağlayıcı EVREN'in kendisidir ve hesap sizindir.
Hata yanıtları
Bu satırlarda sağlayıcının cevabı size doğrudan iletilir. Anahtar da hesap da sizin olduğu için bir sorunu düzeltebilecek tek kişi sizsiniz.
Yanıttaki details.upstreamStatus alanı her durumda EVREN'in döndürdüğü özgün kodu taşır. İstemcileriniz yeniden deneme kararını HTTP durumuna göre verdiği için bu ayrım önemlidir: 4xx kodları olduğu gibi korunur, 5xx yanıtlar 502'ye toplanır.
| Durum | HTTP | error.type |
|---|---|---|
| Kayıtlı anahtarınız yok | 403 | provider_credential_required |
| EVREN anahtarınızı reddetti | 403 | provider_credential_rejected |
| EVREN hesabınız isteği karşılamadı | 403 | provider_account_limited |
| EVREN hız sınırı uyguladı | 429 | provider_rate_limited |
| EVREN başka bir sebeple reddetti (4xx) | sağlayıcının kodu | provider_upstream_error |
| EVREN tarafında arıza (5xx) | 502 | provider_upstream_error |
Bu satırlarda sunulmayanlar
Araç çağrısı, JSON modu ve düşünme denetimi bu satırlarda sunulmuyor. Bu parametreleri göndermeyin.
Yeteneği sunmayan bir satıra araç tanımı göndermek hata döndürmeyebilir: model aracı çağırmak yerine aracın ne döndüreceğini düzyazıyla yazabilir ve istek 200 döner. Araç çağrısı gerektiren bir adım için katalogda bu yeteneği taşıyan bir satır seçin.
Akış bu satırlarda gerçek akış değildir: yanıt tamamlandıktan sonra parça parça iletilir. Ayrı bir çıktı tavanı yayımlanmadığı için model kartındaki sınır bağlam penceresidir.
Neden doğrudan EVREN yerine buradan?
Doğrudan bağlanmak da çalışır ve bu yazı bunun aksini söylemiyor. Fark, ikinci modele geçtiğiniz gün ortaya çıkıyor.
EVREN'e doğrudan da bağlanabilirsiniz; LLMTR üzerinden bağlanmanın farkı, aynı kodun Türkiye'de barınan başka modellere ve global modellere de ulaşmasıdır. Katalogda bugün Türkiye'de barınan on iki canlı satır var ve bunların yedisi EVREN dışındaki satırlar; global modellere geçmek için değişen tek şey istekteki model kimliği.
Bu istekler için LLMTR ücret almaz. Kredi yüklerken eklenen yüzde 8 platform payı da değişmez; o pay model tarifesine değil, kredi yüklemeye uygulanır.
EVREN modellerini LLMTR üzerinden çağırma
EVREN API anahtarınızı LLMTR'ye tanıtıp EVREN modellerini OpenAI uyumlu Chat Completions ucundan çağırma adımları.
- EVREN anahtarı oluşturun. EVREN konsolundan bir API anahtarı oluşturun ve EVREN'in kullanım şartlarını kabul edin.
- Anahtarı LLMTR'ye tanıtın. LLMTR'de Ayarlar bölümündeki kendi sağlayıcı anahtarlarınız kartına anahtarı yapıştırıp kaydedin.
- Modeli çağırın. Chat Completions ucuna model kimliği olarak evren ile başlayan bir kimlik yazarak istek gönderin; kimlik doğrulama başlığında yalnızca LLMTR anahtarınız bulunur.
- Hata durumunu okuyun. Bir hata alırsanız error.type alanına bakın; details.upstreamStatus alanı EVREN'in döndürdüğü özgün kodu taşır.
Sık sorulan sorular
EVREN'i doğrudan mı kullanmalıyım, LLMTR üzerinden mi?
EVREN'e doğrudan da bağlanabilirsiniz; LLMTR üzerinden bağlanmanın farkı, aynı kodun Türkiye'de barınan başka modellere ve global modellere de ulaşmasıdır. Tek bir modelle çalışacaksanız iki yol da aynı sonucu verir; birden fazla model deneyecekseniz ikinci modelde fark açılır.
EVREN anahtarım isteğimde gidiyor mu?
Hayır. İsteğinizde yalnızca LLMTR anahtarınız bulunur. EVREN anahtarınız Ayarlar'da kayıtlı durur, yüksek şifreleme ile saklanır ve yalnızca sizin isteğinizi göndermek için kullanılır.
LLMTR bu istekler için ücret alıyor mu?
Hayır. EVREN satırlarının katalog fiyatı sıfırdır ve bu istekler LLMTR bakiyenizden düşmez. Kredi yüklemedeki yüzde 8 platform payı bundan bağımsızdır ve değişmez.
EVREN satırlarında araç çağrısı çalışıyor mu?
Hayır, bu satırlarda araç çağrısı sunulmuyor. İsteğinize araç tanımı eklemeyin: yanıt hata yerine düzyazı dönebilir. Araç çağrısı gerektiren bir adım için katalogda bu yeteneği taşıyan bir satır seçin.
Kayıtlı anahtarımı kaldırırsam ne olur?
Anahtar kaldırıldığı anda kullanılamaz hâle gelir ve o sağlayıcının satırlarına giden istekler 403 provider_credential_required ile durur. Katalogdaki diğer modelleri kullanmaya devam edersiniz.