FAQ Uncensored API

Dasar-dasar

Apa itu Uncensored API dalam satu kalimat?

Ini adalah endpoint penyelesaian obrolan teks berbayar yang melayani satu model, id uncensored, dan tidak menolak konten dewasa yang sah, fiksi, atau topik kontroversial.

URL mana yang harus saya panggil?

Gunakan https://api.uncensoredapis.com/v1 sebagai basis. Permintaan obrolan dikirim ke POST /v1/chat/completions dan daftar model ada di GET /v1/models. Jalur lain akan mengembalikan 404.

Apakah saya harus mempelajari SDK baru?

Tidak. Bentuk permintaan dan respons mengikuti konvensi penyelesaian obrolan umum, sehingga paket Python dan Node resmi berfungsi setelah Anda mengubah URL basis dan kunci. curl biasa juga berfungsi, seperti yang ditunjukkan dokumen.

Apakah ada cara untuk mencobanya sebelum membayar?

Ya. Akun baru menerima $0,50 kredit uji coba gratis, berlaku selama 7 hari, dan tidak ada detail pembayaran yang diminta saat pendaftaran. Daftar dengan email dan kata sandi di halaman kunci API dan kunci akan muncul segera.

Bisakah saya memilih di antara beberapa model?

Tidak. Ada tepat satu model, dan id-nya adalah uncensored. Panggilan ke rute model mengembalikan entri tunggal itu, jadi tidak ada yang perlu dipilih atau diganti.

Untuk siapa layanan ini dimaksudkan?

Pengembang yang membangun produk untuk dewasa, termasuk alat fiksi, aplikasi roleplay, dan asisten penelitian. Anda bertanggung jawab atas pemeriksaan usia dan aturan konten Anda sendiri dalam apa pun yang Anda rilis di atasnya.

Kunci dan akses

Berapa banyak kunci yang dimiliki akun?

Satu. Jika Anda membutuhkan nilai baru, regenerasi dari akun; kunci sebelumnya berhenti berfungsi pada saat yang sama, jadi segera terapkan penggantian.

Di mana kunci harus disimpan?

Simpan di variabel lingkungan atau manajer rahasia di server yang Anda kendalikan. JavaScript browser dan biner seluler dapat diperiksa, jadi arahkan lalu lintas klien melalui backend Anda sendiri daripada menyematkan kunci.

Bagaimana kunci dikirim?

Dalam header Authorization: Bearer pada setiap permintaan. Nilai yang hilang atau salah mengembalikan 401 dengan objek error JSON.

Saya ingin kunci API tanpa sensor untuk tim. Bisakah kita berbagi satu?

Anda bisa, tetapi setiap proses berbagi batas 300 permintaan per menit dan saldo yang sama. Pasang gateway kecil di depan kunci dan berikan akses ke gateway kepada setiap rekan, bukan ke kuncinya sendiri.

Batas dan harga

Seberapa besar prompt bisa?

Jendela konteks adalah 100.000 token, dibagi oleh prompt dan completion. Body permintaan tunggal tidak boleh melebihi 8 MB. Permintaan yang promptnya plus max_tokens akan melebihi jendela akan ditolak dengan 400.

Seberapa lama balasan bisa?

Defaultnya adalah 2048 token. Anda dapat menaikkan max_tokens hingga maksimal 32.000 per permintaan. Ketika jawaban berhenti karena batas, finish_reason dibaca length.

Berapa biayanya?

Token input adalah $0,25 per juta dan token output adalah $1,00 per juta. Saldo adalah saldo prabayar, tidak ada langganan, dan saldo tidak pernah habis masa berlakunya. Lihat halaman harga untuk tabelnya.

Bisakah Anda memberikan perkiraan cepat?

Asumsikan satu giliran obrolan dengan 1.500 token prompt dan 300 token penyelesaian, murni sebagai ilustrasi. Itu adalah $0,000375 untuk input ditambah $0,0003 untuk output, atau sekitar $0,000675 per giliran, jadi $1 membeli sekitar 1.480 giliran seperti itu.

Apa yang terjadi ketika saya mengirim terlalu banyak permintaan?

Setiap kunci dapat membuat 300 permintaan per menit. Di atas itu Anda mendapatkan 429, dan respons yang tepat adalah melambat dan mencoba lagi dengan penundaan.

Pertanyaan integrasi

Parameter sampling mana yang dapat saya atur?

