Kunci API Character AI: Cara Mendapatkan dan Menggunakannya
Jika Anda mencari kunci API character ai, hal pertama yang perlu diketahui adalah situs ini bukan Character.ai dan tidak menerbitkan kuncinya. Situs ini memberikan Anda kunci untuk API teks OpenAI-compatible independen yang berfungsi sebagai backend siap pakai untuk aplikasi obrolan karakter.
Diperbarui

Poin utama
- Anda mendapatkan kunci setelah masuk dengan Google atau email dan kata sandi, lalu membuka halaman kunci API.
- Pengguna baru dapat mengklaim $0,50 kredit uji coba dengan satu klik, tanpa kartu, berlaku selama 7 hari.
- Gunakan base URL https://api.characteraiapi.com/v1 dan model ID
uncensoreddengan SDK OpenAI apa pun. - Simpan kunci di server atau dalam variabel lingkungan, jangan pernah di kode front-end publik.
Apa yang sebenarnya Anda dapatkan
Character.ai adalah produk obrolan konsumen. Orang yang mencari kunci API character ai biasanya menginginkan salah satu dari dua hal: cara memanggil chatbot karakter dari kode mereka sendiri, atau backend untuk aplikasi persona yang tidak dibatasi oleh aturan produk yang di-host. Situs ini memenuhi kebutuhan kedua. Anda masuk, menerima kunci, dan mengirim permintaan ke endpoint OpenAI-compatible. Tidak ada di sini yang terhubung ke Character.ai atau menggunakan ulang karakternya.
Layanan ini adalah API teks yang di-host di depan satu model bobot terbuka, dijalankan oleh penyedia independen dan disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah. Ini bukan API resmi dari vendor model mana pun dan bukan router antar vendor. Model ID adalah uncensored, dan base URL adalah https://api.characteraiapi.com/v1. Ada dua metode: POST /v1/chat/completions dan GET /v1/models.
Karena antarmuka cocok dengan OpenAI, pekerjaan membangun persona ada di sisi Anda. Anda menulis persona sebagai pesan sistem, menyimpan riwayat percakapan, dan mengirimkannya dengan setiap permintaan. Itu memberi Anda kendali atas suara, memori, dan kecepatan yang jarang dibuka oleh produk tertutup. Batas kerasnya sama untuk setiap pengguna: tidak ada konten seksual yang melibatkan anak di bawah umur, selamanya.
Dapatkan kunci Anda dalam lima langkah
Seluruh jalur membutuhkan beberapa menit. Anda tidak memerlukan kartu untuk memulai.
- Daftar. Gunakan Google, atau daftar dengan email dan kata sandi.
- Buka halaman kunci. Arahkan ke halaman kunci API, di mana kunci akun Anda ditampilkan.
- Klaim uji coba. Satu klik di halaman itu menambahkan $0,50 kredit uji coba. Ini dibatasi satu per orang dan berlaku selama 7 hari.
- Salin kunci. Simpan di manajer kata sandi atau file rahasia segera.
- Kirim permintaan uji. Gunakan perintah curl di bawah ini sebelum menyentuh kode aplikasi apa pun.
Perlakukan kunci seperti kata sandi. Siapa pun yang memilikinya dapat menghabiskan saldo Anda. Jika Anda pikir itu bocor, hentikan penggunaannya segera, hapus dari setiap aplikasi, dan periksa saldo Anda untuk pengeluaran yang tidak terduga.
Uji kunci dengan curl
Atur kunci sebagai variabel lingkungan agar tidak pernah tampil dalam riwayat shell Anda sebagai teks biasa di dalam skrip. Kemudian daftar model-modelnya. Ini mengonfirmasi bahwa kunci berfungsi dan bahwa Anda mencapai host yang benar.
export API_KEY="paste-your-key-here"
curl https://api.characteraiapi.com/v1/models \
-H "Authorization: Bearer $API_KEY"Anda harus mendapatkan daftar JSON yang mencakup uncensored. Sekarang kirim permintaan obrolan pertama dengan persona kecil. Pesan sistem menetapkan karakter, pesan pengguna memulai adegan.
curl https://api.characteraiapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You are Mara, a dry-witted ship engineer in a space opera. Stay in character."},
{"role": "user", "content": "The reactor is humming wrong again. What do you do?"}
],
"temperature": 0.9
}'Respons mengikuti bentuk penyelesaian obrolan standar. Teks balasan ada di choices[0].message.content. Header respons juga membawa X-Request-Id, X-Balance-USD dan header batas laju, yang berguna ketika Anda ingin menampilkan sisa saldo di UI Anda sendiri.
Gunakan kunci dari Python atau Node
SDK OpenAI apa pun berfungsi setelah Anda mengubah dua nilai: base URL dan kunci. Berikut adalah versi Python dengan paket openai resmi.
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.characteraiapi.com/v1",
api_key=os.environ["API_KEY"],
)
reply = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are Mara, a ship engineer. Stay in character."},
{"role": "user", "content": "Status report?"},
],
)
print(reply.choices[0].message.content)Dan panggilan yang sama di Node:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.characteraiapi.com/v1",
apiKey: process.env.API_KEY,
});
const reply = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "system", content: "You are Mara, a ship engineer. Stay in character." },
{ role: "user", content: "Status report?" },
],
});
console.log(reply.choices[0].message.content);Banyak antarmuka obrolan memiliki bidang untuk endpoint OpenAI-compatible kustom. Di alat-alat itu, tempelkan base URL, tempelkan kunci, dan ketik uncensored sebagai nama model. Tidak ada yang perlu diubah. Halaman dokumentasi mencantumkan parameter yang didukung, termasuk streaming, pemanggilan fungsi, dan mode JSON.
Masalah kunci umum dan perbaikan cepat
Kegagalan pertama kali sebagian besar berasal dari sejumlah kesalahan kecil. Periksa mereka dalam urutan ini sebelum Anda mencurigai sesuatu yang lebih besar.
- Spasi ekstra atau tanda kutip di kunci. Baris baru yang disalin dari file sudah cukup untuk membuat autentikasi gagal. Cetak panjang variabel dan bandingkan dengan apa yang Anda salin.
- Base URL salah. Base URL berakhir dengan
/v1, dan SDK menambahkan/chat/completionssendiri. Jika Anda juga menambahkan/chat/completionske base URL, jalurnya menjadi ganda dan permintaan gagal. - Nama model salah. Model ID adalah
uncensored. Nama yang dipinjam dari layanan lain tidak akan cocok. PanggilGET /v1/modelsuntuk melihat apa yang dilaporkan server. - Header hilang. Panggilan HTTP mentah memerlukan
Authorization: Bearerdiikuti dengan spasi dan kunci, plusContent-Type: application/jsonpada permintaan POST. - Saldo kosong. Header respons
X-Balance-USDmenunjukkan sisa yang tersisa. Ketika kredit uji coba habis atau melebihi 7 hari, isi saldo atau permintaan akan berhenti berhasil. - Batas laju. Kunci uji coba mengizinkan 2 permintaan konkuren dan 60 per menit. Dua stream terbuka sudah menggunakan kedua slot.
Kunci yang buruk biasanya menghasilkan kesalahan autentikasi, bukan balasan model. Sebuah batas menghasilkan HTTP 429 dengan kode rate_limited atau concurrency. Membaca tubuh kesalahan, bukan hanya kode status, menghemat waktu karena kode tersebut memberi tahu Anda batas mana yang Anda capai. Setiap respons membawa X-Request-Id; simpan dalam log Anda, sehingga Anda dapat mencocokkan panggilan yang gagal dengan permintaan tertentu nanti.
Batas uji coba dan apa yang dibeli dengan uji coba
Kunci uji coba memiliki batas yang lebih rendah daripada yang penuh: 2 permintaan konkuren dan 60 permintaan per menit. Kunci penuh mengizinkan 8 permintaan konkuren dan 300 permintaan per menit. Untuk pengujian satu persona itu sudah cukup. Jika Anda menjalankan beberapa obrolan sekaligus dari skrip pengujian, Anda akan melihat HTTP 429 dengan kode kesalahan concurrency atau rate_limited. Permintaan streaming memegang slot konkurensinya hingga stream berakhir, sehingga dua stream terbuka pada kunci uji coba mengisinya.
Berapa jauh $0,50? Harga adalah $0,15 per 1M token input dan $0,50 per 1M token output. Ambil giliran obrolan tipikal dengan 1.500 token riwayat dan persona masuk dan 300 token keluar:
- Input: 1.500 token x $0,15 / 1.000.000 = $0,000225
- Output: 300 token x $0,50 / 1.000.000 = $0,00015
- Satu giliran: $0,000375
- $0,50 / $0,000375 adalah sekitar 1.333 giliran
Itu cukup untuk menguji beberapa karakter dengan baik. Permintaan yang gagal atau ditolak tidak dibebani biaya, sehingga permintaan yang error tidak menghabiskan kredit Anda. Uji coba berakhir setelah 7 hari; kredit yang Anda beli nanti tidak berakhir.
Pengaturan yang membuat persona terasa pas
Sebuah kunci memberi Anda koneksi; kualitas karakter berasal dari prompt dan pengaturan sampling. Beberapa kebiasaan membantu lebih daripada trik cerdas.
Tulis pesan sistem sebagai lembar karakter singkat dalam kalimat sederhana: siapa karakternya, bagaimana cara bicaranya, apa keinginannya, dan seberapa panjang balasan yang seharusnya. Berikan satu atau dua baris dialog contoh jika suara sangat penting. Model mengikuti contoh konkret lebih baik daripada kata sifat, sehingga baris seperti "Mara menjawab dengan kalimat pendek, kering, dan bercanda saat gugup" lebih efektif daripada "Mara cerdas dan menawan".
Gunakan temperature untuk mengatur tingkat keaktifan. Nilai di dekat 0.9 memberikan variasi frasa yang lebih besar, sedangkan nilai di dekat 0.5 menjaga karakter tetap lebih stabil. Tambahkan urutan stop jika aplikasi Anda menggunakan label pembicara seperti "User:" dan Anda ingin mencegah model menulis sisi lain dari percakapan. Penalti frekuensi dan kehadiran dapat mengurangi frasa yang berulang dalam obrolan panjang, tetapi naikkan secara perlahan, karena nilai tinggi dapat membuat dialog menjadi aneh.
Ingatlah bahwa model hanya mengetahui apa yang ada dalam permintaan. Jika karakter harus mengingat nama pemain dari 200 pesan yang lalu, simpan pesan tersebut di jendela konteks atau simpan fakta kunci dalam pesan sistem. Inilah mengapa daftar memori yang Anda perbarui sendiri sering kali lebih baik daripada mengirim riwayat yang sangat panjang.
Mengisi saldo saat kredit uji coba habis
Tidak ada langganan. Anda melakukan pembayaran di muka dan menghabiskan saldo per token. Pengisian ulang menerima jumlah bulat mulai dari $20 hingga $500, dan jumlah yang lebih besar mendapatkan bonus: +5% dari $50, +10% dari $100, dan +15% dari $200. Jadi $50 menjadi $52,50 kredit, $100 menjadi $110, dan $200 menjadi $230. Anda dapat membayar dengan kripto (USDT pada TRC20, USDC pada Base).
Halaman harga memiliki tabel lengkap. Untuk perencanaan, giliran 1.500 input dan 300 output sama dengan $0,000375, sehingga $20 mencakup sekitar 53.000 giliran seperti itu. Roleplay jangka panjang membutuhkan biaya lebih per giliran karena riwayatnya bertambah, jadi batasi berapa banyak riwayat yang Anda kirim ulang. Jendela konteks adalah 100.000 token, termasuk prompt dan penyelesaian, tetapi Anda jarang ingin mengisinya.
Menjaga kunci tetap aman dalam aplikasi nyata
Kesalahan paling umum dengan proyek obrolan adalah memanggil API langsung dari kode browser. Apa pun yang dikirim ke browser dapat dibaca oleh setiap pengunjung, termasuk kuncinya. Letakkan server kecil di antara antarmuka depan Anda dan API. Browser berbicara ke rute Anda, rute Anda menambahkan header Authorization: Bearer dan meneruskan permintaan.
- Simpan kunci dalam variabel lingkungan atau manajer rahasia, bukan di repositori.
- Tambahkan entri
.envke.gitignoresebelum komit pertama Anda. - Gunakan satu kunci per lingkungan agar kebocoran di pengembangan tidak memengaruhi produksi.
- Pantau header
X-Balance-USDuntuk menangkap loop yang tidak terkendali sejak dini. - Coba lagi pada HTTP 429 dengan jeda singkat. Respons kelebihan beban sementara menyertakan
Retry-After: 5.
Prompt yang dikirim ke API tidak digunakan untuk pelatihan. Meskipun demikian, hindari mengirim data yang tidak ingin Anda simpan dalam log di sisi Anda sendiri. Jika Anda ingin melihat lebih dalam tentang apa yang dilakukan dan tidak dilakukan oleh API semacam itu, artikel mitos dan fakta membahas kesalahpahaman umum.