Mistral API dokümantasyonu: Hızlı Başlangıç Kılavuzu

SDK'yı yükleyin ve temel URL'nizi ayarlayın

Diliniz için resmi SDK'yı yükleyin ve uç noktamızı işaretleyin. Base URL HTTPS://api.mistralapidoc.com/v1'dir. Bu tek değişiklik, mevcut mantığınızı bozmadan tüm çağrıları sansürsüz altyapımıza yönlendirir. OpenAI uyumluluğunu destekleyen herhangi bir standart istemci kullanabilirsiniz. Kurulum birkaç saniye sürer ve karmaşık yapılandırma dosyaları gerektirmez.

Benzersiz API anahtarınızı Authorization başlığında iletin. Sistemimiz, herhangi bir token işlemeden önce bu anahtarı ön ödemeli bakiyenizle doğrular. Bu yaklaşım, yalnızca kullandığınız şey için ödeme yapmanızı sağlar. Anahtarınızı güvende tutun ve sızma şüphesi varsa değiştirin. Anahtar, Google veya e-posta ile kaydolma sırasında hemen verilir.

uncensored model'e ilk isteğinizi yapın

"uncensored" olarak ayarlanmış model kimliği ile /v1/chat/completions adresine POST isteği gönderin. Bu model, standart reddetmeler olmadan yasal yetişkin içeriği, kurgu ve tartışmalı konulara yanıt verir. Doğrudan yanıtlar için ayarlanmış açık ağırlıklı bir modeldir. Farklı satıcılar arasında sürüm numarası belirtmenize veya rota belirlemenize gerek yoktur. Yanıt, content alanında metin olarak döner.

Copycurl https://api.mistralapidoc.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List all available models and their context windows"}]
  }'

İstek gövdesi mesaj dizinizi ve isteğe bağlı parametreleri içerir. APImiz fazladan alanları zarifçe yok sayar. Basit bir prompt gönderirseniz doğrudan bir tamamlama alırsınız. Karmaşık mantık eklemeden önce entegrasyonunuzun çalıştığını doğrulamak için bunu kullanın. Model, 100,000 tokena kadar olan bağlamı verimli bir şekilde işler.

Akışı etkinleştirin ve token kullanımını yönetin

Token'ları Server-Sent Events aracılığıyla almak için stream değerini true olarak ayarlayın. Bu yöntem, uzun yanıtlar için algılanan gecikmeyi azaltır. Akıştaki son chunk, o istek için tam token kullanım istatistiklerini içerir. Ön ödemeli kredi tüketiminizi doğru takip etmek için bu metrikleri günlüğe kaydedebilirsiniz. Streaming, sohbet arayüzleri ve gerçek zamanlı uygulamalar için idealdir.

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)

İçerik delta'yı biriktirerek kısmi yanıtları yönetin. API'miz toplam token sayısının gerçek kullanımla eşleşmesini sağlar. Akış sırasında oluşan hatalar, tamamlanmamış tokenlar için ücretlendirme yapmaz. Bu özellik, maliyetleri şeffaf tutarken sorunsuz bir kullanıcı deneyimi sunar. Kullanıcı oluşturmayı keserse akışı erken durdurabilirsiniz.

Fonksiyon çağrısını ve JSON modunu kullanın

İşlev çağrısını etkinleştirmek için bir tools dizisi iletin. Model uygun olduğunda yapılandırılmış araç çağrıları üretecektir. Ayrıca response_format'ı json_object olarak ayarlayarak JSON modunu zorlayabilirsiniz. Bu, çıktının geçerli JSON olduğunu garanti eder ve uygulamada ayrıştırmayı basitleştirir. Her iki özellik de standart OpenAI SDK sözdizimi ile çalışır.

Copyimport OpenAI from "openai";

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

İşlev şemanızı ad, açıklama ve parametrelerle tanımlayın. API, yanıtta işlev adını ve argümanları döndürür. Bu, kodunuzun modelin kararına dayalı olarak dış mantığı çalıştırmasını sağlar. JSON modu, sıkı veri yapılarına ihtiyaç duyduğunuzda kullanışlıdır. Bu özellikleri sağlam, otomatik iş akışları için birleştirin.

Parametreleri yapılandırın: sıcaklık, top_p ve seed

Rastgeleliği kontrol etmek için sıcaklığı ayarlayın. Daha düşük değerler yanıtları daha belirgin hale getirir. Top_p, çekirdek örnekleme en olası tokenlara sınırlar. Seed, hata ayıklama için tekrarlanabilir çıktılar sağlar. Bu parametreler, modelin davranışı üzerinde ince ayar yapmanızı sağlar. Yaratıcılık ile doğruluk arasındaki dengeyi ayarlamak için kullanın.

Copyfrom openai import OpenAI

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

Tekrarı azaltmak için presence_penalty ve frequency_penalty değerlerini ayarlayın. Model tüm standart OpenAI parametrelerini destekler. Üretimi belirli işaretlerde durdurmak için bir stop dizisi iletebilirsiniz. Bu kontroller, ihtiyacınız olan tam çıkış formatını elde etmenize yardımcı olur. Kullanım durumunuz için en uygun ayarları bulmak için farklı kombinasyonlarla deney yapın.

Limitler, hatalar ve bağlam penceresi

API'miz 100.000 tokenlık bir bağlam penceresi destekler. İstek başına maksimum çıktı 16.000 token'dır veya max_tokens belirtilmezse 2.048 token'dır. Dakikada 300 istek ve anahtar başına 8 eşzamanlı istekle sınırlısınız. İstek gövdesi 8 MB'ın altında kalmalıdır. Bu limitler, tüm ön ödemeli müşteriler için adil kullanım sağlar.

API anahtarınızı doğrulayarak HTTP 401 hatalarını yönetin. 402 hatası, yetersiz ön ödemeli krediyi gösterir. Hizmeti devam ettirmek için kripto ile kredi yükleyin. 429 hatası, hız sınırını aştığınızı gösterir. Yeniden denemeden önce kısa bir süre bekleyin. Sistemimiz eğitim için istemleri kullanmaz, veri gizliliğinizi korur. Hatalar ve reddetmeler ücretsizdir, bu nedenle yalnızca başarılı tamamlamalar için ödeme yaparsınız.