Memulai: Hubungkan klien Anda

Prasyarat dan Instalasi SDK

Instal SDK resmi untuk bahasa pemrograman Anda agar otentikasi dan serialisasi permintaan ditangani secara otomatis. Anda memerlukan kunci API yang valid dan URL dasar yang dikonfigurasi di lingkungan klien Anda. Layanan kami menerima parameter standar seperti temperature dan top_p tanpa memerlukan header kustom.

Pastikan variabel lingkungan Anda menyimpan token Anda dengan aman sebelum menjalankan skrip apa pun. Versi SDK harus terkini untuk mendukung fitur streaming dan mode JSON dengan benar. Tidak diperlukan driver tambahan untuk generasi teks saja.

Mengkonfigurasi URL Dasar dan Kunci

Arahkan klien Anda ke URL dasar khusus kami untuk mengarahkan permintaan melalui infrastruktur tanpa sensor kami. Gunakan header Authorization: Bearer YOUR_KEY untuk mengautentikasi setiap panggilan. Pengaturan ini bekerja sama untuk pengujian lokal atau skrip deployment produksi.

Ganti endpoint OpenAI default dengan host kami untuk menghindari kebingungan dengan penyedia lain. Simpan kunci Anda secara rahasia dan jangan tampilkan di repositori publik. Konfigurasi tetap statis hingga Anda memutarkan kunci Anda.

Mengirim Permintaan Pertama Anda

Eksekusi panggilan penyelesaian chat standar untuk memverifikasi konektivitas dan format respons. Kirim prompt sederhana untuk mengonfirmasi model mengembalikan teks tanpa penolakan. Pengujian ini memastikan kunci Anda memiliki kredit prabayar yang cukup untuk penggunaan.

Copycurl https://api.keyapiminimax.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a JSON object with keys id and name"}]
  }'

Periksa respons untuk detail konten dan penggunaan token. Jika Anda menerima kesalahan 401, verifikasi format kunci Anda. 402 menunjukkan bahwa Anda perlu mengisi ulang saldo kredit Anda.

Menangani Respons Streaming

Aktifkan streaming untuk menerima token secara real-time saat token tersebut dihasilkan. Ini mengurangi latensi yang dirasakan bagi pengguna yang menunggu output panjang. Potongan terakhir berisi hitungan token terakhir untuk akurasi penagihan.

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)

Tangani respons parsial dengan baik dalam kode klien Anda. Wadahkan konten hingga aliran ditutup atau terjadi kesalahan. Streaming berfungsi dengan semua parameter standar termasuk penyesuaian suhu.

Integrasi SDK Python

Gunakan pustaka Python untuk mengelola permintaan dengan kode boilerplate minimal. Inisialisasi klien dengan URL dasar dan kunci Anda untuk penggunaan segera. Pendekatan ini menyederhanakan penanganan kesalahan dan penguraian respons.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.keyapiminimax.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)

Akses konten yang dihasilkan langsung dari objek respons. Periksa kesalahan dan tangani batas laju dengan tepat. SDK mendukung alur kerja sinkron dan asinkron.

SDK Node dan Batasan

Integrasikan dengan aplikasi Node.js menggunakan SDK JavaScript resmi. Tetapkan URL dasar untuk memastikan permintaan mencapai endpoint tanpa sensor kami. Pantau penggunaan Anda untuk tetap berada dalam batas laju.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.keyapiminimax.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);

Anda dapat melakukan 300 permintaan per menit dengan koncurrency 8. Setiap body permintaan harus di bawah 8 MB. Context window mendukung total 100,000 token. Kesalahan dan penolakan tidak mengonsumsi kredit, tetapi output yang berhasil akan. Jaga kunci Anda dengan aman dan rotasikan jika diperlukan.

Memahami Penggunaan Token

Penagihan didasarkan pada token aktual yang digunakan dalam prompt dan completion. Token input berharga $0.15 per juta, sedangkan token output berharga $0.50 per juta. Kredit prabayar mencakup semua penggunaan tanpa biaya bulanan.

Kesalahan dan penolakan gratis, jadi Anda hanya membayar untuk respons yang berhasil. Potongan terakhir dalam aliran (stream) berisi hitungan token. Pantau dasbor Anda untuk melacak pengeluaran dan menghindari kehabisan kredit. Isi ulang dengan USDT atau USDC untuk akses instan.