ID ▾
Dapatkan kunci API

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.

Kunci bersinar di atas panel obrolan yang terhubung ke kubus server, mengilustrasikan akses kunci API

Poin utama

  1. Anda mendapatkan kunci setelah masuk dengan Google atau email dan kata sandi, lalu membuka halaman kunci API.
  2. Pengguna baru dapat mengklaim $0,50 kredit uji coba dengan satu klik, tanpa kartu, berlaku selama 7 hari.
  3. Gunakan base URL https://api.characteraiapi.com/v1 dan model ID uncensored dengan SDK OpenAI apa pun.
  4. 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.

  1. Daftar. Gunakan Google, atau daftar dengan email dan kata sandi.
  2. Buka halaman kunci. Arahkan ke halaman kunci API, di mana kunci akun Anda ditampilkan.
  3. Klaim uji coba. Satu klik di halaman itu menambahkan $0,50 kredit uji coba. Ini dibatasi satu per orang dan berlaku selama 7 hari.
  4. Salin kunci. Simpan di manajer kata sandi atau file rahasia segera.
  5. 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/completions sendiri. Jika Anda juga menambahkan /chat/completions ke base URL, jalurnya menjadi ganda dan permintaan gagal.
  • Nama model salah. Model ID adalah uncensored. Nama yang dipinjam dari layanan lain tidak akan cocok. Panggil GET /v1/models untuk melihat apa yang dilaporkan server.
  • Header hilang. Panggilan HTTP mentah memerlukan Authorization: Bearer diikuti dengan spasi dan kunci, plus Content-Type: application/json pada permintaan POST.
  • Saldo kosong. Header respons X-Balance-USD menunjukkan 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 .env ke .gitignore sebelum komit pertama Anda.
  • Gunakan satu kunci per lingkungan agar kebocoran di pengembangan tidak memengaruhi produksi.
  • Pantau header X-Balance-USD untuk 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.

Tanya jawab

Apakah ini memberi saya kunci API Character.ai?

Tidak. Ini adalah layanan terpisah dan independen. Anda mendapatkan kunci untuk endpoint yang kompatibel dengan OpenAI dengan ID model uncensored, yang dapat Anda gunakan sebagai backend untuk aplikasi karakter Anda sendiri.

Apakah saya memerlukan kartu untuk mendapatkan kunci?

Tidak. Anda mendaftar dengan Google atau email dan kata sandi, lalu klaim $0,50 kredit uji coba dengan satu klik di halaman kunci API. Kredit uji coba berlaku selama 7 hari.

Dapatkah saya menggunakan kunci di SillyTavern atau antarmuka obrolan lainnya?

Alat yang menerima endpoint yang kompatibel dengan OpenAI dapat menggunakannya. Masukkan base URL, kunci Anda, dan nama model uncensored.

Apa yang terjadi ketika saya mencapai batas laju?

API mengembalikan HTTP 429 dengan kode rate_limited atau concurrency. Tunggu sebentar dan coba lagi. Kunci uji coba mengizinkan 2 permintaan paralel dan 60 per menit.

Apakah kredit kedaluwarsa?

Kredit yang dibeli tidak pernah kedaluwarsa. Hanya kredit uji coba $0,50 yang memiliki jendela waktu 7 hari.

Kunci Anda hanya selangkah lagi dari satu formulir

Buat akun, salin kunci, ubah base URL. Itu saja seluruh proses pengaturannya.

Dapatkan kunci API