ID ▾
Dapatkan kunci API

Uncensored Endpoint: URL Dasar, ID Model, dan Batasan

Endpoint uncensored di sini berarti API teks yang kompatibel dengan OpenAI yang di-hosting, yang memberikan respons tanpa penolakan konten untuk penggunaan dewasa yang sah. Halaman ini mencantumkan URL dasar, ID model, metode, batas, dan kode kesalahan yang Anda butuhkan sebelum menulis kode apa pun.

Diperbarui

Poin utama

  1. URL dasar adalah https://api.uncensoredendpoint.com/v1 dan satu-satunya ID model adalah uncensored.
  2. Dua metode tersedia: POST /v1/chat/completions dan GET /v1/models.
  3. Jendela konteks adalah 100.000 token, untuk prompt dan completion secara keseluruhan.
  4. Kunci penuh memungkinkan 8 permintaan bersamaan dan 300 permintaan per menit.
Ilustrasi isometrik pipa data yang menghubungkan laptop ke server API

Pengaturan koneksi secara singkat

Jika Anda hanya membutuhkan nilai-nilainya, berikut adalah nilainya. Bagian lain di halaman ini menjelaskan cara kerjanya dalam praktiknya.

PengaturanNilai
URL dasarhttps://api.uncensoredendpoint.com/v1
ID modeluncensored
Header AuthAuthorization: Bearer YOUR_KEY
EndpointPOST /v1/chat/completions, GET /v1/models
Jendela konteks100.000 token, prompt plus penyelesaian
Ukuran badan permintaan maksimum8 MB
Batas kunci penuh8 permintaan konkuren, 300 permintaan per menit
Batas kunci uji coba2 permintaan simultan, 60 permintaan per menit
Harga$0,15 per 1M token input, $0,50 per 1M token output

Layanan ini menggunakan format kabel yang sama dengan API penyelesaian chat OpenAI. Jika alat memungkinkan Anda mengetikkan URL dasar kustom dan kunci API, alat itu dapat berbicara dengan ini. Anda mendapatkan kunci di halaman kunci API, dan dokumentasi membawa referensi yang sama dalam bentuk yang lebih singkat.

Apa yang dilakukan setiap metode

Hanya ada dua rute yang ada, yang menjaga antarmuka tetap kecil.

  • GET /v1/models mengembalikan daftar model. Anda akan melihat satu entri, uncensored. Banyak klien memanggil rute ini untuk mengisi dropdown model, jadi ini juga cara cepat untuk mengonfirmasi bahwa kunci dan URL Anda benar.
  • POST /v1/chat/completions adalah mesin utamanya. Ini mengambil daftar pesan dan mengembalikan penyelesaian, baik sebagai respons JSON tunggal atau sebagai aliran acara yang dikirim server.

Rute penyelesaian teks lama, rute respons, embedding, rute gambar, dan rute audio tidak termasuk dalam produk. Jika sebuah pustaka mencoba salah satu dari rute tersebut, Anda akan mendapatkan kesalahan; beralihlah pustaka tersebut ke mode obrolan.

Pemeriksaan cepat dari terminal:

curl https://api.uncensoredendpoint.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

Daftar JSON yang berisi uncensored berarti kunci berfungsi. HTTP 401 berarti kunci hilang, salah ketik, atau memiliki spasi atau baris baru yang tersesat di dalamnya, yang merupakan penyebab paling umum ketika kunci berasal dari variabel shell.

Permintaan pertama Anda dalam curl, Python, dan Node

Ketiga contoh ini mengirim hal yang sama: satu pesan sistem, satu pesan pengguna, suhu rendah. Ganti YOUR_KEY atau atur variabel lingkungan API_KEY.

curl https://api.uncensoredendpoint.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are a concise assistant."},
      {"role": "user", "content": "Explain what a context window is in two sentences."}
    ],
    "temperature": 0.7
  }'

Dengan SDK Python resmi, Anda hanya meneruskan dua argumen tambahan ke klien:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.uncensoredendpoint.com/v1",
    api_key="YOUR_KEY",
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a concise assistant."},
        {"role": "user", "content": "Explain what a context window is in two sentences."},
    ],
    temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)

Dan di Node dengan SDK yang sama:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.uncensoredendpoint.com/v1",
  apiKey: process.env.API_KEY,
});

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [
    { role: "system", content: "You are a concise assistant." },
    { role: "user", content: "Explain what a context window is in two sentences." },
  ],
});
console.log(resp.choices[0].message.content);

