KiApi Dokumentasi: Integrasi dalam 5 Menit

Memulai: URL dasar dan autentikasi

KiApi sepenuhnya konform dengan OpenAI API. Anda dapat memanfaatkan ekosistem SDK dan klien yang ada dengan menyesuaikan base_url. URL dasar untuk semua permintaan adalah https://api.kiapis.com/v1. Autentikasi dilakukan hanya menggunakan kunci API yang Anda peroleh setelah mendaftar di halaman dasbor Anda. Kunci ini harus dikirimkan dalam header HTTP Authorization: Bearer <IHR_API_SCHLÜSSEL>. Anda dapat membuat kunci baru kapan saja, yang akan membuat kunci lama tidak valid.

Berbeda dengan layanan lain, kami tidak menawarkan endpoint kompleks untuk embedding atau fine-tuning. Fokus kami adalah generasi teks murni. KiApi adalah koneksi langsung Anda ke model yang dioptimalkan untuk respons tanpa sensor. Pastikan Anda mengkonfigurasi lingkungan dengan benar sebelum mengirim permintaan pertama.

POST /v1/chat/completions: Generasi teks

Inti API adalah endpoint POST /v1/chat/completions. Di sini Anda mengirim daftar pesan (sistem, pengguna, asisten) dan menerima respons teks. Parameter ID model harus diatur ke uncensored. Responsnya sinkron dan segera menyertakan fragmen teks yang dihasilkan serta metadata penggunaan token.

Struktur permintaan mengikuti format standar. Anda dapat menentukan peran untuk menyusun konteks dengan jelas. Sistem memproses input dan menghasilkan respons berdasarkan perilaku model yang dipelajari. Ini adalah metode utama untuk hampir semua aplikasi teks, dari chatbot hingga analisis teks.

Kopierencurl https://api.kiapis.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."}]
  }'

Respons berisi objek JSON dengan konten yang dihasilkan. Pastikan Anda mengekstrak area content dari respons untuk digunakan lebih lanjut di aplikasi Anda. Tidak ada metadata tambahan seperti biaya per permintaan yang dikembalikan dalam respons standar; informasi ini tersedia di dashboard.

Streaming dengan Server-Sent Events (SSE)

Untuk aplikasi yang membutuhkan output segera, KiApi mendukung streaming melalui Server-Sent Events (SSE). Aktifkan dengan mengatur "stream": true di body permintaan. Alih-alih menunggu respons lengkap, Anda menerima aliran patch JSON yang secara bertahap berisi teks yang dihasilkan.

Ini sangat berguna untuk antarmuka chat di mana umpan balik segera meningkatkan pengalaman pengguna. KiApi sebagai api streaming memungkinkan Anda mengurangi latensi dan menciptakan rasa percakapan waktu nyata. Klien harus mem-parsing aliran dan menggabungkan fragmen hingga akhir stream ditandai.

Kopierenstream = 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)

Saat streaming, statistik penggunaan token sering kali dikembalikan di akhir stream pada event terakhir. Ini memungkinkan penagihan yang akurat berdasarkan panjang generasi aktual. Pastikan kode klien Anda menangani akhir stream untuk melepaskan sumber daya dengan benar.

Pemanggilan alat dan fungsi

Model mendukung Tool Calling, juga dikenal sebagai Function Calling. Ini memungkinkan LLM mengembalikan data JSON terstruktur yang mewakili fungsi atau tindakan tertentu di aplikasi Anda. Anda menentukan alat yang tersedia di body permintaan, dan model memutuskan kapan alat harus dipanggil berdasarkan input pengguna.

Struktur definisi alat mengikuti standar OpenAI. Anda dapat menentukan beberapa alat, dan model akan memilih yang paling sesuai. Respons berisi daftar panggilan alat yang kemudian dapat Anda eksekusi di logika backend Anda. Ini memperluas kemungkinan KiApi jauh melampaui generasi teks murni.

Kopierenfrom openai import OpenAI

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

Gunakan Tool Calling untuk mengotomatisasi alur kerja kompleks. Model menyediakan parameter untuk alat langsung dalam format JSON. Anda tidak perlu menggunakan parser eksternal untuk respons karena strukturnya berasal langsung dari model. Ini membuat integrasi ke sistem yang ada jauh lebih mudah dan andal.

GET /v1/models: Model yang tersedia

Endpoint GET /v1/models mencantumkan model yang tersedia yang dapat diakses melalui API. Ini berguna untuk memeriksa secara dinamis model mana yang tersedia atau mengonfirmasi ID model. Biasanya Anda akan menerima daftar dengan model uncensored.

Respons berisi metadata model seperti ID, pemilik, dan tanggal pembuatan. Berbeda dengan beberapa API lain, respons standar tidak secara langsung menyertakan panjang konteks maksimum atau harga spesifik. Informasi ini harus diambil dari dokumentasi atau dashboard. Namun, endpoint ini sangat penting untuk konfigurasi klien otomatis.

Kopierenimport OpenAI from "openai";

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

Gunakan endpoint ini untuk menyesuaikan aplikasi Anda terhadap perubahan di masa depan. Jika model baru ditambahkan, mereka akan muncul secara otomatis dalam daftar ini. Model saat ini uncensored adalah satu-satunya model yang tersedia dan dicirikan sebagai model bahasa besar yang dioptimalkan untuk konten tanpa sensor.

Batas laju dan kode error

Untuk memastikan stabilitas layanan, batas tertentu berlaku. Per kunci API, 300 permintaan per menit diperbolehkan. Body permintaan maksimum adalah 8 MB. Jika Anda melebihi batas ini, Anda akan menerima kode status HTTP 429 Too Many Requests. Rancang aplikasi Anda untuk mengimplementasikan upaya ulang dengan backoff eksponensial.

Kode error umum lainnya adalah 401 Unauthorized jika kunci API tidak valid, dan 402 Payment Required jika saldo Anda habis. KiApi menggunakan model prabayar, sehingga permintaan tanpa saldo akan langsung ditolak. Pastikan Anda memeriksa saldo akun secara teratur.

Jendela konteks adalah 100.000 token untuk input dan output digabungkan. Jika melebihi batas ini, pesan error akan dikembalikan. KiApi adalah solusi andal untuk pengembang yang menghargai aturan jelas dan batas transparan.