MiniMax api: Panduan Permulaan Pantas dan SDK

Pengesahan dan URL Asas

Gunakan kunci API yang disediakan dan arahkan klien anda ke URL asas yang didedikasikan. Endpoint untuk menjana respons ialah https://api.minimaxaiapi.com/v1/chat/completions. Anda lulus kunci dalam Authorization header sebagai token bearer. Ini berfungsi dengan mana-mana SDK OpenAI standard kerana kami mengikuti protokol yang sama.

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

Tiada persediaan kompleks diperlukan. Hanya kemas kini konfigurasi dalam projek sedia ada anda.

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

Hujung Sambungan Penyelesaian Sembang

Hantar permintaan POST ke hujung akhir penyelesaian sembang untuk mendapatkan respons teks. Pengenal pasti model ialah uncensored. Anda mesti termasuk larik mesej dengan sejarah perbualan anda. Sistem memproses input dan mengembalikan teks yang dijana berdasarkan prompt anda.

Endpoint ini mengendalikan semua penjanaan teks. Ia tidak menyokong pengekodan semula (embeddings), audio, atau video. Anda boleh menstrim respons atau menunggu blok penuh. Model mengendalikan konteks sehingga 100,000 token secara keseluruhan.

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 aliran dengan menetapkan stream: true dalam permintaan anda. API mengembalikan Acara Dihantar Pelayan (SSE) untuk setiap token yang dijana. Ini membolehkan paparan output secara masa nyata. Statistik penggunaan token termasuk dalam potongan akhir aliran. Ini membantu anda menjejaki kos dengan tepat tanpa menguraikan setiap token individu.

Penstriman mengurangkan latensi yang dirasakan untuk respons panjang. Ia sesuai untuk antara muka sembang dan penjanaan kandungan dinamik. Anda boleh menghentikan aliran awal jika pengguna mengganggu penjanaan.

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

Panggilan Fungsi dan Mod JSON

Gunakan tools parameter untuk membolehkan panggilan fungsi. Takrifkan fungsi anda dalam badan permintaan dan biarkan model memilih mana yang akan dipanggil. The tool_choice parameter memaksa fungsi tertentu atau auto-pilih. Untuk output JSON ketat, set response_format ke {"type": "json_object"}. Ini memastikan respons adalah JSON yang sah.

Pemanggilan fungsi berguna untuk mengekstrak data terstruktur atau mencetuskan tindakan. Mod JSON sangat sesuai untuk integrasi API yang memerlukan format yang boleh diramal. Gabungkan kedua-duanya untuk logik aplikasi yang kukuh.

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 Sekatan

Laraskan tingkah laku penjanaan menggunakan parameter standard seperti temperature, top_p, dan stop. Jendela konteks maksimum ialah 100,000 token termasuk prompt dan penyelesaian. Output maksimum setiap permintaan ialah 16,000 token. Jika anda tidak menetapkan max_tokens, had ini lalai kepada 2,048 token.

Gunakan seed untuk keputusan yang boleh diulang. Tetapkan presence_penalty dan frequency_penalty untuk mengawal pengulangan. Parameter ini memberikan anda kawalan halus terhadap kreativiti dan konsistensi model. Sentiasa uji dengan kesgunaan khusus anda untuk mencari keseimbangan yang betul.

Had had laju dan ralat

API mengenakan had 300 permintaan setiap minit dan 8 permintaan serentak per kunci. Jika anda melebihi had ini, anda akan menerima ralat 429. Ralat 401 menunjukkan kunci API tidak sah atau tiada. Ralat 402 bermaksud kredit prabayar anda telah habis.

Kesilapan tidak menggunakan kredit anda. Anda boleh mencuba semula permintaan yang gagal tanpa penalti. Saiz badan permintaan terhad kepada 8 MB. Urus kekonkurensian anda dengan berhati-hati untuk mengelakkan pengehadan. Pantau penggunaan anda melalui bahagian akhir respons penstriman.