Panduan Cepat: Integrasi obrolan apertus ai

Prasyarat dan Penyiapan

Mulai dengan membuat akun dan mendapatkan kunci API Anda. Daftar menggunakan Google atau kata sandi email di halaman pembuatan kunci. Sistem menampilkan kunci Anda segera, sehingga Anda dapat menyalinnya tanpa penundaan. Tidak diperlukan nomor telepon untuk pendaftaran. Anda menerima kredit uji coba senilai $0.50 yang berlaku selama tujuh hari, sehingga Anda dapat menguji konektivitas tanpa menambahkan dana.

Konfigurasikan variabel lingkungan atau klien SDK Anda untuk mengarah ke URL dasar yang benar. URL ini berfungsi dengan pustaka OpenAI standar. Ubah hanya URL dasar dan kunci Anda. ID modelnya adalah "uncensored". Titik akhir tunggal ini menangani semua penyelesaian teks. Anda tidak perlu mengelola pengalihan atau memilih model yang berbeda.

Pastikan pustaka klien Anda mendukung protokol OpenAI Chat Completions. Sebagian besar SDK modern bekerja langsung. Verifikasi jaringan Anda mengizinkan permintaan HTTPS keluar. Layanan ini menerima payload JSON standar. Tidak diperlukan header khusus selain autentikasi.

Autentikasi dengan Kunci API

Masukkan kunci API Anda di header Authorization untuk setiap permintaan. Gunakan skema Bearer diikuti oleh string kunci Anda. Layanan memvalidasi kunci terhadap akun Anda. Kunci yang tidak valid akan mengembalikan error 401 Unauthorized. Kunci yang kedaluwarsa atau dana yang tidak cukup akan memicu respons 402 Payment Required. Periksa saldo Anda di dasbor jika permintaan gagal.

Jaga kunci Anda tetap aman. Setiap akun memegang satu kunci aktif. Menghasilkan kunci baru membuat kunci sebelumnya tidak berlaku. Jangan bagikan kunci Anda di repositori publik. Kunci API adalah satu-satunya pengidentifikasi untuk penggunaan Anda. Batas laju berlaku per kunci, bukan per akun.

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

Autentikasi stateless. Server memeriksa token pada setiap panggilan. Jika Anda memutar kunci, perbarui semua klien yang berjalan segera. Kehadiran header yang hilang mengakibatkan penolakan segera. Pesan error secara jelas menyatakan kegagalan autentikasi.

Mengirim Permintaan Pertama Anda

Kirim permintaan POST ke endpoint chat completions. Sertakan ID model "uncensored" dan riwayat pesan Anda. API mengembalikan respons teks. Anda dapat mengalirkan output atau menunggu penyelesaian penuh. Setiap permintaan mengonsumsi token input dan output. Kesalahan tidak membebankan kredit. Penolakan gratis.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apertusaichat.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 menyertakan statistik penggunaan. Lacak konsumsi token untuk mengelola kredit prabayar Anda. Model menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah. Anda dapat mengirim prompt sistem untuk menentukan perilaku. Pesan pengguna menggerakkan percakapan. Jendela konteks mendukung total 100,000 token.

Mulai dengan pertukaran dua pesan sederhana. Ini memverifikasi konektivitas dan kualitas respons. Sesuaikan suhu dan top_p untuk output kreatif atau presisi. API mendukung parameter standar. Urutan berhenti berfungsi seperti yang diharapkan. Nilai benih memastikan hasil yang dapat direproduksi.

Respons Streaming melalui SSE

Aktifkan streaming dengan mengatur parameter stream menjadi true. API mengembalikan Server-Sent Events (SSE) alih-alih objek JSON tunggal. Setiap potongan berisi sebagian teks yang dihasilkan. Baca potongan hingga aliran berakhir. Potongan terakhir mencakup penggunaan token total.

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)

Streaming mengurangi latensi yang dirasakan. Pengguna melihat teks muncul secara real-time. Ini ideal untuk antarmuka obrolan. Tangani token parsial dengan hati-hati. Gabungkan chunk untuk membentuk respons lengkap. Server menutup koneksi saat generasi selesai.

Pantau kesalahan stream. Gangguan jaringan dapat membatalkan stream. Terapkan logika koneksi ulang jika diperlukan. API tidak mengirim ulang riwayat. Mulai permintaan baru jika stream gagal. Hitungan token di potongan terakhir mencerminkan seluruh generasi.

Menangani Parameter dan Mode

Gunakan parameter standar untuk mengendalikan generasi. Atur temperature untuk keacakan. Sesuaikan top_p untuk sampling inti. Tentukan urutan henti untuk menghentikan generasi lebih awal. Berikan seed untuk output deterministik. Aktifkan mode JSON dengan mengatur response_format ke json_object. Model mengembalikan JSON yang valid saat diminta.

Pemanggilan fungsi didukung. Tentukan alat dalam permintaan. Model mengembalikan panggilan alat saat sesuai. Uraikan argumen alat dalam kode Anda. Teruskan hasil kembali untuk melanjutkan percakapan. Ini memungkinkan alur kerja agen yang kompleks.

Copyimport OpenAI from "openai";

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

Token maksimal membatasi panjang output. Defaultnya adalah 2,048 token. Atur nilai yang lebih tinggi jika diperlukan. Batas keras per permintaan adalah 16,000 token. Jendela konteks adalah 100,000 token. Rencanakan panjang riwayat Anda sesuai. Penalti frekuensi dan kehadiran membantu mengurangi pengulangan.

Memahami Batas dan Error

Batas laju melindungi stabilitas layanan. Anda dapat mengirim 300 permintaan per menit. Konkurensi dibatasi hingga delapan permintaan simultan per kunci. Badan permintaan tidak boleh melebihi 8 MB. Melampaui batas mengembalikan error 429 Too Many Errors. Tunggu sebelum mencoba lagi.

Periksa kode error untuk diagnostik. 401 berarti kunci tidak valid atau hilang. 402 menunjukkan kredit prabayar tidak cukup. Isi ulang via kripto untuk melanjutkan layanan. 429 menandakan pembatasan laju. 400 menandakan kesalahan sintaks permintaan. Tinjau pesan error untuk detailnya.

Manajemen context window sangat penting. Jumlahkan token prompt dan completion. Tetap jauh di bawah 100.000 token. Potong pesan lama jika diperlukan. API tidak melakukan pemotongan otomatis. Anda mengendalikan panjang riwayat. Penggunaan context yang efisien mengurangi biaya.