ID ▾

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

Enam langkah bercahaya yang mengarah dari kunci ke rak server, mewakili jalur pengaturan API

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

  1. Buka halaman kunci. Buka halaman kunci API dan daftar. Anda dapat menggunakan Google, atau alamat email dan kata sandi.
  2. 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_tokens opsional, tetapi batas adalah pengaman murah. Tanpanya, satu jawaban mungkin menggunakan sisa jendela 100.000 token.
  • Streaming untuk penggunaan interaktif. Atur stream: true jika 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

GejalaPenyebab yang mungkinPerbaikan
401 pada setiap panggilanKunci hilang, salah ketik, atau dicabutKirim Authorization: Bearer <key>, tanpa tanda kutip tambahan
Respons 404 atau HTMLJalur salah, biasanya /v1 hilangGunakan base URL lengkap yang berakhir dengan /v1
Model tidak ditemukanNama model yang disalin dari penyedia lainGunakan uncensored
429 dengan rate_limitedMelebihi batas permintaan per menitPerlambat, atau isi saldo untuk berpindah dari batas uji coba ke batas penuh
429 dengan concurrencyTerlalu banyak permintaan sekaligusBatasi panggilan paralel hingga 8 (2 pada kunci uji coba)
429 dengan Retry-After: 5Beban berlebih sementaraTunggu 5 detik dan coba ulang
413 atau isi permintaan ditolakPermintaan melebihi 8 MBPotong 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.

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.

Dapatkan kunci API