Mistral kullanıcıları için hızlı başlangıç

Temel URL & Kimlik Doğrulama

API'miz OpenAI SDK'ları ile tamamen uyumludur. Temel URL'yi güncellemeniz ve API anahtarınızı sağlamanız yeterlidir. Bu hizmet için temel URL https://api.mistralapi.com/v1 şeklindedir. Kimlik doğrulama Authorization başlığı aracılığıyla Bearer token kullanılarak yapılır. Bazı sağlayıcıların aksine karmaşık yönlendirme veya sağlayıcıya özel başlıklar gerektirmez; anahtarınızı normal şekilde iletmeniz yeterlidir.

• Temel URL: https://api.mistralapi.com/v1
• Başlık: Authorization: Bearer YOUR_API_KEY

API anahtarınız kaydolma anında oluşturulur. Ön ödemeli kredinize erişim sağladığı için güvenli tutun. Aylık abonelik ücreti yoktur, yalnızca token kullanımına dayalı kullandıkça öde fiyatlandırma vardır.

Sohbet Tamamlama Uç Noktası

API'mizin çekirdeği POST /v1/chat/completions uç noktasıdır. Bir mesaj listesi alır ve oluşturulan yanıtı döndürür. Bu uç nokta, çoğu LLM istemcisi tarafından kullanılan standart mesaj formatını destekler. Model kimliğini "uncensored" olarak belirtmelisiniz. Bu model, sunucularımızda barındırılan ve yasal yetişkin kullanım için içerik reddetmeden yanıt verecek şekilde ayarlanmış açık ağırlıklı büyük dil modelidir.

• Uç Nokta: POST /v1/chat/completions
• Model Kimliği: uncensored

API yalnızca metin yanıtları döndürür. Görüntüleri, sesleri, videoları veya gömme vektörlerini desteklemez. Çoğu geliştirici için bu uç nokta, temel URL ve model kimliği dışındaki sıfır kod değişikliğiyle standart OpenAI sohbet uç noktasının yerini alır.

Python SDK Entegrasyonu

Resmi OpenAI Python kütüphanesini kullanmak entegrasyon için en hızlı yoldur. Temel URL'yi uç noktamıza ayarlayın ve API anahtarınızı sağlayın. Aşağıdaki kod basit bir metin tamamlama isteğini gösterir.

• Kütüphaneyi yükleyin: pip install openai
• base_url değerini https://api.mistralapi.com/v1 olarak ayarlayın
• model="uncensored" kullanın

Bu yaklaşım API'mizin OpenAI yanıt yapısını yansıtması nedeniyle çalışır. Mevcut kütüphaneleri modifikasyon olmadan akış, fonksiyon çağırma ve JSON modu için kullanabilirsiniz.

Node SDK Entegrasyonu

JavaScript/TypeScript geliştiricileri için openai npm paketi sorunsuz çalışır. İstemciyi temel URL'miz ve API anahtarınızla yapılandırın. Bu, aynı kod tabanını hem OpenAI hem de bizim sansürsüz modeliniz için kullanmanızı sağlar.

• Kütüphaneyi yükleyin: npm install openai
• baseUrl değerini https://api.mistralapi.com/v1 olarak yapılandırın
• model: "uncensored" belirtin

Bu uyumluluk temperature, top_p ve stop dizileri gibi tüm standart parametreleri kapsar. İstemci yapılandırmasını değiştirerek sağlayıcılar arasında kolayca geçiş yapabilirsiniz.

Akışlı Yanıtlar

Sunucu Tarafından Gönderilen Olaylar (SSE) aracılığıyla akışlı yanıtları destekliyoruz. Bu, tokenlar oluşturuldukça onları almanızı sağlar ve kullanıcılar için algılanan gecikmeyi azaltır. Akışın son parçası faturalandırma için token kullanım istatistiklerini içerir.

• İsteğinizde stream: true ayarlayın
• Yanıttan parçaları okuyun
• Kullanım verileri için son parçayı ayrıştırın

Akış, sohbet arayüzleri ve gerçek zamanlı uygulamalar için idealdir. Yanıt formatı OpenAI akış standardıyla eşleşir, bu nedenle mevcut akış mantığınız değişiklik yapmadan çalışacaktır.

Sınırlar, Hatalar & Bağlam Penceresi

API'miz kararlılığı sağlamak için belirli sınırlara sahiptir. Her API anahtarı dakikada 300 istek ve 8 eşzamanlı isteği destekler. Maksimum istek gövdesi boyutu 8 MB'tır. Bağlam penceresi toplam 100.000 token (istem + tamamlama) şeklindedir. max_tokens ayarlamazsanız, varsayılan çıktı 2.048 token'dır; aksi takdirde maksimum çıktı 32.000 token'dır.

• 401: Geçersiz API anahtarı
• 402: Yetersiz kredi
• 429: Hız limiti aşıldı

Premium kredi süresi dolmaz. Hatalar ve reddetmeler ücretsizdir. Sorunlarla karşılaşırsanız, iade veya hesap yardımı için Destek sayfasını kullanın.

cURL

Kopyalacurl https://api.mistralapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

Kopyalafrom openai import OpenAI

client = OpenAI(base_url="https://api.mistralapi.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)

Node.js

Kopyalaimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.mistralapi.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);

Akış

Kopyalastream = 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)