API Dokümantasyonu

Kimlik Doğrulama & Base URL

İstemcinizi doğru temel URL'ye yönlendirin. Uyumluluk için standart OpenAI başlıklarını kabul ediyoruz. API anahtarınız, bearer token olarak Authorization başlığında yer alır. Gizli bilgileri kod olarak yazmaktan kaçınmak için bunları ortam değişkenlerinizden doğrudan iletin. Bu kurulum, OpenAI protokolünü destekleyen herhangi bir kütüphane ile çalışır.

İlk İstek

Bağlantıyı ve yanıt kalitesini doğrulamak için basit bir sohbet tamamlama isteği gönderin. Model kimliği "uncensored"dir. Uç nokta, seçimler ve kullanım metrikleri içeren standart JSON döndürür. 401 alırsanız anahtar biçiminizi kontrol edin. 402, yetersiz ön ödemeli bakiye anlamına gelir. Bu hızlı test, entegrasyonunuzun üretim trafiğine hazır olduğunu doğrular.

Copycurl https://api.mistralbaseurl.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List installed python packages with versions"}]
  }'

Python SDK Entegrasyonu

OpenAI Python paketini temel URL'mizi kullanacak şekilde yapılandırın. API anahtarını ve model adını açıkça ayarlayın. Mesajlarınızı rol ve içerik anahtarlarına sahip sözlükler listesi olarak iletin. Yanıt nesnesi, oluşturulan metni choices[0].message.content içinde içerir. Yürütme sırasında ağ veya oran sınırlama hatalarını yakalamak için istisnaları zarifçe yönetin.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.mistralbaseurl.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 SDK Kurulumu

OpenAI istemcisini temel URL'niz ve anahtarınızla başlatın. Kullanıcı ve asistan rolleriyle mesajlar dizisini tanımlayın. uncensored modeliyle chat.completions.create yöntemini çağırın. Yanıt, oluşturulan metni ilk seçenek olarak sağlar. Bu deseni Node uygulamalarınızda hem senkron hem de asenkron çağrılar için kullanın.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.mistralbaseurl.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ış Yanıtları

Akışı etkinleştirmek için stream parametresini true olarak ayarlayın. API, oluşturuldukları gibi veri parçaları gönderir. Her parça, bir arabelleğe ekleyebileceğiniz delta metin içerir. Bu yaklaşım, uzun çıktılar için algılanan gecikmeyi azaltır. Faturalandırmayı doğru şekilde izlemek için son parçada token kullanımını izleyin.

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)

Limitler & Bağlam Penceresi

Hesabınız 100,000 tokenlık bir bağlam penceresi destekler. Maksimum çıktı isteği başına 16,000 tokendır. Dakikada 300 istek gönderebilirsiniz. Aynı anda yalnızca 8 istek çalışır. Gövde boyutu 8 MB'ı aşan istekler başarısız olur. Geri çekme mantığınızı tasarlamak için bu sınırları kullanın. 429 gibi hatalar hız sınırı ihlallerini gösterir. Reddettirmeler kredi tüketmez.