Pengenalan: Integrasikan chat apertus ai

Prasyarat dan Persediaan

Mula dengan mencipta akaun dan mendapatkan kunci API anda. Daftar menggunakan Google atau kata laluan e-mel pada halaman penjanaan kunci. Sistem memaparkan kunci anda serta-merta, jadi anda boleh menyalinnya tanpa kelewatan. Tiada nombor telefon diperlukan untuk pendaftaran. Anda menerima $0.50 dalam kredit percubaan yang sah selama tujuh hari, jadi anda boleh menguji sambungan tanpa menambah dana.

Konfigurasikan pembolehubah persekitaran atau klien SDK anda untuk menunjuk ke URL asas yang betul. URL ini berfungsi dengan pustaka OpenAI piawai. Tukar hanya URL asas dan kunci anda. ID model ialah "uncensored". Hujung akhir tunggal ini mengendalikan semua penyelesaian teks. Anda tidak perlu menguruskan pengaliran atau memilih model berbeza.

Pastikan perpustakaan klien anda menyokot protokol Penyelesaian Chat OpenAI. Kebanyakan SDK moden berfungsi secara sedia ada. Sahkan rangkaian anda membenarkan permintaan HTTPS keluar. Perkhidmatan ini menerima payload JSON standard. Tiada pengepala khas diperlukan selain pengesahan.

Pengesahan dengan Kunci API

Masukkan kunci API anda dalam header Authorization untuk setiap permintaan. Gunakan skema Bearer diikuti dengan rentetan kunci anda. Perkhidmatan akan mengesahkan kunci tersebut terhadap akaun anda. Kunci yang tidak sah akan memulangkan ralat 401 Tidak Dibenarkan. Tamat tempoh atau baki tidak mencukupi akan memulangkan respons 402 Pembayaran Diperlukan. Semak baki anda di papan pemuka jika permintaan gagal.

Kekalkan kunci anda selamat. Setiap akaun memegang satu kunci aktif. Menjana kunci baru akan membatalkan kunci sebelumnya. Jangan kongsikan kunci anda dalam repositori awam. Kunci API adalah pengenal tunggal untuk penggunaan anda. Had kadar dikenakan per kunci, bukan per akaun.

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"}]
  }'

Pengesahihan adalah tanpa keadaan. Pelayan menyemak token pada setiap panggilan. Jika anda memutarkan kunci anda, kemas kini semua klien yang berjalan serta-merta. Kehilangan header mengakibatkan penolakan serta-merta. Mesej ralat menyatakan kegagalan pengesahan dengan jelas.

Menghantar Permintaan Pertama Anda

Hantar permintaan POST ke hujung akhir penyelesaian sembang. Sertakan ID model "uncensored" dan sejarah mesej anda. API mengembalikan respons teks. Anda boleh mengalirkan output atau menunggu penyelesaian penuh. Setiap permintaan menggunakan token input dan output. Ralat tidak mengenakan caj kredit. Penolakan adalah percuma.

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 mengandungi statistik penggunaan. Jejak penggunaan token untuk menguruskan kredit pra-dibayar anda. Model menjawab tanpa penolakan kandungan untuk penggunaan dewasa yang sah. Anda boleh menghantar arahan sistem untuk menentukan tingkah laku. Mesej pengguna memacu perbualan. Jendela konteks menyokong 100,000 token secara keseluruhan.

Mulakan dengan pertukaran dua mesej mudah. Ini mengesahkan sambungan dan kualiti respons. Laraskan suhu dan top_p untuk output kreatif atau tepat. API menyokong parameter standard. Jujukan hentian berfungsi seperti yang diharapkan. Nilai benih memastikan hasil yang boleh diulang.

Respons Streaming Melalui SSE

Aktifkan penstriman dengan menetapkan parameter stream kepada true. API mengembalikan Acara Dikirim Pelayan (SSE) berbanding objek JSON tunggal. Setiap pecahan mengandungi sebahagian teks yang dijana. Baca pecahan sehingga aliran berakhir. Pecahan akhir termasuk jumlah penggunaan 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)

Penstriman mengurangkan latensi yang dirasakan. Pengguna melihat teks muncul secara masa nyata. Ini sesuai untuk antara muka sembang. Tangani token sebahagian dengan berhati-hati. Satukan pecahan untuk membentuk respons lengkap. Pelayan menutup sambungan apabila penjanaan selesai.

Pantau ralat aliran. Gangguan rangkaian mungkin membatalkan aliran. Laksanakan logik samb semula jika perlu. API tidak menghantar semula sejarah. Mulakan permintaan baru jika aliran gagal. Kiraan token dalam pecahan terakhir mencerminkan keseluruhan penjanaan.

Mengendalikan Parameter dan Mod

Gunakan parameter piawai untuk mengawal penjanaan. Tetapkan suhu untuk keacakan. Laraskan top_p untuk pensampelan nukleus. Takrifkan jujukan henti untuk menghentikan penjanaan awal. Hantar benih untuk output deterministik. Aktifkan mod JSON dengan menetapkan response_format kepada json_object. Model mengembalikan JSON sah apabila diminta.

Pemanggilan fungsi disokong. Tentukan alat dalam permintaan. Model mengembalikan panggilan alat apabila sesuai. Uraikan hujah alat dalam kod anda. Hantar hasil kembali untuk meneruskan perbualan. Ini membolehkan aliran 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 maksimum membatasi panjang output. Nilai lalai ialah 2,048 token. Tetapkan nilai yang lebih tinggi jika diperlukan. Had keras setiap permintaan ialah 16,000 token. Tetingkap konteks ialah 100,000 token. Rancang panjang sejarah anda dengan sewajarnya. Penalti frekuensi dan kehadiran membantu mengurangkan pengulangan.

Memahami Had dan Ralat

Had kadar melindungi kestabilan perkhidmatan. Anda boleh menghantar 300 permintaan setiap minit. Kekoncurrentan dihadkan kepada lapan permintaan serentak per kunci. Badan permintaan tidak boleh melebihi 8 MB. Melangkaui had akan memulangkan ralat 429 Terlalu Banyak Ralat. Tunggu sebelum cuba semula.

Periksa kod ralat untuk diagnostik. 401 bermaksud kunci tidak sah atau tiada. 402 menunjukkan kredit pra-dibayar tidak mencukupi. Tambah nilai melalui crypto untuk meneruskan perkhidmatan. 429 menandakan had kadar. 400 menandakan sintaks permintaan yang salah. Semes mesej ralat untuk butiran.

Pengurusan tetingkap konteks adalah kritikal. Jumlahkan token prompt dan penyelesaian. Pastikan jauh di bawah 100,000 token. Potong mesej lama jika perlu. API tidak memotong secara automatik. Anda mengawal panjang sejarah. Penggunaan konteks yang cekap mengurangkan kos.