MiniMax API: İlk istek beş dakikada

OpenAI SDK'sını yükleyin

Tercih ettiğiniz dil için resmi OpenAI SDK'sını yükleyerek başlayın. Kütüphane istek biçimlendirmesini ve akışı otomatik olarak yönetir. Python 3.8+ veya Node.js 18+'ın yüklü olduğundan emin olun. Python için pip install openai veya Node için npm install openai çalıştırın. SDK, /v1/chat/completions uç noktasıyla etkileşimi kolaylaştırır. Başlıkları, yeniden denemeleri ve SSE ayrıştırmayı yönetir, böylece isteme odaklanabilirsiniz. Bu, API'nin OpenAI sohbet tamamlama standardını izlemesinden kaynaklanır. Özel bir istemci kitaplığına ihtiyacınız yoktur. Standart SDK yöntemleri uç noktalarımıza doğrudan eşleşir. Bu, entegrasyon süresini azaltır ve mevcut geliştirici bilgisinden yararlanır.

Temel URL'nizi ve Anahtarınızı Yapılandırın

API anahtarınızı ve temel URL'yi ortam değişkenlerinizde ayarlayın. Temel URL'miz https://api.minimaxapikey.com/v1 şeklindedir. Bu, standart OpenAI istemcilerini değişiklik yapmadan kullanmanızı sağlar. Anahtar oluşturmak için bir hesap oluşturun. Anahtar, kayıttan hemen sonra gösterilir. Deneme için kart gerekmez. Anahtarı güvenli bir şekilde saklayın. Başlık veya ortam değişkeni olarak iletin. SDK varsayılan olarak OPENAI_API_KEY kullanır. Temel URL'yi sunucularımıza işaret edecek şekilde geçersiz kılabilirsiniz. Bu, tüm isteklerin sansürsüz modele gitmesini sağlar. Anahtarınızın çalıştığını basit bir ping ile doğrulayın. Bu adım, sonraki kimlik doğrulama hatalarını önler.

Temel Sohbet Tamamlama Gönderin

Metin üretmek için ilk isteğinizi gönderin. POST yöntemini /v1/chat/completions üzerinde kullanın. Modeli uncensored olarak belirtin. Kullanıcı istemi içeren bir mesaj dizisi gönderin. API, tamamlama token'ını döndürür. Bu temel metin üretme özelliğidir. 100k bağlam penceresini destekler. Uzun istemler veya konuşma geçmişi gönderebilirsiniz. Yanıt, oluşturulan metni ve token kullanımını içerir. Yaratıcı yazım veya sınırsız diyalog için idealdir. İçeriğin yasal olduğundan emin olun. Model yetişkin konularını reddetmez. Yalnızca reşit olmayanlarla ilgili cinsel içerikleri engeller. Bağlantıyı doğrulamak için basit başlayın.

Akışı Etkinleştirin (SSE)

Gerçek zamanlı çıktı için akışı etkinleştirin. stream parametresini true olarak ayarlayın. API Server-Sent Events (SSE) döndürür. Her parça yanıtın bir bölümünü içerir. Bu algılanan gecikmeyi azaltır. Kullanıcılar metin oluşturulurken görünmesini görür. SDK parça ayrışmasını otomatik olarak yönetir. Metni bir arayüzde kademeli olarak görüntüleyebilirsiniz. Bu sohbet arayüzleri için kritiktir. Akış tüm model yanıtlarıyla çalışır. Token sayımını etkilemez. Her parça sonunda kullanım verisi içerir. Daha iyi kullanıcı deneyimi için bunu kullanın. Tam yanıtı beklemekten daha duyarlı hissettirir. İstemcinizi parçaları doğru şekilde arabelleğe ayarlayın.

Araç/Fonksiyon Çağrısını Kullanın

Fonksiyon çağırma ile yapılandırılmış çıktılar destekleyin. Araçları istek gövdesinde tanımlayın. Model, isteme göre fonksiyonları çağırabilir. Bu, harici sistemlerle entegrasyonu sağlar. Araç tanımlamalarını ve kullanıcı mesajlarını iletin. Yanıt, bir araç çağırma nesnesi içerir. Fonksiyonu yürütün ve sonuçları geri besleyin. Bu, standart OpenAI SDK'larıyla çalışır. Karmaşık iş akışlarına olanak tanır. Aracı veya asistan oluşturabilirsiniz. Model, çağrılar arasında bağlamı korur. Bu, otomasyon için güçlüdür. Araç tanımlamalarınızın kesin olduğundan emin olun. API, araç çıktılarının yönlendirilmesini yönetir. Konuşmayı tutarlı tutar. Dinamik içerik üretimi için bunu kullanın.

Mevcut Modelleri Kontrol Edin

Model listesini GET /v1/models ile doğrulayın. Bu uç nokta mevcut modelleri döndürür. API'miz bir model sunar: uncensored. Bu açık ağırlıklı bir modeldir. GPT, Claude veya Gemini değildir. Yanıt model kimliğini belirtir. İstemci yapılandırmalarını hata ayıklamak için kullanın. Kodunuzun doğru modele hedeflediğinden emin olun. Uç nokta hızlı ve güvenilirdir. JSON verisi döndürür. Bu veriyi arayüz gösterimleri için ayrıştırabilirsiniz. Bu, API anahtarınızın geçerli olduğunu doğrular. Otomatik sağlık kontrolleri için kullanın. Standart OpenAI spec'ının bir parçasıdır. Ek yapılandırma gerekmez. Bu, mevcut araçlarla uyumluluğu sağlar.

cURL

Copycurl https://api.minimaxapikey.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

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

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)