Poin utama
- Base URL kami adalah https://api.uncensoredgptapi.com/v1 dan ID modelnya adalah
uncensored. - SDK Python dan Node mengambil base_url atau baseURL; keduanya juga membaca variabel lingkungan.
- Kebanyakan kegagalan berasal dari hilangnya /v1, path ganda, atau nama model lama.
- GET /v1/models adalah cara tercepat untuk mengonfirmasi bahwa URL dan kunci benar.
Apa fungsi base URL
base URL API GPT adalah alamat yang ditambahkan SDK OpenAI di depan setiap path endpoint. Secara default, SDK resmi mengirim permintaan ke server OpenAI. Jika Anda menetapkan base URL lain, kode klien yang sama mengirim format permintaan yang sama ke server lain yang menggunakan protokol yang sama.
Itulah arti sebenarnya dari kompatibel dengan OpenAI. API kami menerima POST /v1/chat/completions dan GET /v1/models dengan bentuk JSON yang sama, header Authorization: Bearer yang sama, dan format streaming yang sama. Jadi Anda mengubah tiga nilai:
- Base URL:
https://api.uncensoredgptapi.com/v1 - Kunci API: kunci dari dasbor Anda
- Model:
uncensored
Layanan kami adalah layanan independen yang menjalankan satu model open-weight. Ini bukan API OpenAI dan bukan router ke vendor lain, sehingga nama model seperti gpt-4o tidak ada di sini. Gunakan uncensored di mana saja.
Python dengan SDK OpenAI
Di SDK Python saat ini, teruskan base_url saat membuat klien.
from openai import OpenAI
client = OpenAI(
base_url="https://api.uncensoredgptapi.com/v1",
api_key="YOUR_API_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "Explain what a base URL is in two sentences."},
],
)
print(resp.choices[0].message.content)Jika kode Anda lebih lama dan menggunakan openai.api_base, itu ada di SDK pra-1.0, di mana pengaturan global memiliki nama yang berbeda. Meng-upgrade paket biasanya lebih mudah daripada menyesuaikan kode. Periksa versi dengan pip show openai.
Penting untuk mengetahui bagaimana SDK membangun permintaan. Ini mengambil base URL Anda, menambahkan path endpoint seperti /chat/completions, dan menambahkan header Authorization: Bearer dari kunci Anda. Itulah seluruh mekanismenya. Ketika sesuatu gagal, cetak atau log URL akhir, dan bandingkan dengan perintah curl di bagian berikutnya.
Klien yang sama menerima pengaturan timeout dan max_retries. Nilai default mencoba lagi beberapa kali saat masalah koneksi, yang baik untuk sebagian besar skrip. Untuk batas laju, tangani pengecualian batas laju SDK dan kurangi frekuensi. Permintaan streaming memegang slot concurrency-nya hingga berakhir, sehingga lonjakan stream panjang dapat mencapai batas concurrency meskipun jumlah permintaan per menit Anda rendah.
import time
from openai import OpenAI, RateLimitError
client = OpenAI(base_url="https://api.uncensoredgptapi.com/v1", api_key="YOUR_API_KEY", max_retries=0)
def ask(text, tries=4):
for attempt in range(tries):
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": text}],
)
return r.choices[0].message.content
except RateLimitError:
time.sleep(5 * (attempt + 1))
raise RuntimeError("still rate limited")Waktu tunggu lima detik pada percobaan ulang pertama sesuai dengan nilai Retry-After: 5 yang dikirim API saat kelebihan beban sementara. Menunggu lebih lama pada setiap upaya selanjutnya menghindari pembebanan endpoint.
Node dan curl
SDK Node menggunakan baseURL dengan huruf besar URL.
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.uncensoredgptapi.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Name three uses for a base URL." }],
});
console.log(resp.choices[0].message.content);Tanpa SDK apa pun, curl menunjukkan persis apa yang dilakukan SDK. URL lengkap adalah base URL ditambah /chat/completions.
curl https://api.uncensoredgptapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'Membaca perintah tersebut adalah cara paling jelas untuk memahami base URL: semuanya hingga dan termasuk /v1 adalah base, dan SDK menambahkan sisanya.
Variabel lingkungan
Jika Anda tidak dapat mengedit kode, atau ingin satu pengaturan untuk beberapa skrip, SDK OpenAI membaca OPENAI_BASE_URL dan OPENAI_API_KEY dari lingkungan ketika tidak ada nilai eksplisit yang diberikan.
export OPENAI_BASE_URL="https://api.uncensoredgptapi.com/v1"
export OPENAI_API_KEY="YOUR_API_KEY"
python my_script.pyIni berguna untuk alat yang tidak Anda tulis. Apa pun yang dibangun di atas SDK OpenAI mungkin mengambil variabel tanpa perubahan, meskipun Anda masih perlu menetapkan nama model menjadi uncensored di dalam alat. Jika alat meng-hardcode nama model, Anda memerlukan pengaturan sendiri atau perubahan kode.
Memisahkan dua endpoint
Banyak proyek menguji terhadap satu endpoint dan mengirimkan terhadap endpoint lain, atau beralih di antaranya melalui lingkungan. Jauhkan tiga nilai dari kode Anda dan bacalah dari konfigurasi, sehingga pengalihan adalah perubahan pada file dan bukan edit kode.
import os
from openai import OpenAI
client = OpenAI(
base_url=os.environ.get("LLM_BASE_URL", "https://api.uncensoredgptapi.com/v1"),
api_key=os.environ["LLM_API_KEY"],
)
MODEL = os.environ.get("LLM_MODEL", "uncensored")Menggunakan nama variabel Anda sendiri daripada nilai default SDK menghindari jebakan diam-diam: alat yang membaca OPENAI_API_KEY dari shell akan mengirim kunci apa pun yang diatur di sana ke base URL apa pun yang diatur di sebelahnya. Jika Anda memiliki kunci OpenAI lama di profil Anda dan base URL baru di proyek Anda, Anda bisa berakhir dengan mengirim kunci satu layanan ke layanan lain. Nama yang terpisah membuatnya tidak mungkin terjadi, dan Anda dapat melihat sekilas endpoint mana yang akan digunakan skrip.
Perlakukan nama model sebagai konfigurasi juga. Itu adalah nilai yang paling sering tertinggal saat Anda beralih, dan menghasilkan kegagalan paling membingungkan, karena semuanya tampak benar.
Streaming dan tools menggunakan base URL yang sama
Mengubah base URL tidak membatasi fitur. Streaming, tool calling, dan mode JSON melalui path /chat/completions yang sama, sehingga kode yang berfungsi terhadap API asli tetap berfungsi. Streaming mengembalikan Server-Sent Events, dengan penggunaan dilaporkan di akhir stream.
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredgptapi.com/v1", api_key="YOUR_API_KEY")
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Count from one to five."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
print()Pemeriksaan pada chunk.choices penting. Chunk terakhir yang membawa penggunaan mungkin tidak memiliki pilihan, dan kode yang mengindeks ke daftar kosong akan crash pada pesan terakhir. Panggilan alat mengalir dengan cara yang sama, sebagai delta tool_calls parsial yang Anda kumpulkan sebelum menjalankan fungsi, dan hasilnya kembali sebagai pesan dengan role: "tool". Mode JSON mengambil response_format={"type": "json_object"}.
Aplikasi dan framework dengan bidang base URL
Banyak aplikasi mengekspos pengaturan yang sama di bawah nama berbeda: API base, endpoint, URL OpenAI kustom, atau host. Aturan tidak berubah. Tempelkan base URL termasuk /v1, tempelkan kunci, dan ketik uncensored sebagai nama model.
SillyTavern, misalnya, memungkinkan Anda menambahkan endpoint yang kompatibel dengan OpenAI. Kelas ChatOpenAI LangChain menerima argumen base_url. Antarmuka lain menyebut bidang tersebut sebagai proxy URL atau reverse proxy. Nama bidang bervariasi menurut versi, jadi cari yang menerima URL yang berakhir dengan /v1.
Beberapa aplikasi meminta model dari dropdown yang diisi dengan memanggil GET /v1/models. Endpoint itu berfungsi di sini dan mengembalikan daftar model, sehingga dropdown harus menampilkan uncensored setelah URL dan kunci benar. Jika tetap kosong, URL atau kunci salah.
Ketika aplikasi menawarkan bidang base URL dan bidang "organisasi" atau "proyek", biarkan bidang tambahan kosong. Itu ada untuk layanan asli dan tidak berarti apa pun di sini. Jika aplikasi bersikeras pada kunci yang dimulai dengan prefix tertentu, coba jenis koneksi lain, seperti opsi kompatibel OpenAI generik atau kustom, daripada preset untuk layanan asli.
Beberapa alat desktop menguji koneksi dengan meminta nama model tertentu dari penyedia asli, dan melaporkan kegagalan meskipun endpoint baik-baik saja. Dalam hal ini, lewati tombol uji dan kirim pesan sungguhan. Jika balasan tiba, URL, kunci, dan model benar, dan alat hanya ketat dalam pengecekannya.
Alat berbasis browser juga dapat mengalami aturan lintas asal, karena permintaan meninggalkan halaman untuk host yang berbeda. Jika alat web gagal di browser tetapi panggilan yang sama berhasil di curl, jalankan permintaan dari server kecil Anda sendiri agar kunci tetap di luar kode sisi klien, yang merupakan desain yang lebih aman dalam kasus apa pun.
Kesalahan umum dan cara memperbaikinya
Hampir setiap pengaturan yang gagal berasal dari daftar pendek.
- /v1 hilang. Base URL adalah
https://api.uncensoredgptapi.com/v1, alamat lengkap hingga/v1dan bukan hanya nama host. Tanpa/v1SDK membangun path yang tidak ada. - Path ganda. Jika Anda menempelkan
.../v1/chat/completionssebagai base URL, SDK akan menambahkan path lagi. Berikan hanya base-nya. - Garis miring di akhir. Sebagian besar SDK menanganinya, tetapi beberapa alat tidak. Coba tanpanya.
- Nama model lama. Nama model seperti
gpt-4oyang tersisa dari kode asli tidak akan cocok. Tetapkanuncensored. - Kunci salah. Gunakan kunci dari layanan ini. Kunci OpenAI tidak berfungsi di sini, dan kunci kami tidak berfungsi di OpenAI.
- Kesalahan batas laju. HTTP 429 dengan kode
rate_limitedberarti terlalu banyak permintaan per menit; kodeconcurrencyberarti terlalu banyak sekaligus. HeaderRetry-After: 5pada respons 429 menandakan kelebihan beban sementara, jadi tunggu lima detik dan coba lagi.
Panduan pemecahan masalah kami membahas lebih detail tentang kesalahan integrasi.
Verifikasi pengaturan dalam satu panggilan
Sebelum menjalankan seluruh aplikasi Anda, panggil endpoint model. Biayanya murah dan mengonfirmasi URL serta kunci Anda secara bersamaan.
curl https://api.uncensoredgptapi.com/v1/models \
-H "Authorization: Bearer $API_KEY"Jika hasilnya adalah daftar yang berisi uncensored, kirimkan permintaan obrolan sungguhan. Untuk kunci penuh, Anda dapat melakukan hingga 8 permintaan paralel dan 300 permintaan per menit; kunci uji coba memungkinkan 2 permintaan paralel dan 60 per menit. Setiap respons menyertakan X-Request-Id, X-Balance-USD dan header batas laju, yang berguna saat Anda melakukan debug.
Untuk mendapatkan kunci, daftar dan gunakan halaman kunci API, di mana pengguna baru dapat mengklaim kredit uji coba senilai $0,50 dengan satu klik. Dokumentasi mencakup streaming, pemanggilan fungsi, dan mode JSON setelah koneksi berhasil.