Responsnya mencakup objek usage dengan jumlah token prompt dan penyelesaian. Perhatikan itu: dua angka itu adalah apa yang Anda bayar. Header respons juga membawa X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, dan X-RateLimit-Limit-Concurrency. Log ID permintaan dengan setiap panggilan, karena itu adalah hal pertama yang akan ditanyakan dukungan jika ada yang terlihat salah.

Streaming, pemanggilan fungsi, dan mode JSON

Tiga fitur mencakup sebagian besar aplikasi nyata, dan ketiganya mengikuti bentuk OpenAI yang sudah Anda kenal.

Streaming

Atur stream: true dan baca acara yang dikirim server. Penggunaan dilaporkan di akhir aliran, jadi Anda masih dapat menghitung token tanpa permintaan kedua. Satu hal penting untuk perencanaan kapasitas: permintaan streaming memegang slot konkurensinya hingga aliran selesai. Klien lambat yang membaca jawaban panjang dengan tetesan menjaga slot tetap sibuk untuk seluruh waktu.

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write a four-line poem about rain."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Pemanggilan alat

Berikan tools dan opsional tool_choice. Ketika model memutuskan untuk memanggil fungsi, Anda mendapatkan tool_calls di balasan (juga dialirkan, jika Anda mengalirkannya). Anda menjalankan fungsi sendiri dan mengirimkan hasilnya kembali sebagai pesan dengan role: "tool". Modelnya adalah model bobot terbuka tunggal, jadi uji skema alat Anda dengan beberapa prompt realistis dan pertahankan deskripsi parameter singkat dan harfiah.

Mode JSON

Kirimkan response_format: {"type":"json_object"} untuk meminta output JSON yang valid. Juga sebutkan dalam prompt bahwa Anda menginginkan JSON dan jelaskan bidang yang Anda harapkan. Parsinglah secara defensif, dan coba lagi sekali jika terjadi kegagalan parsing, jangan percaya output secara buta.

Kontrol sampling diteruskan: temperature, top_p, stop, seed, dan penalti frekuensi dan penalti kehadiran.

Jendela 100.000 token dalam praktiknya

Jendela konteks adalah 100.000 token, dan angka itu mencakup prompt dan penyelesaian bersama-sama. Penyelesaian dapat menggunakan apa pun yang ditinggalkan prompt, dan max_tokens bersifat opsional. Jika Anda mengirim 90.000 token prompt, maksimal sekitar 10.000 tersisa untuk jawaban.

Aturan kasar untuk teks bahasa Inggris adalah bahwa satu token sedikit kurang dari satu kata, jadi 100.000 token adalah sekitar 70.000 kata. Itu cukup untuk satu set bab naskah panjang, bagian besar basis kode, atau beberapa jam riwayat obrolan. Tiga kebiasaan menjaga ini berguna:

  • Potong riwayat secara sengaja. Klien obrolan mengirim ulang seluruh percakapan setiap giliran, jadi biaya dan latensi tumbuh dengannya. Pertahankan prompt sistem, ringkasan giliran lama, dan beberapa pesan terakhir.
  • Atur max_tokens ketika ukuran output penting. Ini opsional, tetapi batas melindungi Anda dari jawaban yang tidak terkendali pada prompt panjang.
  • Perhatikan batas tubuh 8 MB. Ini terpisah dari jendela token. Teks biasa jarang mencapai 8 MB, tetapi blob base64 yang disisipkan ke dalam prompt bisa.

Karena penagihan per token, permintaan jendela penuh biaya uang nyata dibandingkan dengan yang pendek. Halaman harga memiliki tarifnya, dan Anda dapat menghitung permintaan apa pun sebagai token input dikalikan $0,15 ditambah token output dikalikan $0,50, masing-masing dibagi satu juta.

Batas laju dan keluarga 429

Kunci penuh memungkinkan 8 permintaan secara bersamaan dan 300 permintaan per menit. Kunci trial lebih ketat: 2 secara bersamaan dan 60 per menit. Ketika Anda melewati garis, API menjawab dengan HTTP 429, dan kode error memberi tahu Anda garis mana:

Kode kesalahanArtiApa yang harus dilakukan
rate_limitedTerlalu banyak permintaan per menitPerlambat; sebarkan panggilan selama menit
concurrencyTerlalu banyak permintaan yang berjalan bersamaanAntrian di sisi Anda; batasi pekerja paralel di 8 (2 di trial)
429 dengan Retry-After: 5Beban berlebih sementaraTunggu 5 detik, lalu coba lagi

