ID ▾

Base URL API GPT: Cara Mengaturnya untuk Klien OpenAI Apa Pun

Base URL adalah satu pengaturan yang menentukan server mana yang dituju oleh klien gaya OpenAI Anda. Ubah itu, ubah kunci dan nama model, dan sisa kode Anda tetap seperti semula.

Diperbarui

Panah penunjuk mengarahkan paket data dari satu server ke server lain, mengilustrasikan perubahan base URL

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.py

Ini 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 /v1 dan bukan hanya nama host. Tanpa /v1 SDK membangun path yang tidak ada.
  • Path ganda. Jika Anda menempelkan .../v1/chat/completions sebagai 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-4o yang tersisa dari kode asli tidak akan cocok. Tetapkan uncensored.
  • 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_limited berarti terlalu banyak permintaan per menit; kode concurrency berarti terlalu banyak sekaligus. Header Retry-After: 5 pada 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.

Tanya jawab

Apa base URL untuk API Anda?

Ini adalah https://api.uncensoredgptapi.com/v1. Sertakan bagian /v1 dan hilangkan path endpoint.

Nama model mana yang harus saya gunakan?

Gunakan uncensored. Nama model dari penyedia lain, seperti gpt-4o, tidak tersedia di sini.

Dapatkah saya menggunakan kode SDK OpenAI saya yang ada?

Ya. Ubah base URL, kunci API, dan nama model. Penyelesaian obrolan, streaming, pemanggilan fungsi, dan mode JSON mengikuti format permintaan yang sama.

Variabel OPENAI_BASE_URL berfungsi?

SDK OpenAI resmi membacanya ketika tidak ada base URL yang diteruskan dalam kode, sehingga mengaturnya seringkali sudah cukup. Periksa alat yang Anda gunakan, karena beberapa di antaranya mengabaikannya.

Mengapa saya mendapatkan kesalahan 429?

Kode rate_limited berarti terlalu banyak permintaan per menit, dan kode concurrency berarti terlalu banyak permintaan sekaligus. HTTP 429 dengan Retry-After 5 menandakan kelebihan beban sementara, jadi coba lagi setelah lima detik.

Kunci Anda hanya selangkah lagi dari satu formulir

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

Dapatkan kunci API