MiniMax api: Hızlı Başlangıç ve SDK Kılavuzu

Kimlik Doğrulama ve Temel URL

Sağlanan API anahtarını kullanın ve istemcinizi özel temel URL'ye yönlendirin. Yanıt oluşturma uç noktası https://api.minimaxaiapi.com/v1/chat/completions. Anahtarı Authorization header'ı bearer token olarak kullanın. Bu, aynı protokolü izlediğimiz için herhangi bir standart OpenAI SDK'sı ile çalışır.

• Başlık adı: Authorization
• Başlık değeri: Bearer YOUR_API_KEY
• Temel URL: https://api.minimaxaiapi.com/v1

Karmaşık kurulum gerekmez. Mevcut projenizdeki yapılandırmayı güncelleyin.

Copycurl https://api.minimaxaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json with keys name and age"}]
  }'

Sohbet Tamamlamaları Uç Noktası

Metin yanıtı almak için sohbet tamamlama uç noktasına bir POST isteği gönderin. Model tanımlayıcısı uncensored. Sohbet geçmişinizi içeren bir messages dizisi dahil etmeniz gerekir. Sistem girdiyi işler ve isteminize dayalı olarak oluşturulan metni döndürür.

Bu uç nokta tüm meti üretimi işler. Embeddingleri, sesi veya videoyu desteklemez. Yanıtları akış olarak alabilir veya tam bloğu bekleyebilirsiniz. Model toplam 100,000 token'a kadar bağlamı işler.

Copyfrom openai import OpenAI

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

Streaming ve Token Kullanımı

Ayarlayarak akışı etkinleştirin stream: true istekinizde. API, oluşturulan her token için Sunucu Tarafından Gönderilen Etkinlikler (SSE) döndürür. Bu, çıktının gerçek zamanlı olarak görüntülenmesini sağlar. Token kullanım istatistikleri, akışın son parçasında dahil edilir. Bu, her bireysel tokenı ayrıştırmaksızın maliyetleri doğru bir şekilde izlemenize yardımcı olur.

Akış, uzun yanıtlar için algılanan gecikmeyi azaltır. Sohbet arayüzleri ve dinamik içerik üretimi için idealdir. Kullanıcı üretim kesintiye uğratırsa akışı erken durdurabilirsiniz.

Copyimport OpenAI from "openai";

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

Fonksiyon Çağırma ve JSON Modu

Şu tools işlev çağırma yeteneğini etkinleştiren parametre. İşlevlerinizi istek gövdesinde tanımlayın ve modelin hangisini çağıracağını seçmesine izin verin. Ş tool_choice parametresi belirli bir işlevi zorlamak veya otomatik seçmek için kullanılır. Sıkı JSON çıktısı için response_format için {"type": "json_object"}. Bu, yanıtın geçerli JSON olmasını sağlar.

Fonksiyon çağırma, yapılandırılmış veri çıkarmak veya eylemleri tetiklemek için kullanışlıdır. JSON modu, öngörülebilir formatlar gerektiren API entegrasyonları için mükemmeldir. Güçlü uygulama mantığı için her ikisini de birleştirin.

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)

Model Parametreleri ve Kısıtlamalar

Standart parametreleri kullanarak üretim davranışını ayarlayın. temperature, top_p, ve stop. Maksimum bağlam penceresi, istem ve tamamlama dahil olmak üzere 100,000 token'dır. Her istek için maksimum çıktı 16,000 token'dır. Belirlemezseniz max_tokens, varsayılan sınır 2.048 token'dır.

Kullan seed ayarlayın presence_penalty ve frequency_penalty tekrarlamayı kontrol etmek için. Bu parametreler, modelin yaratıcılığı ve tutarlılığı üzerinde ince ayarlı kontrol sağlar. Doğru dengeyi bulmak için her zaman belirli kullanım durumunuzla test edin.

Saniye Başına İstek Limitleri ve Hatalar

API, anahtar başına dakikada 300 istek ve 8 eşzamanlı istek sınırı uygular. Bu sınırları aşarsanız 429 hatası alırsınız. 401 hatası geçersiz veya eksik bir API anahtarını gösterir. 402 hatası ön ödemeli kredinizin tükendiğini belirtir.

Hatalar kredinizi tüketmez. Başarısız istekleri ceza ödemeden yeniden deneyebilirsiniz. İstek gövdesi 8 MB ile sınırlıdır. Throttling'den kaçınmak için eşzamanlılığınızı dikkatlice yönetin. Akış yanıtlarının son parçasını kullanarak kullanımınızı izleyin.