Panduan Integrasi API Character AI

Mengapa Mengganti Character AI Dengan API?

Character AI mudah digunakan, tetapi ia mengunci watak anda ke dalam ekosistemnya. Anda tidak dapat menyimpan tetingkap konteks penuh, mengubah parameter model, atau memastikan data anda kekal peribadi. Penyelesaian API seperti AI Uncutly memberikan anda akses terus kepada LLM tanpa sensor. Anda mengawal prompt, suhu, dan jujukan hentian. Ini bermakna watak anda berkelakuan tepat seperti yang anda mahukan.

Platform milik sendiri sering menolak kandungan yang sepenuhnya sah. Mereka mungkin memutuskan cerita kerana kata kunci sensitif. Dengan API chatbot tanpa tapisan, anda memutuskan apa yang dibenarkan. Anda mendapat hujung sambungan tunggal dan boleh dipercayai untuk penjanaan teks. Kebolehpercayaan ini sangat penting apabila anda membina produk yang bergantung pada watak yang konsisten. Anda tidak berada di bawah kuasa pasukan pentadbiran sewenang-wenangnya platform.

Langkah 1: Dapatkan Kunci API Anda

Mula dengan mencipta akaun pada papan pemuka penyedia. Anda boleh log masuk dengan Google atau menggunakan e-mel dan kata laluan ringkas. Tiada nombor telefon diperlukan. Setelah berdaftar, navigasi ke bahagian kunci API. Sistem menjana kunci unik serta-merta. Salin kunci ini dan simpan dengan selamat dalam pembolehubah persekitaran anda.

Setiap permintaan ke API mesti termasuk kunci ini dalam header. Jika kunci hilang atau tidak sah, pelayan mengembalikan ralat 401. Anda mendapat kredit percubaan kecil untuk menguji integrasi sebelum membelanjakan wang. Kredit percubaan ini berlangsung selama tujuh hari. Ia adalah cara yang baik untuk mengesahkan setup anda berfungsi dengan betul.

Langkah 2: Konfigurasikan URL Asas

Kebanyakan klien LLM moden mengharapkan antara muka serasi OpenAI. Anda perlu mengarahkan SDK anda ke URL asas yang betul. Untuk perkhidmatan ini, hujung titiknya adalah https://api.uncutlyai.com/v1. Struktur URL ini meniru API OpenAI standard. Ini bermakna anda boleh menggunakan perpustakaan sedia ada tanpa perubahan kod besar.

Kemas kini objek konfigurasi anda untuk termasuk URL asas ini. Selain itu, tetapkan kunci API dalam header pengesahan. ID model yang akan anda gunakan hanyalah "uncensored". Model ini disesuaikan untuk lebih sedikit penolakan dan kebebasan kreatif yang lebih baik. Ia mengendalikan konteks panjang dengan baik, sehingga 100,000 token. Panjang ini membolehkan sejarah watak yang mendalam.

Langkah 3: Hantar Penyelesaian Sembang Pertama Anda

Bina permintaan ke /v1/chat/completions endpoint. Badan harus mengandungi senarai mesej. Setiap mesej mempunyai peranan seperti "system", "user", atau "assistant". Mesej sistem menentukan peribadi watak. Mesej pengguna memacu perbualan.

Berikut adalah cara anda menyusun permintaan:

Copycurl https://api.uncutlyai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Show me the API endpoint for text generation"}]
  }'

Hantar permintaan ini untuk melihat model bertindak balas. Pelayan memproses token dan mengembalikan penyelesaian teks. Anda boleh menetapkan parameter seperti temperature untuk mengawal kreativiti. Nilai yang lebih tinggi menjadikan watak lebih tidak dapat diramal. Nilai yang lebih rendah menjadikannya lebih konsisten. Fleksibiliti ini membolehkan anda menipikan suara.

Langkah 4: Tangani Respons Penstriman

Aplikasi sembang terasa perlahan jika keseluruhan respons menunggu sehingga akhir. Aliran (streaming) menyelesaikan ini. Tetapkan stream parameter kepada true. Pelayan menghantar balik siri Acara Dikirim Pelayan (SSE). Setiap peristiwa mengandungi pecahan teks kecil.

