MiniMax api: Panduan Memulai dan SDK

Autentikasi dan URL Dasar

Gunakan kunci API yang disediakan dan arahkan klien Anda ke URL dasar yang dit dedicated. Endpoint untuk menghasilkan respons adalah https://api.minimaxaiapi.com/v1/chat/completions. Anda meneruskan kunci di Authorization header sebagai token bearer. Ini berfungsi dengan SDK OpenAI standar mana pun karena kami mengikuti protokol yang sama.

• Nama header: Authorization
• Nilai header: Bearer YOUR_API_KEY
• URL Dasar: https://api.minimaxaiapi.com/v1

Tidak perlu setup rumit. Cukup perbarui konfigurasi di proyek yang ada.

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"}]
  }'

Endpoint Chat Completions

Kirim permintaan POST ke endpoint chat completions untuk mendapatkan respons teks. Pengenal model adalah uncensored. Anda harus menyertakan array pesan dengan riwayat percakapan Anda. Sistem memproses input dan mengembalikan teks yang dihasilkan berdasarkan prompt Anda.

Endpoint ini menangani semua generasi teks. Endpoint ini tidak mendukung embedding, audio, atau video. Anda dapat melakukan streaming respons atau menunggu blok penuh. Model menangani konteks hingga 100.000 token secara total.

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 dan Penggunaan Token

Aktifkan streaming dengan mengatur stream: true dalam permintaan Anda. API mengembalikan Server-Sent Events (SSE) untuk setiap token yang dihasilkan. Ini memungkinkan tampilan output secara real-time. Statistik penggunaan token disertakan di potongan terakhir aliran. Ini membantu Anda melacak biaya dengan akurat tanpa mengurai setiap token individu.

Streaming mengurangi latensi yang dirasakan untuk respons panjang. Ini sangat ideal untuk antarmuka chat dan generasi konten dinamis. Anda dapat menghentikan stream lebih awal jika pengguna mengganggu generasi.

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);

Pemanggilan Fungsi dan Mode JSON

Gunakan tools parameter untuk mengaktifkan pemanggilan fungsi. Tentukan fungsi Anda dalam body permintaan dan biarkan model memilih mana yang akan dipanggil. The tool_choice parameter memungkinkan Anda memaksa fungsi tertentu atau pemilihan otomatis. Untuk output JSON ketat, set response_format ke {"type": "json_object"}Ini memastikan respons adalah JSON yang valid.

Pemanggilan fungsi berguna untuk mengekstrak data terstruktur atau memicu tindakan. Mode JSON sangat cocok untuk integrasi API yang memerlukan format yang dapat diprediksi. Gabungkan keduanya untuk logika aplikasi yang kuat.

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)

Parameter Model dan Batasan

Sesuaikan perilaku generasi menggunakan parameter standar seperti temperature, top_p, dan stop. Jendela konteks maksimum adalah 100.000 token termasuk prompt dan penyelesaian. Output maksimum per permintaan adalah 16.000 token. Jika Anda tidak mengatur max_tokens, batasnya secara default adalah 2.048 token.

Gunakan seed untuk hasil yang dapat direproduksi. Tetapkan presence_penalty dan frequency_penalty untuk mengontrol pengulangan. Parameter ini memberi Anda kontrol halus atas kreativitas dan konsistensi model. Selalu uji dengan kasus penggunaan spesifik Anda untuk menemukan keseimbangan yang tepat.

Batas Laju dan Kesalahan

API membatasi 300 permintaan per menit dan 8 permintaan bersamaan per kunci. Jika Anda melebihi batas ini, Anda akan menerima error 429. Error 401 menunjukkan kunci API tidak valid atau hilang. Error 402 berarti kredit prabayar Anda telah habis.

Kesalahan tidak menguras kredit Anda. Anda dapat mencoba ulang permintaan yang gagal tanpa penalti. Ukuran body permintaan dibatasi hingga 8 MB. Kelola konkurensi Anda dengan hati-hati untuk menghindari throttling. Pantau penggunaan Anda melalui bagian akhir dari respons streaming.