ประเด็นสำคัญ
- Base URL ของเราคือ https://api.uncensoredgptapi.com/v1 และ model ID คือ
uncensored - SDK สำหรับ Python และ Node.js รับค่า base_url หรือ baseURL; ทั้งสองยังอ่านค่าจากตัวแปรสภาพแวดล้อม (environment variables) ได้
- ข้อผิดพลาดส่วนใหญ่เกิดจากการขาด /v1, การมี path ซ้ำ หรือการใช้ชื่อโมเดลเก่า
- การเรียก GET /v1/models เป็นวิธีที่เร็วที่สุดในการยืนยันว่า URL และคีย์ถูกต้อง
หน้าที่ของ base URL
gpt api base_url คือที่อยู่ที่ SDK ของ OpenAI เติมไว้หน้าเส้นทางเอนด์พอยต์ทุกเส้นทาง โดยค่าเริ่มต้น SDK ทางการจะส่งคำขอไปยังเซิร์ฟเวอร์ของ OpenAI หากคุณตั้งค่า base URL อื่น ไคลเอนต์โค้ดเดิมจะส่งรูปแบบคำขอเดียวกันไปยังเซิร์ฟเวอร์อื่นที่รองรับโปรโตคอลเดียวกัน
นั่นคือความหมายในทางปฏิบัติของคำว่า "เข้ากันได้กับ OpenAI" API ของเรารองรับ POST /v1/chat/completions และ GET /v1/models ด้วยโครงสร้าง JSON เดียวกัน, header Authorization: Bearer เดียวกัน และรูปแบบการสตรีมมิงเดียวกัน ดังนั้นคุณจึงต้องเปลี่ยนค่าสามค่า:
- Base URL:
https://api.uncensoredgptapi.com/v1 - คีย์ API: คีย์จากแดชบอร์ดของคุณ
- โมเดล:
uncensored
บริการของเราเป็นบริการอิสระที่รันโมเดล open-weight model เพียงตัวเดียว ไม่ใช่ API ของ OpenAI และไม่ใช่ router ไปยังผู้ขายรายอื่น ดังนั้นชื่อโมเดลเช่น gpt-4o จึงไม่มีที่นี่ ให้ใช้ uncensored ทุกที่
Python กับ SDK ของ OpenAI
ใน SDK ของ Python เวอร์ชันปัจจุบัน ให้ส่งค่า base_url เมื่อคุณสร้างไคลเอนต์
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)หากโค้ดของคุณเก่าและใช้ openai.api_base แสดงว่าคุณใช้ SDK เวอร์ชันก่อน 1.0 ซึ่งการตั้งค่าแบบ global มีชื่อต่างกัน การอัปเดตแพ็กเกจมักง่ายกว่าการปรับโค้ด ตรวจสอบเวอร์ชันด้วย pip show openai
การเข้าใจวิธีที่ SDK สร้างคำขอจะช่วยให้เข้าใจระบบได้ดีขึ้น SDK จะนำ base URL ของคุณมาต่อด้วยเส้นทางเอนด์พอยต์ เช่น /chat/completions และเพิ่ม header Authorization: Bearer จากคีย์ของคุณ นั่นคือกลไกทั้งหมด เมื่อเกิดข้อผิดพลาด ให้พิมพ์หรือบันทึก URL สุดท้าย แล้วเปรียบเทียบกับคำสั่ง curl ในส่วนถัดไป
ไคลเอนต์ชุดเดียวกันรองรับการตั้งค่า timeout และ max_retries ค่าเริ่มต้นจะลองใหม่หลายครั้งเมื่อเกิดปัญหาการเชื่อมต่อ ซึ่งเพียงพอสำหรับสคริปต์ส่วนใหญ่ สำหรับ rate limit ให้ดักจับข้อยกเว้น rate limit ของ SDK แล้วหยุดชั่วคราว การเรียกแบบสตรีมมิงจะครอบครอง slot concurrency ไว้จนกว่าจะจบ ดังนั้นการสตรีมมิงที่ยาวนานจำนวนมากอาจชนกับขีดจำกัด concurrency ได้ แม้จำนวนคำขอต่อนาทีของคุณจะต่ำ
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")เวลารอ 5 วินาทีในการลองครั้งแรกตรงกับค่า Retry-After: 5 ที่ API ส่งมาเมื่อโหลดเกินชั่วคราว การรอให้นานขึ้นในแต่ละครั้งถัดไปช่วยหลีกเลี่ยงการส่งคำขอซ้ำๆ ไปยัง endpoint
Node และ curl
SDK ของ Node.js ใช้ baseURL โดยเขียน 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);หากไม่มี SDK curl จะแสดงสิ่งที่ SDK ทำได้ชัดเจนที่สุด URL เต็มคือ base URL บวกกับ /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"}]}'การอ่านคำสั่งนั้นเป็นวิธีที่ชัดเจนที่สุดในการทำความเข้าใจ base URL: ทุกอย่างจนถึงและรวมถึง /v1 คือ base และ SDK จะเพิ่มส่วนที่เหลือ
ตัวแปรสภาพแวดล้อม
หากคุณไม่สามารถแก้ไขโค้ด หรือต้องการตั้งค่าหนึ่งค่าสำหรับหลายสคริปต์ SDK ของ OpenAI จะอ่านค่า OPENAI_BASE_URL และ OPENAI_API_KEY จากสภาพแวดล้อมเมื่อไม่มีการระบุค่าชัดเจน
export OPENAI_BASE_URL="https://api.uncensoredgptapi.com/v1"
export OPENAI_API_KEY="YOUR_API_KEY"
python my_script.pyสิ่งนี้มีประโยชน์สำหรับเครื่องมือที่คุณไม่ได้เขียนเอง เครื่องมือใดๆ ที่สร้างบน SDK ของ OpenAI อาจดึงตัวแปรเหล่านี้มาใช้งานได้โดยไม่ต้องแก้ไข แม้ว่าคุณจะต้องตั้งค่าชื่อโมเดลเป็น uncensored ภายในเครื่องมือก็ตาม หากเครื่องมือบันทึกชื่อโมเดลไว้ตายตัว คุณต้องตั้งค่าเฉพาะหรือแก้ไขโค้ด
การแยกสอง endpoint
โปรเจกต์จำนวนมากทดสอบกับเอนด์พอยต์หนึ่งและใช้งานจริงกับอีกเอนด์พอยต์หนึ่ง หรือสลับระหว่างกันตามสภาพแวดล้อม ให้เก็บค่าสามค่านี้นอกโค้ดของคุณและอ่านจากไฟล์กำหนดค่า ดังนั้นการสลับจึงเป็นการแก้ไขไฟล์ ไม่ใช่แก้ไขโค้ด
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")การใช้ชื่อตัวแปรของคุณเองแทนค่าเริ่มต้นของ SDK ช่วยหลีกเลี่ยงกับดักเงียบ: เครื่องมือที่อ่าน OPENAI_API_KEY จาก shell จะส่งคีย์ใดๆ ที่ตั้งค่าไว้ที่นั่นไปยัง base URL ที่ตั้งค่าถัดไป หากคุณมีคีย์ OpenAI เก่าในโปรไฟล์ของคุณและ base URL ใหม่ในโปรเจกต์ คุณอาจส่งคีย์ของบริการหนึ่งไปยังบริการอื่นได้ ชื่อที่แยกจากกันทำให้สิ่งนั้นเป็นไปไม่ได้ และคุณสามารถดูได้ทันทีว่าสคริปต์จะใช้ endpoint ใด
ให้ถือว่าชื่อโมเดลเป็นการกำหนดค่าด้วย เป็นค่าที่มักหลงเหลือเมื่อคุณเปลี่ยน และทำให้เกิดความล้มเหลวที่สับสนที่สุด เนื่องจากทุกอย่างดูถูกต้อง
สตรีมมิงและเครื่องมือใช้ base URL เดียวกัน
การเปลี่ยน base URL ไม่จำกัดฟีเจอร์ สตรีมมิง การเรียกใช้เครื่องมือ และโหมด JSON ล้วนผ่านเส้นทาง /chat/completions เดียวกัน ดังนั้นโค้ดที่ทำงานกับ API ดั้งเดิมจึงยังคงทำงานต่อไปได้ สตรีมมิงส่งคืน Server-Sent Events โดยมีการรายงานการใช้งานที่ท้ายสตรีม
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()การตรวจสอบ chunk.choices สำคัญมาก chunk สุดท้ายที่บรรจุข้อมูลการใช้งานอาจไม่มี choices และโค้ดที่เข้าถึงรายการว่างจะเกิดข้อผิดพลาดที่ข้อความสุดท้าย การเรียกใช้เครื่องมือสตรีมในลักษณะเดียวกัน โดยเป็น delta ของ tool_calls ส่วนย่อยที่คุณประกอบรวมกันก่อนเรียกใช้ฟังก์ชัน และผลลัพธ์จะส่งกลับเป็นข้อความที่มี role: "tool" โหมด JSON ใช้ response_format={"type": "json_object"}
แอปและเฟรมเวิร์กที่มีช่องกรอก base URL
แอปจำนวนมากเปิดการตั้งค่าเดียวกันภายใต้ชื่อที่แตกต่างกัน: API base, endpoint, custom OpenAI URL หรือ host กฎเดียวกันนี้ใช้ได้ วาง base URL พร้อม /v1 วางคีย์ และพิมพ์ uncensored เป็นชื่อโมเดล
SillyTavern ตัวอย่างเช่น อนุญาตให้คุณเพิ่ม endpoint ที่เข้ากันได้กับ OpenAI คลาส ChatOpenAI ของ LangChain รับอาร์กิวเมนต์ base_url หน้าเว็บอื่นๆ เรียกช่องกรอกนี้ว่า proxy URL หรือ reverse proxy ชื่อช่องกรอกแตกต่างกันไปตามเวอร์ชัน ดังนั้นให้มองหาช่องกรอกที่รับ URL ที่ลงท้ายด้วย /v1
แอปบางรายการขอเลือกโมเดลจากเมนูแบบเลื่อนลงที่เติมข้อมูลโดยการเรียก GET /v1/models เอนด์พอยต์นี้ใช้งานได้ที่นี่และส่งคืนรายการโมเดล ดังนั้นเมนูแบบเลื่อนลงควรแสดง uncensored เมื่อ URL และคีย์ถูกต้อง หากยังคงว่าง แสดงว่า URL หรือคีย์ผิด
เมื่อแอปมีช่องกรอก base URL และช่องกรอก "organization" หรือ "project" ให้เว้นช่องกรอกเพิ่มเติมให้ว่าง ช่องกรอกเหล่านี้มีไว้สำหรับบริการดั้งเดิมและไม่มีนัยยะที่นี่ หากแอปบังคับใช้คีย์ที่ขึ้นต้นด้วยคำนำหน้าเฉพาะ ให้ลองประเภทการเชื่อมต่ออื่น เช่น ตัวเลือกที่เข้ากันได้กับ OpenAI แบบทั่วไปหรือแบบกำหนดเอง แทนตัวเลือกกำหนดค่าล่วงหน้าสำหรับบริการดั้งเดิม
เครื่องมือบางตัวบนเดสก์ท็อปทดสอบการเชื่อมต่อโดยขอชื่อโมเดลเฉพาะจากผู้ให้บริการต้นทาง และรายงานความล้มเหลวแม้เอนด์พอยต์จะปกติ ในกรณีนั้น ให้ข้ามปุ่มทดสอบแล้วส่งข้อความจริงแทน หากได้รับคำตอบ แสดงว่า URL คีย์ และโมเดลถูกต้อง เครื่องมือนี้เพียงตรวจสอบอย่างเข้มงวด
เครื่องมือที่ทำงานบนเบราว์เซอร์อาจประสบกับกฎ cross-origin เนื่องจากคำขอออกจากหน้าเว็บไปยังโฮสต์อื่น หากเครื่องมือเว็บล้มเหลวในเบราว์เซอร์แต่คำขอเดียวกันทำงานได้ใน curl ให้รันคำขอจากเซิร์ฟเวอร์ขนาดเล็กของคุณเองเพื่อให้คีย์อยู่นอกโค้ดฝั่งไคลเอนต์ ซึ่งเป็นการออกแบบที่ปลอดภัยกว่าในกรณีใดๆ
ข้อผิดพลาดทั่วไปและวิธีแก้ไข
การตั้งค่าที่ล้มเหลวเกือบทั้งหมดมาจากรายการสั้นๆ
- ขาด /v1. Base URL คือ
https://api.uncensoredgptapi.com/v1ที่อยู่ทั้งหมดจนถึง/v1ไม่ใช่แค่ชื่อโฮสต์ หากไม่มี/v1SDK จะสร้างเส้นทางที่ไม่มีอยู่จริง - เส้นทางซ้ำ. หากคุณวาง
.../v1/chat/completionsเป็น base URL SDK จะเพิ่มเส้นทางอีกครั้ง ให้ใส่เฉพาะ base - สแลชท้าย (trailing slash) SDK ส่วนใหญ่จัดการได้ แต่เครื่องมือบางตัวทำไม่ได้ ลองใช้แบบไม่มีสแลช
- ชื่อโมเดลเก่า. ชื่อโมเดลเช่น
gpt-4oที่เหลือมาจากโค้ดดั้งเดิมจะไม่ตรงกัน ตั้งค่าuncensored - คีย์ผิด. ใช้คีย์จากบริการนี้ คีย์ OpenAI ไม่สามารถใช้ที่นี่ได้ และคีย์ของเราไม่สามารถใช้กับ OpenAI ได้
- ข้อผิดพลาดขีดจำกัดอัตรา. HTTP 429 พร้อมโค้ด
rate_limitedหมายถึงคำขอมากเกินไปต่อนาที; โค้ดconcurrencyหมายถึงคำขอพร้อมกันมากเกินไป 429 พร้อมheaderRetry-After: 5ระบุการโอเวอร์โหลดชั่วคราว ดังนั้นให้รอห้าวินาทีแล้วลองใหม่
คู่มือการแก้ปัญหาของเราอธิบายข้อผิดพลาดในการผสานรวมโดยละเอียดมากขึ้น
ตรวจสอบการตั้งค่าด้วยการเรียกครั้งเดียว
ก่อนเรียกใช้แอปพลิเคชันทั้งหมด ให้เรียกใช้เอนด์พอยต์โมเดล ค่าใช้จ่ายต่ำและยืนยัน URL กับคีย์ไปพร้อมกัน
curl https://api.uncensoredgptapi.com/v1/models \
-H "Authorization: Bearer $API_KEY"หากผลลัพธ์เป็นรายการที่มี uncensored ให้ส่งคำขอแชทจริง สำหรับคีย์แบบเต็ม คาดว่าจะรองรับคำขอพร้อมกันได้สูงสุด 8 คำขอ และ 300 คำขอต่อนาที; คีย์ทดลองรองรับคำขอพร้อมกัน 2 คำขอ และ 60 คำขอต่อนาที แต่ละการตอบกลับมี X-Request-Id, X-Balance-USD และheader ขีดจำกัดอัตรา ซึ่งจะมีประโยชน์เมื่อคุณแก้ไขข้อบกพร่อง
เพื่อรับคีย์ ให้สมัครสมาชิกและใช้ หน้าคีย์ API ซึ่งผู้ใช้ใหม่สามารถขอเครดิตทดลองใช้ $0.50 ได้ด้วยการคลิกหนึ่งครั้ง เอกสาร ครอบคลุมการสตรีมมิง การเรียกใช้ฟังก์ชัน และโหมด JSON เมื่อการเชื่อมต่อทำงานได้แล้ว