Kod klien anda mesti menguraikan segmen-segmen ini dan memaparkannya secara masa nyata. Ini mewujudkan ilusi manusia sedang menaip. Ia meningkatkan pengalaman pengguna dengan ketara. Segmen akhir sering mengandungi statistik penggunaan token. Anda boleh menggunakan data ini untuk menjejaki kos anda dengan tepat.

Copyfrom openai import OpenAI

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

Pastikan pengendali penstriman anda menangkap sebarang ralat rangkaian. Saluran yang rosak boleh meninggalkan UI dalam keadaan memuatkan. Sentiasa tutup sambungan apabila penstriman selesai atau gagal.

Langkah 5: Uruskan Token dan Kos

Memahami kos token adalah penting untuk bajet. Anda membayar setiap satu juta token. Token input berharga $0.15 setiap satu juta. Token output berharga $0.50 setiap satu juta. Anda hanya membayar untuk token yang diproses. Kesilapan tidak mengenakan caj anda. Penolakan juga tidak mengenakan caj.

Model pra-bayar ini telusur. Anda mengisi semula dengan mata wang kripto. Pengisian semula minimum ialah $20. Anda boleh menambah $500 pada satu masa. Tiada langganan bulanan. Kredit anda tidak luput. Kebolehramalan ini membantu anda merancang kos pembangunan. Anda tahu tepat berapa kos setiap perbualan.

Langkah 6: Laksanakan Pemanggilan Fungsi

Watak lanjutan sering memerlukan interaksi dengan alat luar. Pemanggilan fungsi membolehkan model mengembalikan data terstruktur. Anda menentukan skema untuk fungsi tersebut. Model memutuskan bila untuk memanggilnya berdasarkan perbualan.

Sebagai contoh, watak mungkin perlu menyemak cuaca. Anda menghantar definisi fungsi dalam permintaan. Model menjawab dengan objek JSON yang mengandungi nama fungsi dan hujah. Kod anda melaksanakan fungsi dan menghantar hasilnya kembali ke model.

Copyimport OpenAI from "openai";

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

Gelung ini berterusan sehingga model menjana respons teks akhir. Ia membolehkan cerita interaktif dinamik. Anda tidak terhad kepada output teks statik. Model boleh mencetuskan acara dalam aplikasi anda.

Langkah 7: Pengendalian Ralat dan Had

API mempunyai had. Anda boleh menghantar 300 permintaan per minit. Hanya lapan permintaan boleh aktif serentak. Badan permintaan mesti kurang daripada 8 MB. Jika anda melebihi had ini, anda akan menerima ralat 429. Laksanakan penangguhan eksponen dalam logik cubaan semula anda.

Tangani ralat rangkaian dengan lembut. Jika pelayan mengembalikan ralat 500, tunggu dan cuba semula. Jangan andaikan model akan berjaya sentiasa. Log ralat ini untuk mengenal pasti corak. Masa tunggu yang kerap mungkin menunjukkan anda perlu menyesuaikan tetapan masa tunggu anda.

Langkah 8: Skala Integrasi Anda

Apabila pangkalan pengguna anda berkembang, penggunaan API anda akan meningkat. Pantau penggunaan token anda dengan teliti. Gunakan data penggunaan dari respons penstriman untuk menjejak kos. Jika anda notices kos tinggi, pertimbangkan untuk mengoptimumkan prompt anda. Prompt sistem yang lebih pendek boleh mengurangkan token input.

Pertimbangkan penimbalan respons kerap. Jika pelbagai pengguna bertanya soalan yang sama, layan hasil yang ditimbal. Ini mengurangkan panggilan API dan menjimatkan wang. Anda juga boleh melaksanakan had kadar pada pelayan anda sendiri. Ini menghalang satu pengguna daripada menghabiskan semua kredit anda. Integrasi yang berskala dengan baik kekal pantas dan boleh dipercayai.