Panduan Cepat API Kimi

Prasyarat: Instalasi SDK

Instal SDK resmi untuk bahasa pemrograman pilihan Anda agar otentikasi dan serialisasi ditangani secara otomatis. API kami mematuhi standar OpenAI, sehingga pustaka klien yang kompatibel apa pun dapat digunakan dengan perubahan konfigurasi minimal.

Untuk Python, instal pustaka melalui pip. Untuk Node.js, gunakan npm atau yarn. Alat-alat ini mengelola klien HTTP dan parsing JSON untuk Anda.

Autentikasi: Mengatur kunci API kimi Anda

Dapatkan kunci Anda dari dasbor dan teruskan sebagai Authorization header. Gunakan URL dasar https://api.apikimi.cc/v1 untuk semua permintaan.

Simpan kunci dengan aman di variabel lingkungan atau file konfigurasi Anda. Format header adalah Bearer YOUR_API_KEY.

Mengirim Permintaan Pertama Anda

Kirim permintaan POST ke /v1/chat/completions dengan ID model Anda uncensored. Respons mengembalikan teks yang dihasilkan secara langsung.

Pastikan Anda mengatur model field correctly. The API returns raw output without content refusals for lawful topics.

Respons Streaming

Aktifkan streaming dengan mengatur stream: true dalam body permintaan Anda. Ini mengembalikan chunk sebagai Server-Sent Events (SSE).

Parse stream SSE untuk menampilkan token secara real-time. Chunk terakhir mencakup statistik penggunaan token untuk penagihan.

Pengaturan Pemanggilan Fungsi

Tentukan alat dalam tools array dalam permintaan Anda. Model mengembalikan panggilan alat alih-alih teks langsung ketika sesuai.

Tangani panggilan alat dalam logika aplikasi Anda dan kirimkan hasilnya kembali ke API untuk pemrosesan lebih lanjut. Dukungan untuk tool_choice memungkinkan penegakan ketat.

Penanganan Kesalahan dan Batasan

Tangani kesalahan HTTP standar: 401 untuk kunci tidak valid, 402 untuk kredit tidak cukup, dan 429 untuk batas laju. Jendela konteks mendukung total 100,000 token.

Output maks adalah 16.000 token per permintaan. Error tidak mengonsumsi kredit. Sesuaikan logika retry Anda berdasarkan kode error.

cURL

Copycurl https://api.apikimi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the key differences between Rust and Go memory management"}]
  }'

Python

Copyfrom openai import OpenAI

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