Panduan Cepat API Mukenetsu AI

Konfigurasi dasar dan URL dasar

Mukenetsu AI dirancang sebagai REST API yang kompatibel dengan OpenAI. Ini memungkinkan Anda menggunakan klien atau SDK OpenAI yang ada dengan sedikit perubahan. Gunakan URL dasar berikut untuk berkomunikasi dengan API.

https://api.mukenetsuapi.com/v1

Tidak perlu memilih endpoint kompleks atau konfigurasi tambahan seperti layanan LLM lainnya. Hanya endpoint penyelesaian chat dan endpoint daftar model yang disediakan. Struktur sederhana ini memungkinkan pengembangan berjalan cepat.

Anda dapat langsung mendapatkan kunci API saat mendaftar di halaman Get API key dengan menggunakan alamat email dan kata sandi. Tidak perlu tindakan di dasbor. Kami mengutamakan privasi, dan data prompt tidak digunakan untuk pelatihan model.

Otentikasi dan kunci API

Akses ke API memerlukan otentikasi melalui header Authorization: Bearer <API_KEY>. Gunakan kunci API yang dibuat saat pembuatan akun. Satu akun dialokasikan satu kunci API, tetapi Anda dapat membuatnya ulang kapan saja. Kunci lama akan tidak berlaku setelah kunci baru dibuat.

Jika terjadi kesalahan otentikasi, respons 401 (Unauthorized) atau 402 (Payment Required) biasanya dikembalikan. 401 menunjukkan kunci salah atau tidak berlaku, sedangkan 402 berarti saldo kredit akun tidak mencukupi. Kredit bersifat prabayar; Anda dapat mengisi saldo mulai dari $10 menggunakan mata uang kripto (USDT, USDC).

Endpoint penyelesaian chat

Endpoint utama untuk pembuatan teks adalah POST /v1/chat/completions. Kirim permintaan ke endpoint ini untuk menghasilkan teks termasuk riwayat percakapan dan prompt sistem. Tentukan ID model sebagai uncensored. Ini adalah model bobot terbuka sendiri yang berbeda dari GPT OpenAI atau model vendor lain.

Contoh di bawah ini menunjukkan cara melakukan pembuatan teks dasar menggunakan curl. Parameter yang diperlukan adalah ID model, pesan, dan opsi untuk mengaktifkan streaming.

コピーcurl https://api.mukenetsuapi.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."}]
  }'

Endpoint ini tidak menyediakan fungsi seperti embedding, pembuatan gambar, atau konversi suara. Endpoint ini khusus untuk penyelesaian dan pembuatan teks murni.

Streaming (SSE)

Jika Anda ingin mendapatkan teks yang dihasilkan secara real-time, Anda dapat menggunakan mode streaming. Dengan menyertakan "stream": true dalam permintaan, server akan mengembalikan data secara bertahap dalam format Server-Sent Events (SSE). Ini memungkinkan pengguna menampilkan sebagian teks sebelum generasi selesai.

Jika Anda menggunakan SDK OpenAI Python atau pustaka klien Node.js, streaming akan diproses secara otomatis hanya dengan menentukan opsi stream=True. Penangan peristiwa akan menerima potongan data per token.

コピーfrom openai import OpenAI

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

Streaming adalah fitur penting untuk meningkatkan pengalaman pengguna dalam respons panjang atau aplikasi interaktif. Namun, jika koneksi terputus saat streaming, peristiwa selanjutnya tidak dapat diterima.

Pemanggilan fungsi/alat

API Mukenetsu AI mendukung pemanggilan fungsi/alat. Ini memudahkan integrasi dengan API eksternal atau basis data. Dengan menyertakan bidang tools dan parameter tool_choice dalam tubuh permintaan, Anda dapat memaksa model menjalankan fungsi tertentu.

Model akan memutuskan apakah akan memanggil fungsi atau mengembalikan teks biasa sesuai kebutuhan. Setelah pemanggilan selesai, Anda dapat memberikan hasil fungsi ke model dengan menambahkannya ke messages untuk mendapatkan jawaban yang lebih rinci.

コピーimport OpenAI from "openai";

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

Fitur ini sangat berguna untuk aplikasi berbasis agen atau otomatisasi tugas kompleks. Karena mengadopsi format kompatibel OpenAI, logika pemanggilan fungsi yang ada dapat digunakan langsung.

Batas laju dan batasan

Penggunaan API memiliki batasan berikut: maksimal 300 permintaan per menit dan ukuran tubuh permintaan maksimal 8 MB. Melebihi batas ini akan mengembalikan kesalahan 429 (Too Many Requests). Jendela konteks adalah 100.000 token (total prompt + teks yang dihasilkan). Percakapan atau dokumen panjang yang melebihi ini harus dibagi dengan tepat sebelum dikirim.

Saat menerima respons streaming, ikuti alur peristiwa berikut.

コピーstream = 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)

Selain itu, konten seksual dengan minor dibatasi secara ketat karena alasan kepatuhan hukum. Konten dewasa lainnya yang legal, fiksi, riset keamanan, dan topik kontroversial dihasilkan tanpa sensor.