Mistral entegrasyonu: model seçimi, API maliyeti ve veri gizliliği rehberi
Mistral entegrasyonu, Mistral AI'ın dil modellerini kendi API anahtarınızla Yox İş Ortağım paneline bağlayıp ürün başlığı, açıklama, kategori ve özellik önerisi ile satış analizlerini bu modellerle üretmektir. Mistral'ı ayıran üç şey var: Avrupa merkezli bir şirket olması, modellerinin çoğunu açık ağırlıklı yayımlaması ve küçük modellerinde token fiyatının çok düşük kalması. Bu rehberde Ekim 2026 itibarıyla güncel modelleri, resmî API fiyatlarını, örnek maliyeti, API anahtarı adımlarını, veri saklama kurallarını ve panelde kurulumu anlatıyoruz.
Mistral entegrasyonu nedir, Mistral AI satıcıya hangi işlerde yarar?
Mistral entegrasyonu, satıcının ürün içeriği ve raporlama işlerini Mistral AI modelleriyle, kendi hesabından ve kendi faturasıyla çalıştırmasıdır. Mistral AI, Paris'te kayıtlı bir Fransız şirketidir (15 rue des Halles, 75001 Paris); modellerinin önemli bir kısmını açık ağırlıklı (open-weight) olarak Apache 2.0 ya da değiştirilmiş MIT lisansıyla yayımlar. Geliştirici konsolu console.mistral.ai adresindedir; Mistral bugün bu ortamı Studio olarak adlandırıyor, pek çok kaynakta eski adı La Plateforme geçer. Tüketiciye yönelik sohbet asistanının adı ise Ağustos 2026'dan beri Vibe'dır (eski adıyla Le Chat).
E-ticaret satıcısı açısından Mistral'ın güçlü olduğu yerler şunlardır:
- Maliyet: Ministral 3 ve Mistral Small 4 gibi küçük modellerde milyon token fiyatı 0,10–0,60 dolar aralığındadır; yüzlerce ürünlük katalog işlerinde fatura düşük kalır.
- Dil desteği: Mistral'ın desteklenen diller sayfası Türkçeyi, dil modellerinde güçlü performans beklenen diller arasında sayar.
- Veri konumu seçeneği: İsteğe bağlı AB bölgesel uç noktası (api.eu.mistral.ai), çıkarımın AB ve EFTA ülkelerindeki veri merkezlerinde yapılmasını sağlar.
Yine de Türkçe ürün metinlerinde marka, ölçü ve malzeme bilgisinin doğru taşındığını kendi ürünlerinizle denemeniz gerekir; bu yüzden panelde hiçbir öneri siz onaylamadan ilana yazılmaz.
Mistral modelleri Ekim 2026: hangi iş için hangi model?
Ekim 2026 itibarıyla Mistral'ın genel amaçlı metin modelleri Medium 3.5, Large 4, Large 3, Small 4 ve Ministral 3 ailesidir; satıcı işleri için seçim çoğunlukla Small 4 ile Large 3 arasında yapılır. Aşağıdaki tablodaki API adları, durum ve bağlam penceresi Mistral'ın model kartlarından alınmıştır; son sütun bizim kullanım önerimizdir.
| Model (API adı) | Durum, sürüm | Bağlam | Önerilen satıcı işi |
|---|---|---|---|
| Mistral Medium 3.5 (mistral-medium-3-5) | Genel kullanım (GA), v26.04 | 256 bin token | Uzun rapor yorumu; çıktı fiyatı yüksek |
| Mistral Large 4 (mistral-large-4) | Public Preview, v26.10 (6 Ekim 2026) | 1 milyon token | Deneme; önizleme modeli değişebilir |
| Mistral Large 3 (mistral-large-2512) | GA, v25.12, Apache 2.0 | 256 bin token | Kalite-fiyat dengesi: açıklama, fiyat yorumu |
| Mistral Small 4 (mistral-small-2603) | GA, v26.03, Apache 2.0 | 256 bin token | Toplu başlık ve açıklama, kategori önerisi, müşteri sorusu taslağı |
| Ministral 3 14B / 8B / 3B (ministral-14b-2512 vb.) | GA, v25.12, Apache 2.0 | 256 bin token | Kısa işler: eksik özellik, sınıflandırma |
Sabit sürüm adı mı, -latest takma adı mı?
Mistral'ın model yaşam döngüsü politikasına göre mistral-small-latest gibi takma adlar en yeni sürüme kayar ve davranış ile fiyat haber verilmeden değişebilir. Örneğin 13 Ekim 2026'da mistral-large-latest, Large 4'e değil Large 3'e işaret ediyordu. Ürün içeriğinde tutarlılık istiyorsanız sabit sürüm adını seçin.
Akıl yürütme ayarı (reasoning_effort) ne zaman açılmalı?
Small 4, Medium 3.5 ve Large 4, istek başına reasoning_effort parametresiyle akıl yürütme düzeyini ayarlar. Mistral'ın dokümanı, yüksek düzeyde yanıtın önce bir düşünme bölümü içerdiğini ve token kullanımının arttığını belirtir. Başlık ve açıklama gibi kalıplı işlerde bu ayar çoğu zaman gereksizdir; çok adımlı analizlerde fark yaratabilir.
Mistral API fiyatları: 1 milyon token başına girdi ve çıktı ücreti
Mistral API'si kullandıkça öde mantığıyla çalışır ve girdi (gönderdiğiniz metin) ile çıktı (modelin yazdığı metin) ayrı fiyatlanır. Aşağıdaki fiyatlar Mistral dokümanının fiyat sayfasından 13 Ekim 2026'da alınmıştır; ABD doları, vergiler hariç ve standart katman içindir. Fiyatlar değişebilir, ödeme öncesinde resmî sayfayı kontrol edin.
| Model | Girdi (1M token) | Önbellekli girdi (1M token) | Çıktı (1M token) |
|---|---|---|---|
| Mistral Large 4 | 1,36 $ (indirimli 0,68 $) | 0,14 $ (indirimli 0,07 $) | 4,18 $ (indirimli 2,09 $) |
| Mistral Large 3 | 0,50 $ | 0,05 $ | 1,50 $ |
| Mistral Medium 3.5 | 1,50 $ | 0,15 $ | 7,50 $ |
| Mistral Small 4 | 0,15 $ | 0,015 $ | 0,60 $ |
| Ministral 3 14B | 0,20 $ | 0,02 $ | 0,20 $ |
| Ministral 3 8B | 0,15 $ | 0,015 $ | 0,15 $ |
| Ministral 3 3B | 0,10 $ | 0,01 $ | 0,10 $ |
Faturayı değiştiren üç ayar
- Bölgesel çıkarım %10 ek ücretlidir: AB ya da ABD uç noktası girdi, çıktı ve önbellek okumalarında standart liste fiyatının 1,1 katıyla faturalanır.
- Toplu işleme (Batch) %50 indirimlidir: Gerçek zamanlı yanıt gerekmeyen büyük işler için tasarlanmıştır; anında öneri bekleyen ekranlar için uygun değildir.
- Önbellekli girdi daha ucuzdur: Mistral'ın fiyat sayfasına göre tekrar eden istem bölümleri girdi maliyetini yüzde 90'a kadar düşürebilir.
Medium 3.5'te çıktı tokenı girdinin beş katı fiyatlıdır; uzun açıklama üreten işlerde faturayı belirleyen asıl kalem çıktı uzunluğudur.
Örnek maliyet: 1.000 ürün açıklaması Mistral ile kaça çıkar?
1.000 ürün açıklaması, Mistral Small 4 ile yaklaşık 0,33 dolar, Mistral Medium 3.5 ile yaklaşık 3,90 dolar tutar; aşağıdaki hesap varsayımlara dayanan bir örnektir. Mistral, Türkçe metin için kelime başına token oranı yayımlamaz; ekler nedeniyle token sayısı kelime sayısından belirgin biçimde fazla olabilir. Gerçek sayıyı birkaç ürünlük denemeden sonra kullanım kaydından okuyun.
- Ürün başına girdi: talimat + ürün kartı alanları için yaklaşık 600 token.
- Ürün başına çıktı: başlık + 150–200 kelimelik Türkçe açıklama için yaklaşık 400 token.
- 1.000 ürün: 0,6 milyon girdi + 0,4 milyon çıktı tokenı; akıl yürütme kapalı, önbellek indirimi yok.
- Günlük işletme brifi: günde yaklaşık 8.000 token özet veri girdisi ve 1.200 token yorum; 30 günde 0,24 milyon girdi + 0,036 milyon çıktı.
| Model | 1.000 ürün açıklaması | Aynı iş AB uç noktasıyla (×1,1) | 30 günlük işletme brifi |
|---|---|---|---|
| Ministral 3 8B | 0,15 $ | 0,17 $ | 0,04 $ |
| Ministral 3 14B | 0,20 $ | 0,22 $ | 0,06 $ |
| Mistral Small 4 | 0,33 $ | 0,36 $ | 0,06 $ |
| Mistral Large 3 | 0,90 $ | 0,99 $ | 0,17 $ |
| Mistral Large 4 (liste fiyatı) | 2,49 $ | 2,74 $ | 0,48 $ |
| Mistral Medium 3.5 | 3,90 $ | 4,29 $ | 0,63 $ |
Tablo, model ücretinin katalog işlerinde çoğu zaman dolar altı kaldığını gösteriyor; asıl maliyet kötü bir metni düzeltmek için harcanan zamandır. Önce Small 4 ile başlayıp beğenmediğiniz ürün gruplarında Large 3'ü denemek daha mantıklıdır. Kendi anahtarınızla yapılan kullanım Mistral hesabınıza yansır.
Mistral API anahtarı nasıl alınır? Studio konsolunda adım adım
Mistral API anahtarı, console.mistral.ai adresindeki Studio konsolunun API Keys bölümünden birkaç dakikada oluşturulur. Mistral'ın hızlı başlangıç rehberine göre Studio yeni hesaplarda ücretsiz modda ve kredi kartı istemeden açılır; kullanım ve oran sınırları bu modda düşüktür.
- Mistral hesabınızla console.mistral.ai adresine giriş yapın; anahtarlar, kullanım ve sınırlar hesabınızın kuruluşu (Organization) ve çalışma alanı (Workspace) altında tutulur.
- Sol menüde API Keys bölümünü açın ve Create new key seçeneğine tıklayın.
- Anahtara ayırt edici bir ad verin (ör. yox-panel) ve bir son kullanma tarihi seçin; Mistral düzenli değiştirmeyi önerir.
- Anahtarı oluşturup hemen kopyalayın ve parola yöneticisinde saklayın; tam anahtar yalnız bir kez gösterilir.
- Admin Panel'de Privacy menüsünden model eğitimine veri paylaşımı ayarını kontrol edin, ardından anahtarı Yox İş Ortağım'daki AI Yönetimi ekranına bağlayın.
Ücretsiz mod, ön ödemeli kredi ve harcama sınırı
Ücretsiz mod deneme için yeterlidir ama katalog ölçeğinde iş için kullandıkça öde (pay-as-you-go) seçeneğini açmanız gerekir. Mistral'ın faturalama dokümanına göre bu seçenek ön ödemelidir: önce kredi yüklersiniz, kullanım bu bakiyeden düşer. Bakiye sıfırlandığında aylık dahil kullanımı aşan istekler HTTP 402 hatasıyla reddedilir. Otomatik yükleme ve aylık harcama sınırı tanımlayabilirsiniz; sınıra ulaşıldığında API erişimi ay sonuna kadar durabilir.
Oran sınırları ve sık görülen hata kodları
- Oran sınırları çalışma alanı düzeyindedir: Aynı çalışma alanındaki tüm anahtarlar saniyedeki istek, dakikadaki token ve aylık token sınırını paylaşır; güncel değerleri Admin Panel > API > Limits ekranında görürsünüz.
- 401 Unauthorized: anahtar yanlış girilmiş ya da silinmiş.
- 402 Payment Required: ödeme yöntemi ya da kredi bakiyesi yok.
- 429 Too Many Requests: oran sınırı aşıldı; Mistral bekleyip artan aralıklarla yeniden denemeyi önerir.
Vibe (eski Le Chat) ile Mistral API arasındaki fark
Vibe, Mistral'ın chat.mistral.ai adresindeki sohbet ve iş asistanıdır; Mistral API ise kendi yazılımınızın modele doğrudan bağlanmasıdır ve Yox İş Ortağım'a bağlanan şey API anahtarıdır. Mistral'ın yardım merkezi, Le Chat'in Vibe adını aldığını ve hesap, plan ile konuşmaların aynen taşındığını Ağustos 2026 tarihli duyurusunda açıklar.
| Konu | Vibe (chat.mistral.ai) | Mistral API (Studio) |
|---|---|---|
| Ne için | Sohbet, belge ve iş görevleri; elle kullanım | Yazılımın modeli doğrudan çağırması; panel bağlantısı |
| Ücret | Free; Pro 14,99 $/ay; Team 24,99 $/kullanıcı/ay (vergiler hariç); Enterprise teklifle | Token başına; ücretsiz mod + ön ödemeli kredi |
| Model eğitiminde kullanım | Varsayılan açık, ayarlardan kapatılır; Enterprise'da varsayılan kapalı | Ücretsiz modda kullanılabilir; Admin Panel > Privacy'den kapatılır |
| Veri saklama | Konuşmalar siz silene kadar tutulur; sıfır veri saklama (ZDR) yok | Kötüye kullanım izleme için 30 gün; ZDR başvuruyla, yalnız kullandıkça öde modunda |
| Yox panelinde | Abonelik doğrudan bağlanmaz | API anahtarı AI Yönetimi'ne bağlanır |
Mistral planları Vibe, Studio ve API için ortaktır; fiyat sayfasına göre Pro planı aylık API kredisi de içerir. Yani Pro aboneyseniz Studio'da oluşturduğunuz anahtar önce bu dahil kullanımı tüketir. Vibe ile API'nin eğitim tercihleri ayrı ayarlardır: birini kapatmak diğerini kapatmaz.
Mistral veri gizliliği: AB'de işleme, model eğitimi ve saklama süresi
Mistral AI, GDPR'a tabi bir AB şirketidir; ancak varsayılan global uç noktada (api.mistral.ai) çıkarımın belirli bir ülkede yapılacağını taahhüt etmez. Satıcı için doğru soru "Mistral Avrupalı mı?" değil, hangi uç noktaya ve hangi gizlilik ayarıyla istek gönderildiğidir.
Model eğitimi ve 30 günlük saklama
Mistral'ın yardım merkezi, Studio ücretsiz modunda girdi ve çıktının model eğitiminde kullanılabileceğini, kullandıkça öde modunda ise bu işlemenin kontrolünün müşteride olduğunu ve her an kapatılabileceğini yazar. Kapatma yeri Admin Panel > Privacy altındaki Anonymous improvement data anahtarıdır. Gizlilik politikasına göre API girdi ve çıktıları, yanıt üretildikten sonra kötüye kullanımı izlemek için 30 gün saklanır; sıfır veri saklama (ZDR) onaylanmışsa bu saklama yapılmaz. ZDR yalnız kullandıkça öde modunda ve gerekçeli başvuruyla verilir.
AB bölgesel uç noktası neyi sağlar, neyi sağlamaz?
api.eu.mistral.ai uç noktası, çıkarımın AB ve EFTA ülkelerindeki veri merkezlerinde yapılmasını sağlar ve %10 ek ücretlidir. Mistral'ın dokümanına göre hesap, anahtar ve faturalama gibi yönetim verileri yine bölge dışında işlenebilir; Agents, Batch ve Files API bölgesel uçta yoktur. Bölgesel işleme şartınız varsa bunu kurulumdan önce destek ekibimize iletin.
KVKK açısından satıcıya pratik not
- Panel, yalnız siz bir yapay zekâ işlemi başlattığınızda o işlem için gereken veriyi gönderir: içerik görevlerinde ürün kartı alanlarını, rapor görevlerinde özetlenmiş verileri.
- Müşteri adı, telefon, adres gibi kişisel verileri talimatlara ya da ürün açıklamalarına yazmayın; müşteri sorusu taslaklarında soru metnini gözden geçirin.
- KVKK'nın 9. maddesi 2024 değişikliğiyle yurt dışına aktarımı yeterlilik kararı ya da standart sözleşme gibi güvencelere bağlar; standart sözleşme imzadan sonra 5 iş günü içinde Kurula bildirilir. Kişisel veri işleyecekseniz hukuk danışmanınızla değerlendirin.
Yox İş Ortağım'da Mistral entegrasyonu: ekran, görev ve paket şartı
Yox İş Ortağım'da Mistral entegrasyonu, AI Yönetimi ekranında sağlayıcı ve model seçimiyle kurulur; kurulum kısa sürer ve ilk işlemi kendiniz kontrol edersiniz. Panelde bugün doğrudan seçilebilen sağlayıcılar Claude, ChatGPT ve Gemini'dir; Mistral anahtarı bağlandığında aynı görevler sizin hesabınızdaki Mistral modeliyle çalışır:
- Pazaryeri kurallarına uygun ürün başlığı ve açıklama önerisi; Trendyol gibi yurt içi kanallar için kategori eşleme önerisi.
- Reddedilen ilanlarda eksik zorunlu özelliği doldurma önerisi ve yurt dışı kanallar için ürün çevirisi.
- Alış faturası PDF'inden ya da görselinden bilgi okuma.
- Hazır analiz görevleri: günlük işletme brifi, sipariş analizi, kâr ve ciro yorumu, stok risk raporu, katalog kalite ve fiyatlandırma analizi, rekabet stratejisi, iade kök-neden ve kargo analizi, müşteri sorusuna yanıt taslağı.
- Prompt Merkezi: Her görevin talimatını düzenleyebilir ya da görevi kapatabilirsiniz; AI Yönetimi'ndeki kullanım kaydında harcamayı izlersiniz.
| Paket (aylık) | Fiyat | Yapay zekâ | Mistral anahtarı |
|---|---|---|---|
| Başlangıç | ₺499 | Yok | Bağlanmaz |
| Büyüme | ₺999 | Yok | Bağlanmaz |
| Profesyonel | ₺1.999 | Platform token'ıyla başlık, açıklama, kategori önerisi | Bağlanmaz; platform token'ı kullanılır |
| Kurumsal | ₺3.999 | Kendi yapay zekâ anahtarı | Bağlanır; kullanım token limitinden muaf |
| Enterprise | ₺7.999 | Kurumsal kapsamı, bütün limitler sınırsız | Bağlanır |
Yıllık ödemede paketlerde %20 indirim uygulanır; ayrıntılar paket karşılaştırmasında.
Türkçe ürün içeriği üretirken dikkat edilecekler
- Talimata kanalın başlık kurallarını yazın: marka, model, ana özellik sırası ve karakter sınırı kanaldan kanala değişir; başlık optimizasyon aracıyla uzunluğu kontrol edin.
- Kanıtlayamayacağınız iddiaları yasaklayın: "en ucuz", "bir numara", "yüzde yüz orijinal" gibi ifadeler pazaryeri denetimine takılabilir ve tüketici şikâyetine yol açar.
- Ürün kartında olmayan ölçü, malzeme ya da uyumluluk bilgisini yazmamasını talimata ekleyin.
- Hepsiburada gibi kanallarda reddedilen ilanın sebebini önce okuyun; eksik özellik önerisi ancak kanalın beklediği değer listesiyle anlamlıdır.
Mistral entegrasyonu öncesi kontrol listesi ve sık yapılan hatalar
Mistral'a geçmeden önce beş kararı netleştirmek, kurulum sonrası sürprizleri önler:
- Paket: Kendi Mistral anahtarı için Kurumsal paket gerekir; Profesyonel pakette yapay zekâ platform token'ıyla çalışır.
- Plan: Studio ücretsiz modda mı kalacak, yoksa kullandıkça öde açılıp kredi yüklenecek mi?
- Model: Sabit sürüm adı (ör. mistral-small-2603) mı, -latest takma adı mı kullanılacak?
- Gizlilik: Admin Panel > Privacy'de eğitim ayarı kapatıldı mı, AB bölgesel işleme şartı var mı?
- Bütçe: Kuruluş ve çalışma alanı için aylık harcama sınırı ve otomatik yükleme ayarlandı mı?
Sık gördüğümüz hatalar ise şunlar:
- Önizleme modelini (Large 4) üretimde kullanmak: Mistral'ın politikası önizleme modellerinin haber verilmeden güncellenebileceğini ve genel kullanıma geçmeden emekliye ayrılabileceğini söyler.
- Kredi bakiyesini izlememek: bakiye bittiğinde istekler 402 hatası verir; kredinin %80'i harcandığında yöneticilere giden e-postayı kaçırmayın.
- Önerileri okumadan onaylamak: modelin yazdığı her başlık ve açıklama sizin ilanınızdır.
Başlamak için başvuru formunu doldurabilirsiniz; 3 günlük ücretsiz deneme vardır.
Son kontrol: 14 Ekim 2026