Dokumentasi API: Endpoint Kompatibel OpenAI

Autentikasi & URL Dasar

Akses API dengan mengatur kunci unik Anda dan URL dasar dalam variabel lingkungan Anda. Endpoint berada di https://api.apikeykimi.com/v1. Anda harus menyertakan header Authorization: Bearer YOUR_API_KEY dengan setiap permintaan. Kunci ini dibuat secara instan saat pendaftaran melalui Google atau email. Ini adalah satu-satunya kredensial yang diperlukan untuk autentikasi. Tidak ada skop atau izin yang perlu dikonfigurasi.

Copycurl https://api.apikeykimi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "convert this json object to python dictionary syntax"}]
  }'

Endpoint Chat Completions

Kirim pesan ke model menggunakan standar /v1/chat/completions endpoint. endpoint. Tentukan ID model sebagai uncensored dalam tubuh permintaan. API mengembalikan teks yang dihasilkan berdasarkan riwayat prompt Anda. Anda dapat menyesuaikan parameter seperti suhu dan top_p untuk mengendalikan kreativitas. Model mendukung pemanggilan fungsi dan mode JSON untuk output terstruktur.

Copyfrom openai import OpenAI

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

Respons Streaming (SSE)

Aktifkan pengiriman token real-time dengan mengatur stream: true dalam permintaan Anda. server mengembalikan stream Server-Sent Events. Setiap chunk berisi teks parsial hingga respons selesai. Ini sangat cocok untuk antarmuka obrolan dan tampilan kode langsung. Detail penggunaan token muncul di chunk terakhir stream.

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)

Pemanggilan Fungsi & Mode JSON

Tentukan alat atau paksa keluaran JSON menggunakan response_format parameter. Setel json_object agar respons JSON yang valid. Anda juga dapat meneruskan definisi alat untuk pemanggilan fungsi. Model mematuhi batasan ini dengan ketat. Ini memungkinkan integrasi yang andal dengan layanan eksternal. Gunakan tool_choice untuk mengontrol bagaimana alat dipanggil.

Batas Token & Kendala

Jendela konteks mendukung hingga 100.000 token untuk input dan output gabungan. Output maksimum per permintaan adalah 16.000 token. Jika Anda tidak mengatur max_tokens, batasnya secara default adalah 2.048 token. Permintaan dibatasi hingga 8 MB dalam ukuran badan. Anda dibatasi hingga 300 permintaan per menit. Hanya 8 permintaan yang dapat berjalan secara simultan per kunci.

Penanganan Kesalahan & Batasan Penggunaan

Tangani kesalahan dengan memeriksa kode status HTTP. 401 menunjukkan kunci API tidak valid atau kedaluwarsa. Kesalahan 402 berarti kredit prabayar Anda habis. Respons 429 menandakan bahwa Anda telah melebihi batas laju 300 permintaan per menit. Kesalahan dan penolakan tidak mengonsumsi token. Periksa saldo Anda di dasbor untuk menghindari gangguan.

Node.js

Copyimport OpenAI from "openai";

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