Dokumentasi API

Panduan Cepat: Permintaan pertama Anda

Kirim pesan pertama Anda ke model uncensored segera. Gunakan endpoint chat-completions standar untuk menghasilkan teks. Model merespons prompt bahasa alami tanpa penolakan konten untuk penggunaan dewasa yang sah. Konfigurasi ini berfungsi dengan klien apa pun yang kompatibel dengan OpenAI.

Mulai dengan menginstal SDK untuk bahasa pilihan Anda. Kemudian konfigurasikan kunci API Anda. Contoh berikut menunjukkan permintaan curl dasar untuk menguji konektivitas.

Anda dapat menyesuaikan parameter seperti suhu untuk mengendalikan keacakan. Respons mengembalikan teks yang dihasilkan secara langsung. Alur sederhana ini memungkinkan Anda memverifikasi bahwa API berfungsi sebelum membangun logika yang kompleks.

Copycurl https://api.apiaicharacter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current API rate limit status?"}]
  }'

URL Dasar dan Autentikasi

Terhubung menggunakan URL dasar khusus untuk API ini. Ganti titik akhir default dengan alamat server yang dihosting kami. Ini memastikan permintaan Anda mencapai model tanpa sensor secara langsung. Autentikasi bergantung pada satu kunci API per akun.

Hasilkan kunci Anda melalui dasbor. Lewatkan dalam header Authorization sebagai token Bearer. Metode ini kompatibel dengan SDK OpenAI standar. Anda dapat mengganti penyedia hanya dengan mengubah URL dasar dan kunci.

Jaga kunci Anda tetap aman. Ini memberikan akses penuh ke kredit prabayar Anda. Kunci menggantikan kunci aktif sebelumnya segera setelah dihasilkan.

Endpoint: Chat Completions

Berinteraksi dengan model melalui endpoint penyelesaian chat. Ini adalah satu-satunya endpoint generasi teks yang tersedia. Endpoint ini menerima pesan dan mengembalikan teks yang dihasilkan. Tidak ada dukungan untuk embedding, gambar, atau audio.

Kirim permintaan POST ke rute chat. Sertakan pesan sistem dan pengguna Anda dalam body. Model memproses konteks dan menghasilkan respons. Anda dapat menggunakan mode JSON untuk output terstruktur.

Pemanggilan fungsi juga didukung. Tentukan alat dan biarkan model memutuskan kapan menggunakannya. Fleksibilitas ini memungkinkan alur kerja agen yang kompleks. Respons mencakup konten yang dihasilkan dan penggunaan token.

Copyfrom openai import OpenAI

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

Parameter: Suhu, Top P, dan Stop

Kontrol gaya output menggunakan parameter standar. Sesuaikan temperature untuk mengubah kreativitas. Nilai yang lebih rendah membuat respons lebih deterministik. Nilai yang lebih tinggi memperkenalkan lebih banyak variasi.

Gunakan top P untuk memfilter kata-kata yang tidak mungkin. Ini membantu menjaga koherensi sambil mengizinkan kreativitas. Atur urutan stop untuk mengakhiri generasi pada penanda tertentu. Ini berguna untuk mengendalikan struktur dialog.

Parameter seed memungkinkan hasil yang dapat direproduksi. Gunakan saat men-debug prompt Anda. Parameter-parameter ini memberi Anda kontrol presisi atas perilaku model. Sesuaikan untuk memenuhi kebutuhan aplikasi Anda.

Copyimport OpenAI from "openai";

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

Streaming dan Penggunaan Token

Terima respons secara real-time menggunakan server-sent events. Streaming mengurangi latensi yang dirasakan bagi pengguna. API mengirim token saat dihasilkan. Ini menciptakan pengalaman membaca yang lebih mulus.

Penggunaan token dilaporkan dalam potongan terakhir. Ini memungkinkan Anda melacak biaya secara akurat. Penagihan didasarkan pada token aktual yang dikonsumsi. Kesalahan dan penolakan tidak menimbulkan biaya.

Terapkan handler stream untuk memproses data. Perbarui UI Anda saat token tiba. Pendekatan ini sangat ideal untuk antarmuka chat. Model mendukung streaming untuk semua jenis permintaan.

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)

Batas Laju dan Kendala

Memahami batas untuk menghindari gangguan layanan. Anda dapat membuat 300 permintaan per menit per kunci. Permintaan konkuren dibatasi hingga delapan secara bersamaan. Tubuh permintaan tidak boleh melebihi 8 MB.

Tangani kesalahan dengan baik. Status 401 berarti kunci Anda tidak valid. Status 402 menunjukkan kredit tidak cukup. Status 429 menandakan Anda telah mencapai batas laju.

Jendela konteks mendukung total 100.000 token. Ini mencakup prompt dan completion. Output maksimal adalah 16.000 token per permintaan. Set max_tokens untuk mengontrol panjang output. Error gratis, sehingga logika retry aman.