Panduan cepat untuk pengguna Kimicode

Prasyarat

Sebelum menulis kode, buat akun di kimicode.cc menggunakan Google atau email. Anda akan menerima satu kunci API secara instan. Tidak perlu verifikasi telepon dan tidak memerlukan kartu kredit. Akun Anda dimulai dengan $0.50 kredit uji coba yang berlaku selama tujuh hari. Jika Anda membutuhkan kapasitas lebih, isi saldo melalui kripto (USDT di TRC20 atau USDC di Base) mulai dari $10. Saldo prabayar tidak pernah habis, dan kesalahan atau penolakan tidak mengonsumsi token.

Pastikan lingkungan pengembangan Anda memiliki Node.js (v18+) atau Python 3.8+. API ini secara ketat mengikuti spesifikasi klien openai, artinya Anda dapat mengganti endpoint kami tanpa mengubah logika pustaka Anda. Kami melayani satu model tanpa sensor dengan ID uncensored.

Instal SDK

Instal SDK OpenAI resmi untuk bahasa pilihan Anda. Ini memastikan kompatibilitas dengan fitur streaming, pemanggilan fungsi, dan mode JSON kami.

Untuk Python, gunakan pip untuk menginstal pustaka standar:

• pip install openai

Untuk Node.js, instal paket npm:

• npm install openai

Pustaka-pustaka ini menangani pemformatan HTTP secara otomatis. Anda tidak memerlukan klien khusus vendor. API kimicode menerima parameter standar seperti temperature, top_p, dan max_tokens.

Inisialisasi Klien

Konfigurasikan objek klien Anda dengan URL dasar kimicode dan kunci API Anda. URL dasar adalah https://api.kimicode.cc/v1. Atur api_key ke nilai yang Anda terima saat pendaftaran. Konfigurasi ini menggantikan endpoint default api.openai.com.

• URL Dasar: https://api.kimicode.cc/v1
• Model: uncensored
• Otentikasi: Token Bearer melalui api_key

Jangan mencampur kunci ini dengan vendor lain. Kunci ini bekerja secara eksklusif dengan endpoint kimicode. Klien akan memverifikasi kunci pada permintaan pertama. Jika kunci tidak valid, Anda akan menerima kesalahan 401 segera.

Buat Permintaan

Kirimkan permintaan penyelesaian chat standar. ID model haruslah uncensored. Anda dapat menyesuaikan max_tokens hingga 32,000. Jika diabaikan, nilai bawaan adalah 2,048. Jendela konteks adalah 100,000 token total untuk prompt dan penyelesaian gabungan.

• Input: Pesan teks dalam larik messages.
• Output: Respons teks di choices[0].message.content.

Endpoint ini mendukung mode JSON melalui response_format: {"type": "json_object"}. Endpoint ini tidak mendukung embedding, gambar, atau audio. Fokus pada generasi teks berkualitas tinggi tanpa penolakan konten untuk topik dewasa yang sah.

Respons Streaming

Aktifkan streaming dengan mengatur stream: true. API mengembalikan Server-Sent Events (SSE). Setiap potongan berisi teks parsial. Statistik penggunaan token disertakan dalam potongan terakhir aliran. Ini memungkinkan tampilan waktu nyata tanpa menunggu respons penuh.

• Flag Stream: Atur ke true dalam badan permintaan.
• Tipe Event: chat.completion.chunk
• Data: Berisi delta.content untuk bagian teks.

Streaming tidak mengubah harga. Anda membayar untuk total token yang diproses. Kesalahan selama streaming ditangani dengan baik. Jika koneksi terputus, Anda dapat memulai ulang permintaan. Model tanpa sensor menjaga koherensi bahkan selama aliran panjang dalam batas 100k.

Batas, Kesalahan, dan Konteks

Pantau batas penggunaan Anda: 300 permintaan per menit per kunci, 8 permintaan paralel, dan tubuh permintaan 8 MB. Jika Anda melebihi batas laju, Anda menerima kesalahan 429. Jika saldo prabayar Anda habis, Anda menerima kesalahan 402; isi saldo melalui kripto untuk melanjutkan. Kesalahan 401 menunjukkan kunci API tidak valid atau hilang. Perhatikan bahwa permintaan yang gagal dan penolakan tidak mengonsumsi token. Batas konten keras memblokir konten seksual yang melibatkan anak di bawah umur. Semua konten dewasa hukum lainnya diperbolehkan.

Pemanggilan Fungsi

Tentukan alat dalam parameter tools. Model mengembalikan panggilan alat dalam respons. Gunakan tool_choice untuk memaksakan perilaku tertentu. Fitur ini bekerja secara identik dengan standar OpenAI. Parse panggilan alat dalam kode Anda dan eksekusi. Kirim hasilnya kembali dalam pesan berikutnya. API kimicode menangani definisi alat secara efisien. Pastikan skema JSON Anda valid. Pemanggilan fungsi tidak memerlukan kredit tambahan selain penggunaan token. Ini ideal untuk membangun agen atau alur kerja ekstraksi data terstruktur.

cURL

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