```html
Mistral AI, Mistral Medium 3'ün piyasaya sürülmesiyle yapay zeka topluluğunda yankı uyandırdı. Bu, rakiplerine göre 8 kat daha düşük maliyetle son teknoloji (SOTA) performansı sunan çok modlu bir yapay zeka modelidir. 7 Mayıs 2025'te piyasaya sürülen bu model, kodlama, STEM muhakemesi ve kurumsal düzeydeki uygulamalarda mükemmel sonuçlar vererek, geliştiriciler ve işletmeler için tercih edilen bir seçenek haline geldi. Mistral Medium 3, çeşitli kıyaslamalarda Llama 4 Maverick, GPT-4o ve Claude Sonnet 3.7 gibi modellerden, özellikle kodlama ve çok modlu görevlerde daha iyi performans gösteriyor. Peki, bu güçlü modeli projeleriniz için nasıl kullanabilirsiniz? Cevap, Mistral Medium 3 API'sine erişimde yatıyor.
Bu kılavuzda, Mistral Medium 3 API'sine erişme ve uygulamalarınıza entegre etme sürecinde size yol göstereceğim.
Neden Mistral Medium 3 API'sini Kullanmalısınız?
Mistral Medium 3, hem bireysel geliştiriciler hem de işletmeler için ideal hale getiren benzersiz bir performans, maliyet ve dağıtılabilirlik dengesi sunar. Mistral AI'nin duyurusuna göre, model, maliyetin çok altında, sınıfının en iyisi performansı sunuyor; milyon başına 0,40 ABD doları giriş tokeni ve milyon başına 2 ABD doları çıkış tokeni fiyatlandırılıyor. Bu fiyatlandırma yapısı, onu Claude Sonnet 3.7 veya Cohere'in Command-A'sı gibi rakiplerine göre önemli ölçüde daha uygun fiyatlı hale getiriyor.
Ayrıca, API, güvenli, şirket içi çözümlere ihtiyaç duyan işletmeler için oyunun kurallarını değiştiren hibrit ve şirket içi dağıtımları destekler. Kodlama, talimat takibi ve çok modlu anlama konusunda güçlü yetenekleriyle Mistral Medium 3 API, finansal hizmetlerden sağlık hizmetlerine kadar profesyonel kullanım durumları için tasarlanmıştır. Şimdi, bu API'ye erişmenin inceliklerine geçelim.
Mistral Medium 3 API'sine Erişmek İçin Ön Koşullar
Mistral Medium 3 API'sine erişmek için birkaç şey hazırlamanız gerekir. İlk olarak, API'ler ve nasıl çalıştıkları hakkında temel bir anlayışa sahip olduğunuzdan emin olun. HTTP istekleri, JSON yükleri ve API anahtarları gibi kimlik doğrulama mekanizmaları hakkında bilgi sahibi olmak faydalı olacaktır.
Adım 1: Mistral AI'ye Kaydolun ve API Anahtarınızı Alın
Başlamak için, console.mistral.ai adresindeki Mistral AI platformuna gidin. Kaydolmak ve API anahtarınızı almak için şu adımları izleyin:
Hesap Oluşturun: "Kaydol" düğmesine tıklayın ve e-postanızı, adınızı ve şifrenizi girin. Hesabınızı etkinleştirmek için e-posta adresinizi doğrulayın.
Oturum Açın: Hesabınız etkinleştikten sonra, Mistral AI konsolunda oturum açın.
API Bölümüne Gidin: Kontrol panelinde, "API" veya "Geliştirici" bölümünü arayın. Mistral Medium 3 API ile ilgili ayrıntıları burada bulacaksınız.
API Anahtarı Oluşturun: Yeni bir API anahtarı oluşturma seçeneğine tıklayın.
Bu anahtarı kopyalayın ve güvenli bir şekilde saklayın; hesabınızın API kullanımına erişim sağladığı için asla herkese açık olarak paylaşmayın.
Mistral AI ayrıca kullandıkça öde fiyatlandırma modeli sunar, bu nedenle API'yi kullanmaya başlamak için ödeme bilgileri eklemeniz gerekir. Daha önce belirtildiği gibi, Mistral Medium 3 API'si milyon başına 0,40 ABD doları giriş tokeni ve milyon başına 2 ABD doları çıkış tokeni maliyetindedir, bu da onu geliştiriciler için uygun maliyetli bir seçenek haline getirir.
Adım 2: Mistral Medium 3 API Uç Noktalarını Anlayın
Ardından, Mistral Medium 3 API uç noktalarını tanıyın. Bir API uç noktası, uygulamanızın modelle etkileşim kurmak için istek gönderdiği belirli bir URL'dir. Mistral Medium 3 API, Mistral La Plateforme ve Amazon Sagemaker aracılığıyla kullanılabilir ve IBM WatsonX ve Google Cloud Vertex gibi platformlarda yakında desteklenecektir.
Mistral Medium 3 için birincil uç nokta muhtemelen, mistral-tiny ve mistral-small gibi Mistral'in önceki modellerine benzer bir üretken uç noktasıdır. Bu kılavuz için, API'nin temel URL'sinin şu olduğunu varsayalım:
https://api.mistral.ai/v1
Mistral Medium 3 API, metin oluşturma, kodlama yardımı ve çok modlu anlama gibi çeşitli görevleri destekler. Yaygın uç noktalar şunları içerebilir:
- Metin Oluşturma:
/v1/generate– Bir isteme göre metin veya kod oluşturmak için bunu kullanın. - Sohbet Tamamlama:
/v1/chat/completions– Konuşma görevleri için idealdir. - Çok Modlu Görevler:
/v1/multimodal– Görüntü veya metin tabanlı çok modlu girdileri işlemek için.
Mistral Medium 3 çok modlu bir model olduğundan, hem metin hem de görüntüleri işleyebilir, bu da onu belge analizi veya kod oluşturma gibi uygulamalar için çok yönlü hale getirir. Kesin uç noktalar ve parametreler için Mistral AI'nin resmi API belgelerine bakın.
Adım 3: Geliştirme Ortamınızı Kurun
Şimdi, API istekleri yapmak için geliştirme ortamınızı kurun. Bu kılavuz için, basitliği ve yaygın olarak benimsenmesi nedeniyle Python kullanacağım. Ancak, JavaScript (Node.js), Java veya Go gibi HTTP isteklerini destekleyen herhangi bir programlama dilini kullanabilirsiniz.
Gerekli Kütüphaneleri Yükleyin
İlk olarak, HTTP isteklerini işlemek için Python'da requests kütüphanesini yükleyin. Terminalinizi açın ve şunu çalıştırın:
pip install requests
Temel Bir Komut Dosyası Oluşturun
Yeni bir Python dosyası, mistral_medium_3_api.py oluşturun ve temel yapıyı ayarlamak için aşağıdaki kodu ekleyin:
import requests
import json
# API anahtarınızı tanımlayın
API_KEY = "your-api-key-here"
# Mistral Medium 3 API için temel URL'yi tanımlayın
BASE_URL = "https://api.mistral.ai/v1"
# Kimlik doğrulama için başlıkları ayarlayın
headers = {
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json"
}
your-api-key-here ifadesini, Mistral AI'den aldığınız API anahtarıyla değiştirin. headers sözlüğü, kimlik doğrulama için Authorization başlığını ve JSON verisi gönderdiğimizi belirtmek için Content-Type başlığını içerir.
Adım 4: Mistral Medium 3'e İlk API İsteğinizi Yapın
Ortamınız kurulduğuna göre, Mistral Medium 3 API'sine ilk API isteğinizi yapalım. Bu örnek için, basit bir metin yanıtı oluşturmak üzere /v1/generate uç noktasını kullanacağım.
API İsteğini Oluşturun
Bir istek göndermek için Python komut dosyanıza aşağıdaki kodu ekleyin:
# Metin oluşturma için uç noktayı tanımlayın
endpoint = f"{BASE_URL}/generate"
# Yükü (giriş verileri) tanımlayın
payload = {
"prompt": "Bir sayının faktöriyelini hesaplamak için bir Python fonksiyonu yazın.",
"max_tokens": 200,
"temperature": 0.7
}
# API isteğini gönderin
response = requests.post(endpoint, headers=headers, json=payload)
# Yanıtı kontrol edin
if response.status_code == 200:
result = response.json()
print("API Yanıtı:", result)
else:
print(f"Hata: {response.status_code} - {response.text}")
Kodun Açıklaması
- Uç Nokta: Metin oluşturma uç noktasını hedeflemek için temel URL'ye
/generateekliyoruz. - Yük:
payloadsözlüğü, giriş istemini,max_tokens(yanıt uzunluğunu sınırlamak için) vetemperature(çıkışın rastgeleliğini kontrol etmek için) içerir. - İstek:
requests.postyöntemi, başlıklar ve yük ile API'ye bir POST isteği gönderir. - Yanıt: İsteğin başarılı olup olmadığını (200 başarı anlamına gelir) doğrulamak için
status_code'u kontrol ediyoruz. Başarılı olursa, yanıtı yazdırırız; aksi takdirde, hatayı yazdırırız.
Beklenen Çıktı
Başarılı olursa, API oluşturulan metni içeren bir JSON yanıtı döndürecektir, örneğin:
{
"text": "İşte bir sayının faktöriyelini hesaplamak için bir Python fonksiyonu:\n\n```python\ndef factorial(n):\n if n == 0 or n == 1:\n return 1\n else:\n return n * factorial(n-1)\n```\n\nBu fonksiyon, faktöriyeli hesaplamak için özyineleme kullanır. Örneğin, `factorial(5)` `120` döndürür."
}
Adım 5: Apidog ile Test Edin ve Hata Ayıklayın
Bu noktada, ilk API isteğinizi yaptınız, ancak sorunlarla karşılaşırsanız ne olur? İşte bu noktada Apidog devreye giriyor. Apidog, API'leri test etmeyi, hata ayıklamayı ve belgelemeyi basitleştiren güçlü bir API yönetim aracıdır. Mistral Medium 3 API'sini test etmek için Apidog'u nasıl kullanacağımıza bakalım.
Apidog'u Yükleyin ve Kurun
Yeni Bir Proje Oluşturun: Apidog'u açın ve "Mistral Medium 3 API Testi" adlı yeni bir proje oluşturun.
API Uç Noktasını Ekleyin: Apidog'da, aşağıdaki ayrıntılarla yeni bir API isteği ekleyin:
- Yöntem: POST
- URL:
https://api.mistral.ai/v1/generate - Başlıklar:
Authorization:Bearer your-api-key-hereContent-Type:application/json- Gövde: JSON yükünü ekleyin
Bir Test İsteği Gönderin
İsteği test etmek için Apidog'daki "Gönder" düğmesine tıklayın. Apidog, yanıt durumunu, başlıkları ve gövdeyi görüntüleyerek, herhangi bir sorunun giderilmesini kolaylaştırır. Örneğin, 401 Yetkisiz hatası alırsanız, Authorization başlığındaki API anahtarınızı iki kez kontrol edin.
Apidog Kullanmanın Faydaları
Apidog, Mistral Medium 3 API ile çalışmak için çeşitli avantajlar sunar:
- Görsel Arayüz: Kod yazmadan API isteklerini kolayca yönetin ve test edin.
- Yanıt Doğrulama: API yanıtının beklentilerinizi karşılayıp karşılamadığını hızlı bir şekilde doğrulayın.
- Belgeleme: Ekibiniz için otomatik olarak API belgeleri oluşturun.
- İşbirliği: API testlerinizi, işbirlikçi hata ayıklama için ekip arkadaşlarınızla paylaşın.
Apidog'u kullanmak, Mistral Medium 3 API ile entegrasyonunuzun sorunsuz ve hatasız olmasını sağlar.
Adım 6: API Yanıtlarını ve Hatalarını İşleyin
Mistral Medium 3 API ile çalışırken, hem başarılı yanıtları hem de hataları işlemeniz gerekir. Python komut dosyamızı farklı senaryoları işleyecek şekilde geliştirelim.
API Yanıtını Ayrıştırın
Oluşturulan metni yanıttan çıkarmak için komut dosyanızı değiştirin:
if response.status_code == 200:
result = response.json()
generated_text = result.get("text", "Metin döndürülmedi")
print("Oluşturulan Metin:", generated_text)
else:
print(f"Hata: {response.status_code} - {response.text}")
result.get("text") yöntemi, alan eksikse bir yedek mesajla birlikte yanıttan text alanını güvenli bir şekilde çıkarır.
Yaygın Hataları İşleyin
Mistral Medium 3 API, belirli durumlarda hatalar döndürebilir. İşte bazı yaygın hata kodları ve bunları nasıl işleyeceğiniz:
- 401 Yetkisiz: Geçersiz veya eksik API anahtarı.
Authorizationbaşlığınızı iki kez kontrol edin. - 429 Oran Sınırı Aşıldı: API'nin oran sınırını aştınız. Yeniden denemeden önce birkaç dakika bekleyin veya oran sınırı ayrıntıları için Mistral AI'nin belgelerini kontrol edin.
- 500 Dahili Sunucu Hatası: Mistral AI'nin sunucusunda bir sorun. Bir süre sonra isteği yeniden deneyin veya sorun devam ederse destekle iletişime geçin.
Komut dosyanıza hata işleme ekleyin:
if response.status_code == 200:
result = response.json()
generated_text = result.get("text", "Metin döndürülmedi")
print("Oluşturulan Metin:", generated_text)
elif response.status_code == 401:
print("Hata: Geçersiz API anahtarı. Lütfen API anahtarınızı kontrol edin ve tekrar deneyin.")
elif response.status_code == 429:
print("Hata: Oran sınırı aşıldı. Lütfen bekleyin ve daha sonra tekrar deneyin.")
else:
print(f"Hata: {response.status_code} - {response.text}")
Bu, uygulamanızın hataları sorunsuz bir şekilde işlemesini ve anlamlı geri bildirim sağlamasını sağlar.
Adım 7: Gelişmiş Kullanım Durumları İçin Mistral Medium 3 API'sini Kullanın
Artık temellere hakim olduğunuza göre, Mistral Medium 3 API için bazı gelişmiş kullanım durumlarını keşfedelim. Kodlama, STEM ve çok modlu görevlerdeki güçlü yönleri göz önüne alındığında, işte birkaç fikir:
Kod Oluşturma
Kod parçacıkları oluşturmak için API'yi kullanın. Örneğin, yükünüzdeki istemi şu şekilde değiştirin:
{
"prompt": "Flask kullanarak bir REST API oluşturmak için bir Python komut dosyası yazın.",
"max_tokens": 300,
"temperature": 0.7
}
API, projenize entegre edebileceğiniz eksiksiz bir Flask API komut dosyası döndürecektir.
Çok Modlu Görevler
Mistral Medium 3, metin ve görüntüler gibi çok modlu girdileri destekler. API görüntü girdilerini destekliyorsa, şu şekilde bir istemle birlikte base64 ile kodlanmış bir görüntü gönderebilirsiniz:
{
"prompt": "Bu görüntünün içeriğini açıklayın.",
"image": "base64-encoded-image-data",
"max_tokens": 200
}
Çok modlu isteklerin tam biçimi için Mistral AI'nin belgelerini kontrol edin.
Kurumsal Entegrasyon
Kurumsal kullanıcılar için, Mistral Medium 3 API hibrit ve şirket içi dağıtımları destekler. Modeli dört GPU'ya dağıtabilir ve Gmail, SharePoint veya özel bilgi tabanları gibi kurumsal araçlarla entegre edebilirsiniz. Kurumsal özel yüklerle API çağrılarını simüle ederek bu entegrasyonları test etmek için Apidog'u kullanın.
Sonuç
Mistral Medium 3 API'sine erişmek, geliştiriciler ve işletmeler için bir dünya dolusu olanak sunar. Kod oluşturmaktan çok modlu görevleri işlemeye kadar, bu API, rakiplerine göre çok daha düşük bir maliyetle en üst düzeyde performans sunar. Bu kılavuzda, Mistral AI'ye kaydolma, API anahtarınızı alma, geliştirme ortamınızı kurma, API istekleri yapma ve Apidog ile test etme sürecinde size yol gösterdim. Bu adımları izleyerek, Mistral Medium 3'ü uygulamalarınıza sorunsuz bir şekilde entegre edebilir ve güçlü yeteneklerinden yararlanabilirsiniz.
İster yeni bir uygulama geliştiren bir geliştirici olun, ister uygun maliyetli yapay zeka çözümleri arayan bir işletme olun, Mistral Medium 3 API oyunun kurallarını değiştiriyor. Bugün denemeler yapmaya başlayın ve API test sürecinizi kolaylaştırmak için Apidog'u kullanmayı unutmayın!
```