Pertahanan paling sederhana adalah semaphore dalam kode Anda sendiri, berukuran sesuai kunci Anda. Di Python dengan asyncio, asyncio.Semaphore(8) di sekitar setiap panggilan menghilangkan error concurrency sepenuhnya. Tambahkan retry yang menghormati header Retry-After dan kembali ke penundaan eksponensial singkat ketika header tidak ada. Ingat bahwa aliran memegang slot untuk panjang penuh mereka, sehingga batch delapan aliran panjang akan memblokir permintaan kesembilan bahkan jika hitungan per menit rendah.

Permintaan yang gagal atau ditolak tidak dibayar, jadi loop retry tidak membebani biaya Anda untuk upaya yang memantul.

Apa modelnya, dan apa yang bukan

Layanan menjalankan satu model bobot terbuka, di-hosting oleh penyedia independen dan ditala untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah. Ini bukan API resmi dari vendor besar mana pun, dan ini bukan router yang memilih antara vendor. Ada satu model, uncensored, jadi tidak ada yang harus dipilih dan tidak ada tier harga untuk dibandingkan.

Batasnya jelas. Teks masuk dan teks keluar. Tidak ada pembuatan gambar, audio, atau video, tidak ada embedding, dan tidak ada fine-tuning. Satu aturan konten tetap adalah bahwa konten seksual yang melibatkan anak di bawah umur tidak pernah diperbolehkan. Prompt tidak digunakan untuk pelatihan.

Kerangka itu membantu ketika Anda merencanakan proyek. Alat fiksi dan roleplay untuk dewasa, aplikasi pendamping, penelitian tentang perilaku model, dan alat yang menangani teks kasar atau sensitif tanpa model menolak adalah kecocokan alami. Jika Anda membutuhkan embedding untuk pencarian, Anda memerlukan penyedia terpisah untuk bagian itu dan masih dapat menggunakan endpoint ini untuk pembuatan teks.

Sebelum Anda masuk ke produksi

Demo yang berfungsi membutuhkan waktu lima menit. Layanan yang andal membutuhkan sedikit lebih banyak. Mulailah dengan uji coba: pengguna baru dapat mengklaim $0.50 kredit dengan satu klik di halaman kunci setelah pendaftaran, sekali per orang, berlaku selama 7 hari dan tanpa perlu pembayaran. Pendaftaran dapat dilakukan dengan Google atau dengan email dan kata sandi. Itu sudah cukup untuk ratusan panggilan uji singkat untuk memeriksa integrasi Anda.

Ketika Anda beralih ke lalu lintas nyata, isi ulang dengan jumlah bulat apa pun dari $20 hingga $500. Pembayaran dengan kripto (USDT di TRC20, USDC di Base). Saldo tidak pernah kedaluwarsa dan tidak ada langganan, jadi saldo tetap ada sampai Anda membelanjakannya. Bonusnya adalah 5% dari $50, 10% dari $100 dan 15% dari $200.

Kemudian kerjakan daftar singkat: simpan kunci dalam variabel lingkungan atau manajer rahasia, jangan pernah dalam kode sisi klien; log X-Request-Id; pantau X-Balance-USD sehingga Anda dapat memberi peringatan sebelum saldo habis; batasi jumlah pekerja paralel; dan tangani 429 dengan penundaan daripada loop ketat. daftar periksa kunci produksi untuk kunci API membahas penanganan kunci secara lebih rinci, dan dokumentasi memegang referensi parameter.

Tanya jawab

Apakah saya memerlukan SDK khusus?

Tidak. SDK atau klien OpenAI apa pun berfungsi. Ubah URL dasar dan kuncinya, atur model menjadi uncensored, dan kode Anda yang lain tetap sama.

Dapatkah model menghasilkan gambar atau embedding?

Tidak. API hanya untuk teks. Tidak ada pembuatan gambar, audio, atau video, tidak ada embedding, dan tidak ada fine-tuning.

Apa yang terjadi ketika saya mencapai batas laju?

Anda mendapatkan HTTP 429. Kode error adalah rate_limited ketika Anda melebihi permintaan per menit dan concurrency saat terlalu banyak permintaan berjalan bersamaan. Tunggu sebentar dan coba lagi.

Apakah ada aturan konten yang ketat?

Ya. Konten seksual yang melibatkan anak di bawah umur tidak pernah diizinkan. Sisanya, model disetel untuk menjawab tanpa penolakan, untuk penggunaan dewasa yang sah.

Kunci Anda hanya selangkah lagi dari satu formulir

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

Dapatkan kunci APIBaca dokumentasi