Panduan Cepat untuk Pengguna Minicpm

Base URL dan Autentikasi

Untuk menggunakan API ini, Anda memerlukan kunci API dan base URL yang benar. Layanan kami sepenuhnya kompatibel dengan pustaka klien OpenAI standar. Anda tidak perlu menginstal dependensi baru atau mempelajari SDK baru. Cukup arahkan klien Anda yang ada ke endpoint kami.

Buat kunci di halaman Dapatkan kunci API. Anda dapat masuk dengan Google atau menggunakan email dan kata sandi. Kunci ditampilkan segera. Simpan dengan aman. Setiap permintaan harus menyertakan kunci ini dalam header Authorization.

Base URL untuk semua permintaan adalah: https://api.minicpm.cc/v1. URL ini menangani penyelesaian obrolan, daftar model, dan respons streaming. Tidak ada endpoint terpisah untuk embedding atau visi. Ini adalah API teks saja.

Permintaan Pertama

Kirimkan permintaan penyelesaian obrolan standar untuk mulai menghasilkan teks. ID model selalu uncensored. Model ini adalah model bahasa besar bobot terbuka yang disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah. Ini bukan GPT, Claude, atau model vendor lain.

Atur bidang model menjadi uncensored. Berikan pesan Anda dalam format array standar. API mengembalikan respons teks. Anda dapat mengontrol panjang output dengan max_tokens. Jika Anda tidak mengaturnya, output maksimum default adalah 2.048 token.

Integrasi SDK Python

Gunakan pustaka Python OpenAI resmi untuk berinteraksi dengan API. Anda hanya perlu mengonfigurasi base URL dan kunci API. Sisa pustaka berfungsi seperti biasa. Ini termasuk dukungan untuk streaming, pemanggilan fungsi, dan mode JSON.

Instal pustaka dengan pip install openai. Inisialisasi klien dengan base URL dan kunci Anda. Kirim pesan ke endpoint penyelesaian obrolan. Objek respons berisi teks yang dihasilkan, penggunaan token, dan alasan selesai. Anda dapat mengakses bidang-bidang ini secara langsung dalam kode Python Anda.

Integrasi SDK Node.js

SDK Node.js bekerja secara identik dengan versi Python. Instal paketnya dan konfigurasikan base URL. Klien menangani autentikasi dan pemformatan permintaan secara otomatis. Ini memungkinkan Anda mengintegrasikan API ke layanan backend Anda dengan cepat.

Teruskan base URL dan kunci API ke konstruktor klien OpenAI. Gunakan metode chat.completions.create. Struktur respons sesuai dengan standar OpenAI. Anda dapat menangani kesalahan, memeriksa penggunaan token, dan memproses konten. Pendekatan ini memastikan kompatibilitas dengan basis kode yang sudah ada yang sudah menggunakan OpenAI.

Respons Streaming

Aktifkan streaming dengan mengatur stream: true dalam permintaan Anda. API mengembalikan serangkaian Server-Sent Events (SSE). Setiap peristiwa berisi chunk respons. Ini memungkinkan Anda menampilkan teks kepada pengguna saat teks tersebut dihasilkan.

Chunk terakhir mencakup statistik penggunaan token. Ini berguna untuk melacak biaya. Streaming mengurangi latensi yang dirasakan bagi pengguna. Ini disarankan untuk antarmuka obrolan. Anda dapat mengurai peristiwa dalam kode klien Anda untuk membangun respons akhir atau menampilkan token secara real-time.

Batas, Kesalahan, dan Konteks

Model ini mendukung jendela konteks 100.000 token. Ini mencakup prompt dan kelengkapan. Output maksimum per permintaan adalah 32.000 token. Anda dapat menyesuaikan parameter max_tokens untuk mengontrol ini.

Batas laju ditetapkan pada 300 permintaan per menit per kunci. Anda dapat memiliki 8 permintaan paralel. Badan permintaan harus di bawah 8 MB. Jika kunci tidak valid, Anda akan menerima kesalahan 401. Jika Anda tidak memiliki saldo, Anda akan menerima kesalahan 402. Jika Anda melebihi batas laju, Anda akan menerima kesalahan 429. Kesalahan dan penolakan tidak mengonsumsi saldo.

cURL

Copycurl https://api.minicpm.cc/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.minicpm.cc/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.minicpm.cc/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)

2026-050