Parameter standar seperti temperature, top_p, dan stop diteruskan ke proses generasi. Atur parameter tersebut di dalam body permintaan persis seperti yang Anda lakukan di tempat lain.

Apakah API mengingat putaran percakapan sebelumnya untuk Anda?

Tidak. Setiap permintaan bersifat independen, sehingga Anda harus mengirim ulang percakapan melalui messages setiap kali. Potong putaran terlama ketika total token mendekati jendela konteks 100.000 token.

Bisakah saya melakukan streaming token ke browser?

Ya, kirimkan stream: true dan baca server-sent events. Lakukan dari backend Anda dan alirkan teks ke halaman web, agar kunci API tidak pernah mencapai klien.

Apakah pesan sistem didukung?

Ya. Tambahkan pesan dengan peran system di awal array untuk menetapkan nada, format, dan batas percakapan.

Apa yang harus saya periksa pertama kali ketika output terlihat terpotong?

Baca finish_reason. Nilai length berarti batas telah tercapai, jadi naikkan max_tokens atau pendekkan prompt. referensi mencantumkan semua nilai.

Saldo dan penagihan

Bagaimana cara menambahkan dana?

Isi saldo prabayar Anda melalui akun. Tidak ada langganan yang perlu diikuti, dan saldo yang tidak terpakai tetap tersedia karena tidak pernah habis masa berlakunya.

Apa yang terjadi ketika kredit uji coba habis?

Kredit uji coba berlaku selama 7 hari. Setelah kredit habis digunakan atau kedaluwarsa, permintaan akan mengembalikan kode 402 dengan kode no_credit hingga Anda mengisi ulang saldo.

Bisakah saya melihat berapa biaya sebuah permintaan?

Setiap respons menyertakan blok usage yang berisi jumlah token prompt, penyelesaian, dan total. Kalikan dengan tarif per juta token untuk mendapatkan biaya, dan buat catatan Anda sendiri jika Anda ingin membuat buku besar.

Apakah permintaan yang gagal bisa dicoba ulang secara gratis?

Pencobaan ulang diperbolehkan, tetapi batasi. Gunakan jeda singkat untuk 429 dan 503 dan jangan mengulang terus-menerus pada 400, 401, 402, atau 403, karena kesalahan tersebut tidak akan memperbaiki dirinya sendiri. panduan kesalahan memiliki kebijakan yang siap pakai.

Konten dan perilaku

Apa yang tidak akan dilakukan oleh model?

Konten dewasa yang sah tidak ditolak, begitu pula fiksi atau topik kontroversial. Pengecualian tegas adalah setiap konten seksual yang melibatkan anak di bawah umur, yang diblokir dengan 403 setiap kali, termasuk dalam cerita dan roleplay. Layanan ini untuk dewasa berusia 18 tahun ke atas.

Apakah prompt saya digunakan untuk melatih model?

Tidak. Prompt tidak digunakan untuk pelatihan.

Bagaimana ini berbeda dengan perutean melalui agregator?

Agregator mengarahkan Anda ke banyak model, masing-masing dengan aturan sendiri. Layanan ini menggunakan satu model di bawah satu kebijakan. Uncensored OpenRouter guide membahas perbandingan tersebut secara mendalam.

Apakah model dapat melihat gambar atau membuat embedding?

Tidak. Model hanya menangani teks, tanpa embedding, gambar, audio, video, atau fine-tuning.

Pemecahan masalah

Saya mendapatkan status 402 dengan no_credit. Apa yang harus dilakukan?

Saldo Anda telah habis atau masa percobaan telah berakhir. Isi ulang saldo prabayar dan kirimkan permintaan lagi.

Sebuah permintaan mengembalikan status 503 upstream_busy.

Ini bersifat sementara. Tunggu beberapa detik dan coba lagi, gunakan penundaan yang meningkat dan sedikit acak jika Anda menjalankan banyak worker.

Stream saya berakhir dan saya tidak dapat menemukan jumlah token.

Dengan streaming aktif, chunk terakhir yang berisi usage ditambahkan secara otomatis, tepat sebelum data: [DONE]. Daftar choices di dalamnya kosong, sehingga periksalah hal tersebut sebelum melakukan pengindeksan.

Apakah alat dan pemanggilan fungsi berfungsi?

Ya, dalam format standar: kirimkan array tools dan periksa respons untuk melihat tool_calls.