Panduan Cepat: Integrasi API Pacar AI

URL Dasar dan Autentikasi

API kami mengikuti standar chat-completions OpenAI, sehingga integrasi menjadi mudah untuk klien yang ada. Anda harus menyertakan kunci API Anda di header Authorization setiap permintaan. URL dasar untuk semua endpoint adalah https://api.roleplayapi.com/v1. Saat menggunakan SDK resmi, perbarui konfigurasi base_url agar mengarah ke alamat ini dan berikan kunci Anda sebagai api_key. Pengaturan ini memastikan permintaan Anda mencapai endpoint tanpa sensor kami tanpa mengubah logika standar Anda.

Kirim Kompleksi

Mulai percakapan dengan mengirim permintaan POST ke /v1/chat/completions. Pengidentifikasi model adalah uncensored. Anda dapat meneruskan sejumlah pesan dalam array messages untuk menetapkan konteks atau memulai dialog baru. Respons berisi output teks model, yang dapat Anda streaming atau uraikan sebagai objek JSON. Endpoint ini menangani interaksi teks masuk dan teks keluar yang diperlukan untuk aplikasi berbasis karakter.

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

Integrasi SDK Python

Gunakan pustaka Python openai resmi untuk berinteraksi dengan API dengan boilerplate minimal. Konfigurasikan klien dengan URL dasar kami dan kunci API Anda. Kemudian, panggil chat.completions.create dengan ID model uncensored. Pendekatan ini memanfaatkan petunjuk tipe dan mekanisme penanganan kesalahan yang ada, memungkinkan Anda fokus pada logika aplikasi Anda daripada penguraian HTTP. Objek respons memberikan akses langsung ke konten yang dihasilkan.

Copyfrom openai import OpenAI

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

Integrasi SDK Node.js

Untuk proyek JavaScript dan TypeScript, SDK Node.js OpenAI menyediakan antarmuka yang bersih untuk panggilan API. Inisialisasi klien dengan URL dasar kustom dan kunci rahasia Anda. Panggil endpoint penyelesaian chat menggunakan model uncensored. Metode ini sangat ideal untuk server web atau fungsi tepi di mana Anda perlu mengelola permintaan asinkron secara efisien. SDK menangani serialisasi dan deserialisasi payload JSON secara otomatis.

Copyimport OpenAI from "openai";

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

Aktifkan Streaming

Kurangi latensi yang dirasakan dengan mengaktifkan server-sent events (SSE). Atur parameter stream menjadi true dalam permintaan Anda. API akan mengembalikan aliran potongan alih-alih respons lengkap tunggal. Ini sangat berguna untuk antarmuka obrolan di mana pengguna mengharapkan respons karakter segera. Anda dapat memproses setiap potongan saat tiba, memperbarui UI secara bertahap. Aliran berakhir ketika model selesai menghasilkan urutan token.

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

Permintaan Anda tunduk pada batas laju 300 permintaan per menit per kunci. Jika Anda melebihi ini, API mengembalikan kode status 429. Kegagalan autentikasi menghasilkan kesalahan 401, sedangkan saldo prabayar yang tidak mencukupi memicu kesalahan 402. Jendela konteks mendukung hingga 100.000 token untuk prompt dan penyelesaian gabungan. Jika Anda perlu memeriksa model yang tersedia, kirim permintaan GET ke /v1/models. Pastikan tubuh permintaan Anda tidak melebihi 8 MB.