Pengaturan API MiniMax: Kunci, Base URL, dan Permintaan Pertama
Ini adalah pengaturan langkah demi langkah untuk API kompatibel OpenAI di minimaxapikey.com: akun, kunci, base URL, permintaan pertama. Ini adalah layanan independen, bukan API resmi dari vendor model mana pun.
Diperbarui

Poin utama
- Daftar dengan Google atau email, lalu klaim $0,50 kredit uji coba di halaman kunci. Tidak diperlukan kartu.
- Base URL adalah https://api.minimaxapikey.com/v1, ID model adalah uncensored, autentikasi adalah kunci Bearer.
- Dua metode yang ada: POST /v1/chat/completions dan GET /v1/models.
- 401 berarti kunci salah, dan 429 berarti batas telah terpenuhi, jadi periksa kode kesalahan di dalam badan respons.
Yang sedang Anda siapkan
Orang mencari pengaturan api minimax dengan mengharapkan salah satu dari dua hal: platform pengembang MiniMax resmi, atau endpoint bergaya OpenAI. Halaman ini membahas yang kedua. Layanan di balik minimaxapikey.com adalah API teks kompatibel OpenAI yang di-host yang menjalankan satu model bobot terbuka, dioperasikan oleh penyedia independen. Ini bukan API resmi dari MiniMax atau vendor model lain, dan tidak merutekan permintaan antar vendor. Jika Anda memerlukan platform vendor sendiri, gunakan situs mereka.
Yang Anda dapatkan sederhana. SDK atau klien OpenAI apa pun berfungsi begitu Anda mengubah base URL dan kunci. Ada dua metode, POST /v1/chat/completions dan GET /v1/models, satu ID model, uncensored, dan jendela konteks 100.000 token yang dibagi oleh prompt dan output. Ini hanya menangani teks, jadi tidak ada pembuatan gambar, audio atau video, tidak ada embedding dan tidak ada fine-tuning. Streaming, pemanggilan fungsi dan mode JSON didukung.
Seluruh pengaturan memakan waktu beberapa menit. Langkah-langkah di bawah ini berurutan, dan setiap langkah diakhiri dengan pemeriksaan sehingga Anda tahu itu berhasil sebelum melanjutkan.
Langkah 1 dan 2: buat akun dan klaim uji coba
- Buka halaman kunci. Buka halaman kunci API dan daftar. Anda dapat menggunakan Google, atau alamat email dan kata sandi.
- Klaim kredit uji coba. Setelah masuk, halaman kunci memiliki tombol untuk $0,50 kredit uji coba. Ini satu klik, tidak perlu kartu, berlaku selama 7 hari, dan dibatasi satu per orang.
Uji coba sengaja dibuat kecil. Pada $0.15 per 1 juta token input dan $0,50 per 1 juta token output, $0,50 mencakup sejumlah permintaan pengujian yang baik. Prompt dengan 1.000 token dengan jawaban 500 token biaya $0,00015 untuk input ditambah $0,00025 untuk output, yang merupakan $0,0004. Membagi $0,50 dengan itu memberikan 1.250 permintaan seperti itu, jadi Anda memiliki banyak ruang untuk bereksperimen.
Perhatikan batas kunci uji coba: 2 permintaan paralel dan 60 permintaan per menit. Kunci penuh, yang Anda dapatkan setelah mengisi saldo, memungkinkan 8 permintaan paralel dan 300 per menit. Jika loop pengujian Anda berjalan secara paralel dan Anda melihat kesalahan 429, ini adalah hal pertama yang harus diperiksa.
Langkah 3: buat kunci dan simpan dengan aman
Di halaman yang sama, buat kunci API dan salin. Perlakukan seperti kata sandi. Masukkan ke dalam variabel lingkungan atau manajer rahasia, jangan pernah di repositori, bundel front-end, atau tangkapan layar. Jika kunci bocor, hapus dan buat yang baru.
# macOS / Linux
export UNCENSORED_KEY="paste-your-key-here"
# Windows PowerShell
$env:UNCENSORED_KEY = "paste-your-key-here"
Kode sisi server harus membaca variabel saat runtime. Kode browser tidak boleh memegang kunci sama sekali: kirim permintaan dari backend Anda, karena apa pun yang dikirim ke browser terlihat oleh setiap pengunjung.
Langkah 4: daftar model untuk mengonfirmasi kunci
Pengujian termurah adalah endpoint model. Ini tidak menghasilkan teks, sehingga ini adalah pemeriksaan bersih untuk kunci API, URL dan jaringan Anda.
curl -s https://api.minimaxapikey.com/v1/models \
-H "Authorization: Bearer $UNCENSORED_KEY"
Anda harus mendapatkan daftar JSON yang mencakup uncensored. Jika Anda mendapatkan 401, kunci salah atau memiliki spasi atau tanda kutip berlebih di sekitarnya. Jika koneksi gagal, periksa apakah URL berakhir dengan /v1 dan bahwa Anda menggunakan https.
Langkah 5: kirim permintaan chat pertama
Sekarang completion nyata. Body-nya berformat chat completions standar.
curl -s https://api.minimaxapikey.com/v1/chat/completions \
-H "Authorization: Bearer $UNCENSORED_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "user", "content": "Explain what an API key is in two sentences."}
],
"temperature": 0.7
}'
Balasan berisi choices[0].message.content dan blok usage dengan jumlah token prompt dan completion. Lihat juga header respons, dengan curl -i. Anda akan melihat X-Request-Id, yang dapat digunakan dukungan untuk menemukan permintaan Anda, X-Balance-USD, sisa kredit Anda, dan header batas laju X-RateLimit-Limit-Requests dan X-RateLimit-Limit-Concurrency.
Parameter seperti temperature, top_p, stop, seed dan penalti diteruskan. max_tokens opsional. Jika Anda meninggalkannya, completion dapat menggunakan sisa jendela.
Langkah 6: panggilan yang sama dari SDK
Setelah curl berfungsi, beralih ke bahasa yang akan Anda gunakan. Hanya dua argumen yang berubah dari pengaturan OpenAI standar.
from openai import OpenAI
import os
client = OpenAI(
base_url="https://api.minimaxapikey.com/v1",
api_key=os.environ["UNCENSORED_KEY"],
)
reply = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Give me three names for a hiking app."}],
)
print(reply.choices[0].message.content)
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.minimaxapikey.com/v1",
apiKey: process.env.UNCENSORED_KEY,
});
const reply = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Give me three names for a hiking app." }],
});
console.log(reply.choices[0].message.content);
Untuk streaming, tambahkan stream: true dan baca server-sent events. Angka penggunaan tiba di akhir stream. Halaman dokumentasi mencakup streaming, pemanggilan fungsi dan mode JSON dengan response_format: {"type":"json_object"}.
Memindahkan proyek OpenAI yang ada
Sebagian besar waktu proyek yang ingin Anda sambungkan sudah berfungsi dengan pustaka klien OpenAI. Dalam hal itu, Anda jarang mengedit kode. SDK resmi membaca variabel lingkungan OPENAI_API_KEY dan OPENAI_BASE_URL ketika Anda tidak meneruskan argumen, jadi perubahan deployment bisa saja cukup.
export OPENAI_BASE_URL="https://api.minimaxapikey.com/v1"
export OPENAI_API_KEY="paste-your-key-here"
# then in your code, request model "uncensored"
Satu-satunya edit yang tersisa adalah nama model. String seperti ID model OpenAI tidak akan ada di sini, jadi ganti dengan uncensored, idealnya melalui nilai konfigurasi agar Anda dapat kembali. Kemudian baca kode untuk fitur yang tidak ditawarkan layanan. Pembuatan gambar, audio, embedding dan fine-tuning tidak tersedia, karena ini adalah API chat hanya teks. Jika aplikasi Anda memanggil embedding untuk pencarian, Anda memerlukan penyedia lain untuk bagian itu dan dapat tetap menggunakan chat di sini.
Ini juga membantu untuk mengetahui model apa yang digunakan. Ini adalah model bobot terbuka tunggal, yang disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah, dan satu batas keras berlaku terlepas dari pengaturan: tidak ada konten seksual yang melibatkan anak di bawah umur. Prompt yang ditulis untuk model lain mungkin memerlukan penyesuaian kecil, karena setiap model bereaksi berbeda terhadap prompt sistem yang sama. Jalankan prompt pengujian Anda sendiri secara berdampingan sebelum Anda mengalihkan lalu lintas nyata.
Pengaturan yang layak dipilih pada hari pertama
Beberapa keputusan lebih mudah dibuat saat pengaturan daripada setelah peluncuran. Tidak ada yang sulit, tetapi setiap satu menghindari kejutan nanti.
- Prompt sistem. Masukkan instruksi Anda tentang nada, format, dan peran dalam pesan
system. Buat singkat dan spesifik, karena setiap permintaan mengulangnya sebagai token input. - Batas token.
max_tokensopsional, tetapi batas adalah pengaman murah. Tanpanya, satu jawaban mungkin menggunakan sisa jendela 100.000 token. - Streaming untuk penggunaan interaktif. Atur
stream: truejika seseorang menunggu balasan. Untuk pekerjaan batch, permintaan biasa lebih sederhana. - Aturan coba ulang untuk 429. Anggap 429 sebagai sinyal untuk menunggu, bukan sebagai kegagalan. Ketika respons menyertakan
Retry-After: 5, menunggu selama itu dan mencoba ulang adalah langkah yang tepat. - Ukuran permintaan. Batas isi permintaan adalah 8 MB. Itu jauh lebih banyak daripada yang dibutuhkan prompt normal, tetapi log atau dokumen yang disalin dapat mencapainya.
Prompt tidak digunakan untuk pelatihan, yang penting jika Anda berencana untuk mengirim dokumen internal atau pesan pengguna. Anda tetap bertanggung jawab atas apa yang Anda kirim, jadi hindari memasukkan rahasia yang tidak perlu model ke dalam prompt.
Mengisi saldo setelah uji coba
Uji coba ini untuk memeriksa bahwa semuanya berfungsi. Ketika Anda siap untuk membangun, tambahkan saldo prabayar. Tidak ada langganan: Anda membayar untuk token yang digunakan, pada $0,15 per 1M token input dan $0,50 per 1M token output, dan saldo prabayar tidak pernah kadaluarsa, sehingga saldo yang tidak terpakai tidak hilang di akhir bulan.
Setiap jumlah bulat dari $20 hingga $500 berfungsi. Top-up $50 menambahkan bonus 5%, $100 menambahkan 10%, dan $200 menambahkan 15%. Sebagai contoh cepat, top-up $100 dengan bonus 10% memberikan kredit $110. Pada prompt 1.000 token dan jawaban 500 token dari langkah dua, setiap permintaan biaya $0,0004, sehingga $110 mencakup 275.000 permintaan. Prompt nyata biasanya lebih panjang, jadi skalakan angka itu ke rata-rata Anda sendiri.
Memperbaiki kesalahan pengaturan umum
| Gejala | Penyebab yang mungkin | Perbaikan |
|---|---|---|
| 401 pada setiap panggilan | Kunci hilang, salah ketik, atau dicabut | Kirim Authorization: Bearer <key>, tanpa tanda kutip tambahan |
| Respons 404 atau HTML | Jalur salah, biasanya /v1 hilang | Gunakan base URL lengkap yang berakhir dengan /v1 |
| Model tidak ditemukan | Nama model yang disalin dari penyedia lain | Gunakan uncensored |
429 dengan rate_limited | Melebihi batas permintaan per menit | Perlambat, atau isi saldo untuk berpindah dari batas uji coba ke batas penuh |
429 dengan concurrency | Terlalu banyak permintaan sekaligus | Batasi panggilan paralel hingga 8 (2 pada kunci uji coba) |
429 dengan Retry-After: 5 | Beban berlebih sementara | Tunggu 5 detik dan coba ulang |
| 413 atau isi permintaan ditolak | Permintaan melebihi 8 MB | Potong prompt atau bagi tugas |
Saat Anda siap untuk menggunakan lebih dari kredit uji coba, halaman harga mencantumkan opsi isi saldo: jumlah bulat dari $20 hingga $500, dibayar dengan kripto (USDT pada TRC20, USDC pada Base), dengan bonus 5% dari $50, 10% dari $100, dan 15% dari $200. Permintaan yang gagal atau ditolak tidak dikenakan biaya, dan prompt tidak digunakan untuk pelatihan.
Panduan lainnya
Tanya jawab
Apakah ini API MiniMax resmi?
Tidak. Ini adalah API yang kompatibel dengan OpenAI, di-host secara independen, yang melayani satu model bobot terbuka, yang disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah. Ini bukan API resmi dari vendor model mana pun dan bukan router lintas vendor.
Apakah saya perlu kartu kredit untuk mencobanya?
Tidak. Setelah masuk, Anda dapat mengklaim kredit uji coba senilai $0,50 dengan satu klik di halaman kunci API. Kredit ini berlaku selama 7 hari dan terbatas satu per orang.
Apa nama model yang harus digunakan dalam permintaan?
Gunakan uncensored. Layanan ini mengekspos ID model tunggal ini, dan GET /v1/models akan menampilkannya.
Bagaimana cara menambahkan kredit lebih lanjut nanti?
Isi saldo dengan jumlah bulat apa pun dari $20 hingga $500. Bonus berlaku dari $50 (+5%), $100 (+10%) dan $200 (+15%), dan saldo prabayar tidak pernah kadaluarsa.
Bisakah saya menggunakan SDK OpenAI?
Ya. Atur base_url ke https://api.minimaxapikey.com/v1, gunakan kunci API Anda, dan kirim model uncensored. Tidak ada lagi di kode Anda yang harus diubah.
Kunci Anda hanya selangkah lagi dari satu formulir
Buat akun, salin kunci, ubah URL dasar. Itu saja seluruh proses pengaturannya.