API MiniMax: Permintaan pertama dalam lima menit

Instal SDK OpenAI

Mulailah dengan menginstal SDK OpenAI resmi untuk bahasa pilihan Anda. Perpustakaan menangani pemformatan permintaan dan streaming secara otomatis. Pastikan Anda memiliki Python 3.8+ atau Node.js 18+ yang terinstal. Jalankan pip install openai untuk Python atau npm install openai untuk Node. SDK menyederhanakan interaksi dengan endpoint /v1/chat/completions. Ini mengelola header, percobaan ulang, dan parsing SSE sehingga Anda dapat fokus pada prompt. Ini berfungsi karena API kami mengikuti standar penyelesaian chat OpenAI. Anda tidak memerlukan pustaka klien khusus. Metode SDK standar dipetakan langsung ke endpoint kami. Ini mengurangi waktu integrasi dan memanfaatkan pengetahuan pengembang yang ada.

Konfigurasikan URL Dasar & Kunci Anda

Atur kunci API dan URL dasar Anda dalam variabel lingkungan. URL dasar kami adalah https://api.minimaxapikey.com/v1. Ini memungkinkan Anda menggunakan klien OpenAI standar tanpa modifikasi. Buat akun untuk menghasilkan kunci Anda. Kunci ditampilkan segera setelah pendaftaran. Tidak perlu kartu untuk uji coba. Simpan kunci dengan aman. Berikan sebagai header atau variabel lingkungan. SDK menggunakan OPENAI_API_KEY secara default. Anda dapat mengabaikan URL dasar untuk menunjuk ke server kami. Ini memastikan semua permintaan dikirim ke model tanpa sensor. Verifikasi kunci Anda berfungsi dengan ping sederhana. Langkah ini mencegah kesalahan autentikasi nanti.

Kirim Penyelesaian Chat Dasar

Buat permintaan pertama Anda untuk menghasilkan teks. Gunakan metode POST pada /v1/chat/completions. Tentukan model sebagai uncensored. Berikan array pesan dengan prompt pengguna. API mengembalikan token penyelesaian. Ini adalah fitur generasi teks inti. Ini mendukung jendela konteks 100k. Anda dapat mengirim prompt panjang atau riwayat percakapan. Respons mencakup teks yang dihasilkan dan penggunaan token. Ini ideal untuk penulisan kreatif atau dialog tanpa batasan. Pastikan konten tersebut hukum. Model tidak menolak topik dewasa. Model hanya memblokir konten seksual yang melibatkan anak di bawah umur. Mulailah dengan sederhana untuk memverifikasi konektivitas.

Aktifkan Streaming (SSE)

Untuk output waktu nyata, aktifkan streaming. Atur parameter stream menjadi true. API mengembalikan Server-Sent Events (SSE). Setiap bagian berisi sebagian dari respons. Ini mengurangi latensi yang dirasakan. Pengguna melihat teks muncul saat dihasilkan. SDK menangani parsing bagian secara otomatis. Anda dapat menampilkan teks secara bertahap di UI. Ini sangat penting untuk antarmuka obrolan. Streaming berfungsi dengan semua respons model. Ini tidak memengaruhi penghitungan token. Setiap bagian menyertakan data penggunaan di akhir. Gunakan ini untuk pengalaman pengguna yang lebih baik. Terasa lebih responsif daripada menunggu respons penuh. Konfigurasikan klien Anda untuk menampung bagian dengan benar.

Gunakan Pemanggilan Alat/Fungsi

Dukung output terstruktur dengan pemanggilan fungsi. Tentukan alat dalam badan permintaan. Model dapat memanggil fungsi berdasarkan prompt. Ini memungkinkan integrasi dengan sistem eksternal. Lewatkan definisi alat dan pesan pengguna. Respons mencakup objek panggilan alat. Eksekusi fungsi dan kirimkan hasilnya kembali. Ini berfungsi dengan SDK OpenAI standar. Ini memungkinkan alur kerja kompleks. Anda dapat membangun agen atau asisten. Model mempertahankan konteks di seluruh panggilan. Ini sangat kuat untuk otomatisasi. Pastikan definisi alat Anda tepat. API menangani pengalihan output alat. Ini menjaga koherensi percakapan. Gunakan ini untuk generasi konten dinamis.

Periksa Model yang Tersedia

Verifikasi daftar model melalui GET /v1/models. Endpoint ini mengembalikan model yang tersedia. API kami melayani satu model: uncensored. Ini adalah model bobot terbuka. Ini bukan GPT, Claude, atau Gemini. Respons mengonfirmasi ID model. Gunakan ini untuk mendiagnosis konfigurasi klien. Pastikan kode Anda menargetkan model yang benar. Endpoint ini cepat dan andal. Ini mengembalikan data JSON. Anda dapat menguraikannya untuk tampilan UI. Ini mengonfirmasi kunci API Anda valid. Gunakan ini untuk pemeriksaan kesehatan otomatis. Ini adalah bagian dari spesifikasi OpenAI standar. Tidak perlu konfigurasi tambahan. Ini memastikan kompatibilitas dengan alat yang ada.

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

Streaming

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)