Quickstart Integrasi API Character

Instal SDK

Mulai dengan menginstal library klien resmi untuk bahasa Anda. Ini memastikan kompatibilitas dengan endpoint yang kompatibel dengan OpenAI yang kami sediakan. Library menangani serialisasi dan logika percobaan ulang untuk Anda.

Untuk Python, gunakan pip. Untuk Node.js, gunakan npm. Langkah ini memakan waktu beberapa detik dan menyiapkan lingkungan untuk contoh kode yang akan menyusul.

Konfigurasikan URL Dasar Anda

Arahkan klien SDK Anda ke titik akhir kami untuk mengakses model tanpa sensor. URL dasarnya adalah HTTPS://api.apicharacter.com/v1. Ini menggantikan URL OpenAI default dalam konfigurasi Anda.

Tanpa perubahan ini, permintaan akan gagal atau menjangkau layanan yang salah. Anda hanya perlu mengatur ini sekali saat menginisialisasi instance klien Anda.

Atur Kunci API Anda

Suntikkan kunci Anda ke variabel lingkungan atau konfigurasi klien. Autentikasi diperlukan untuk setiap permintaan untuk melacak penggunaan kredit prabayar Anda. Kunci Anda memberikan akses ke endpoint LLM uncensored.

Jaga nilai ini dengan aman. Nilai ini bertindak sebagai kredensial tunggal Anda untuk akun. Tidak diperlukan nomor telepon atau verifikasi tambahan untuk akses dasar.

Buat Permintaan Pertama Anda

Kirim penyelesaian chat sederhana untuk memverifikasi konektivitas. ID model adalah "uncensored". Ini mengonfirmasi bahwa autentikasi dan URL dasar Anda benar sebelum Anda membangun aplikasi Anda.

Lihat contoh di bawah untuk permintaan cURL standar.

Copycurl https://api.apicharacter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "set my name to Alex"}]
  }'

Tangani Respons Streaming

Aktifkan streaming untuk latensi lebih rendah di antarmuka obrolan Anda. Atur parameter stream menjadi true dalam permintaan Anda. SDK akan menghasilkan token saat dihasilkan.

Ini sangat penting untuk pengalaman pengguna yang responsif. Anda menangani potongan parsial saat tiba melalui Server-Sent Events.

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, Error, dan Konteks

Memahami batasan Anda untuk menghindari gangguan layanan. Anda mendapatkan jendela konteks 100.000 token. Output maksimum adalah 16.000 token kecuali Anda menentukan lain.

Batas laju adalah 300 permintaan per menit. Kesalahan 401 berarti kunci tidak valid. 402 berarti kredit habis. 429 berarti Anda mencapai batas laju. Perhatikan hal ini untuk penskalaan produksi.

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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