Mistral AI API: Hızlı Başlangıç Rehberi

Temel URL ve Kimlik Doğrulama

İlk adım, istemcinizi altyapımıza yönlendirecek şekilde yapılandırmaktır. Standart OpenAI temel URL'sini HTTPS://api.apimistralai.com/v1 ile değiştirin ve benzersiz API anahtarınızı yetkilendirme başlığına ekleyin. Bu basit değişiklik, mevcut entegrasyon mantığınızı bozmadan tüm istekleri uncensored modelimize yönlendirir.

• Temel URL: HTTPS://api.apimistralai.com/v1
• Kimlik Doğrulama: Bearer token'ı Authorization üstbilgi

Bağlantıları test etmeden önce anahtarınızın hesap panelinde aktif olduğundan emin olun.

İlk İstek

Bağlantıyı ve model yanıtını doğrulamak için standart bir sohbet tamamlama isteği gönderin. Aşağıdaki curl komut hedefi uncensored model temel bir istemle.

Bu, uç noktanın erişilebilir olduğunu ve standart içerik filtreleri olmadan metin döndürdüğünü doğrular.

Copycurl https://api.apimistralai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix syntax error in python list comprehension"}]
  }'

Yanıt metin içeriyorsa, entegrasyonunuz uncensored çıkarım katmanımızdan başarıyla yönlendiriliyor demektir.

Python SDK Entegrasyonu

API'mizle etkileşim kurmak için resmi OpenAI Python kütüphanesini kullanarak temel istek yapısını değiştirmeden. İstemciyi yeni base URL ve API anahtarınızla başlatın, ardından çağrıyı yapın chat.completions.create.

Bu yaklaşım, mevcut Python mantığınızı korurken uncensored model yeteneklerine erişim sağlar.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apimistralai.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Yanıt nesnesi, standart OpenAI yanıtlarıyla aynı şekilde davranır; bu da Python geliştiricileri için geçişi sorunsuz hale getirir.

Node SDK Entegrasyonu

JavaScript veya TypeScript ortamları için, özel base URL ile OpenAI paketini başlatın. Set the apiKey ve baseURL özelliklerini çağırmadan önce chat.completions.create.

Bu, Node.js uygulamalarınızın istekleri uncensored uç noktamıza yönlendirmesini sağarken, standart SDK kalıplarıyla uyumluluğu korur.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apimistralai.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Yanıt yapısı, mevcut Node.js iş akışlarınıza kolay entegrasyon sağlayacak şekilde OpenAI standartlarıyla tutarlı kalır.

SSE Üzerinden Akış Yanıtları

Gerçek zamanlı token üretimini etkinleştirmek için stream: true istek içinde. API, tokenlar oluşturulurken işlemenize olanak tanıyan Sunucu Tarafı Olayları (SSE) akışı döndürür.

Bu özellik kullanıcılar için algılanan gecikmeyi azaltır ve uzun tamamlamalar sırasında anında geri bildirim sağlar.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Tokenları artımlı olarak görüntülemek için SSE veri akışını ayrıştırın. Son parça, istek için toplam token kullanımını içerir.

Limitler, Hatalar ve Bağlam

Sıkı hız limitleriyle kullanımınızı izleyin ve yaygın HTTP hatalarını zarifçe yönetin. Dakika başına 300 istek ve anahtar başına 8 eşzamanlı istek izniniz vardır.

Bir 401 hatası geçersiz veya eksik bir API anahtarı olduğunu gösterir; bir 402 hatası ise ön ödemeli kredinizin tükendiğini bildirir. Bir 429 durumu dakikada 300 istek sınırını aştığınızı gösterir.

Bağlam pencereniz toplam 100.000 token destekler, istek başına maksimum çıktı 16.000 token'dır. Hatalar ve reddetmeler kredi tüketmez, bu nedenle yalnızca oluşturulan gerçek içerik için ödeme yaparsınız.