주요 포인트
- 우리의 base URL은 https://api.uncensoredgptapi.com/v1이며 모델 ID는
uncensored입니다. - Python 및 Node SDK는 base_url 또는 baseURL을 사용하며 둘 다 환경 변수도 읽습니다.
- 대부분의 실패는 /v1 누락, 중복 경로 또는 오래된 모델 이름에서 비롯됩니다.
- GET /v1/models은 URL과 키가 올바른지 확인하는 가장 빠른 방법입니다.
base URL의 역할
gpt api base_url은 OpenAI SDK가 모든 엔드포인트 경로 앞에 붙이는 주소입니다. 기본적으로 공식 SDK는 OpenAI 서버로 요청을 보냅니다. 다른 base URL을 설정하면 동일한 클라이언트 코드가 동일한 프로토콜을 사용하는 다른 서버로 동일한 요청 형식을 보냅니다.
실제로 OpenAI 호환이라는 것은 이것뿐입니다. 우리 API는 동일한 JSON 구조, 동일한 Authorization: Bearer 헤더 및 동일한 스트리밍 형식으로 POST /v1/chat/completions 및 GET /v1/models을 받습니다. 따라서 세 가지 값을 변경합니다:
- Base URL:
https://api.uncensoredgptapi.com/v1 - API 키: 대시보드의 키
- 모델:
uncensored
당사의 서비스는 단일 오픈 웨이트 모델을 실행하는 독립적인 서비스입니다. OpenAI의 API가 아니며 다른 공급업체로의 라우터도 아니므로 gpt-4o와 같은 모델 이름은 여기에서 존재하지 않습니다. 모든 곳에 uncensored를 사용하세요.
OpenAI SDK를 사용한 Python
현재 Python SDK에서는 클라이언트를 생성할 때 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를 사용하는 경우, 이는 1.0 이전 SDK에 해당하며 전역 설정의 이름이 다릅니다. 패키지를 업그레이드하는 것이 수정하는 것보다 일반적으로 더 쉽습니다. pip show openai로 버전을 확인하세요.
SDK가 요청을 구성하는 방식을 아는 것이 도움이 됩니다. SDK는 base URL을 가져다가 /chat/completions과 같은 엔드포인트 경로를 붙이고, 키에서 Authorization: Bearer 헤더를 추가합니다. 이것이 전체 메커니즘입니다. 문제가 발생하면 최종 URL을 출력하거나 로그에 남기고, 다음 섹션의 curl 명령어와 비교하세요.
동일한 클라이언트는 timeout 및 max_retries 설정을 허용합니다. 기본값은 연결 문제 발생 시 몇 번 다시 시도하므로 대부분의 스크립트에 적합합니다. 속도 제한의 경우 SDK의 속도 제한 예외를 캐치하고 대기 시간을 늘리세요. 스트리밍된 요청은 종료될 때까지 동시성 슬롯을 유지하므로 분당 요청 수가 낮더라도 긴 스트림의 급증으로 인해 동시성 제한에 도달할 수 있습니다.
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초의 대기는 API가 일시적인 과부하 시 보내는 Retry-After: 5 값과 일치합니다. 이후 시도마다 더 오래 기다리면 엔드포인트에 과도한 요청이 가지 않습니다.
Node 및 curl
Node SDK는 URL을 대문자로 쓴 baseURL을 사용합니다.
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가 나머지를 추가합니다.
환경 변수
코드를 편집할 수 없거나 여러 스크립트에 하나의 설정을 원하는 경우 OpenAI SDK는 명시적인 값이 제공되지 않을 때 환경에서 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이것은 직접 작성하지 않은 도구에 유용합니다. OpenAI SDK를 기반으로 한 모든 도구는 변경 없이 변수를 가져올 수 있지만 도구 내에서 모델 이름을 uncensored로 설정해야 합니다. 도구가 모델을 하드 코딩한 경우 자체 설정 또는 코드 변경이 필요합니다.
두 엔드포인트 분리 유지
많은 프로젝트는 하나의 엔드포인트에서 테스트하고 다른 엔드포인트로 출시하거나 환경에 따라 전환합니다. 세 가지 값을 코드에서 분리하고 구성에서 읽도록 하여 전환을 파일 변경으로만 처리할 수 있게 하세요.
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를 읽는 도구는 설정된 키를 바로 옆에 설정된 base URL로 보냅니다. 프로필에 오래된 OpenAI 키가 있고 프로젝트에 새로운 base URL이 있으면 한 서비스의 키를 다른 서비스에 보낼 수 있습니다. 이름을 구분하면 이를 방지할 수 있으며, 스크립트가 사용할 엔드포인트를 한눈에 확인할 수 있습니다.
모델 이름도 구성으로 취급하세요. 이는 전환 시 가장 자주 남겨지는 값이며 다른 모든 것이 올바르게 보이는 가장 혼란스러운 실패를 유발합니다.
스트리밍 및 도구는 동일한 base URL을 사용합니다
base URL 변경은 기능을 제한하지 않습니다. 스트리밍, 도구 호출 및 JSON 모드는 동일한 /chat/completions 경로를 거치므로 원래 API에서 작동하던 코드가 계속 작동합니다. 스트리밍은 스트림 끝에 사용량이 보고되는 서버 전송 이벤트를 반환합니다.
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에 대한 검사가 중요합니다. 사용량 정보를 담은 마지막 청크에는 choices가 없을 수 있으며, 빈 목록에 인덱싱하는 코드는 마지막 메시지에서 크래시가 발생할 수 있습니다. 도구 호출은 함수 실행 전에 조립할 부분 tool_calls 델타로 스트리밍되며, 결과는 role: "tool" 메시지로 반환됩니다. JSON 모드는 response_format={"type": "json_object"}을 사용합니다.
base URL 필드가 있는 앱 및 프레임워크
많은 앱은 다른 이름으로 동일한 설정을 노출합니다: API base, endpoint, 사용자 정의 OpenAI URL 또는 호스트. 규칙은 동일합니다. base URL을 /v1 포함하여 붙여넣고 키를 붙여넣은 후 모델 이름으로 uncensored을 입력하세요.
예를 들어 SillyTavern은 OpenAI 호환 엔드포인트를 추가할 수 있습니다. LangChain의 ChatOpenAI 클래스는 base_url 인수를 허용합니다. 다른 프론트엔드는 필드를 프록시 URL 또는 리버스 프록시라고 부릅니다. 필드 이름은 버전마다 다르므로 /v1로 끝나는 URL을 받는 필드를 찾으세요.
일부 앱은 GET /v1/models 호출로 채워진 드롭다운에서 모델을 요청합니다. 해당 엔드포인트는 여기에서 작동하며 모델 목록을 반환하므로 URL과 키가 올바르면 드롭다운에 uncensored이 표시되어야 합니다. 비어 있으면 URL 또는 키가 잘못되었습니다.
앱이 base URL 필드와 "organization" 또는 "project" 필드를 모두 제공하는 경우 추가 필드를 비워두세요. 이러한 필드는 원래 서비스용이며 여기에서는 의미가 없습니다. 앱이 특정 접두사로 시작하는 키를 요구하는 경우 원래 서비스용 프리셋 대신 일반 또는 사용자 정의 OpenAI 호환 옵션과 같은 다른 연결 유형을 시도하세요.
일부 데스크톱 도구는 원래 제공업체에서 특정 모델 이름을 요청하여 연결을 테스트하며, 엔드포인트가 정상임에도 실패를 보고합니다. 이 경우 테스트 버튼을 건너뛰고 실제 메시지를 보내세요. 응답이 도착하면 URL, 키 및 모델이 정확하며, 도구는 검사에서 너무 엄격하게 동작하는 것입니다.
브라우저 기반 도구도 교차 출처 규칙으로 인해 문제가 발생할 수 있습니다. 요청이 다른 호스트로 페이지를 벗어나기 때문입니다. 브라우저에서 웹 도구가 실패하지만 동일한 호출이 curl에서 작동하는 경우 키가 클라이언트 측 코드에 남지 않도록 자체 작은 서버에서 요청을 실행하세요. 이는 어쨌든 더 안전한 디자인입니다.
일반적인 실수 및 수정 방법
거의 모든 실패된 설정은 짧은 목록에서 비롯됩니다.
- /v1 누락. base URL은
https://api.uncensoredgptapi.com/v1이며, 호스트 이름뿐만 아니라/v1까지의 전체 주소입니다./v1이 없으면 SDK가 존재하지 않는 경로를 생성합니다. - 중복 경로. base URL로
.../v1/chat/completions을 붙여넣으면 SDK가 경로를 다시 추가합니다. base만 제공하세요. - 후행 슬래시. 대부분의 SDK는 처리하지만 일부 도구는 처리하지 않습니다. 슬래시 없이 시도해 보세요.
- 오래된 모델 이름. 원래 코드에서 남은
gpt-4o와 같은 모델 이름은 일치하지 않습니다.uncensored를 설정하세요. - 잘못된 키. 이 서비스의 키를 사용하세요. OpenAI 키는 여기에서 작동하지 않으며 우리의 키는 OpenAI에서 작동하지 않습니다.
- 속도 제한 오류 HTTP 429 상태 코드
rate_limited은 분당 요청 수가 초과되었음을 의미하며, 코드concurrency은 동시에 너무 많은 요청이 발생했음을 의미합니다.Retry-After: 5헤더가 포함된 429 응답은 일시적인 과부하를 나타내므로 5초 후 다시 시도해야 합니다.
문제 해결 가이드에서는 통합 오류를 더 자세히 설명합니다.
한 번의 호출로 설정 확인
전체 애플리케이션을 실행하기 전에 모델 엔드포인트를 호출하세요. 비용이 저렴하며 URL과 API 키가 함께 유효한지 확인할 수 있습니다.
curl https://api.uncensoredgptapi.com/v1/models \
-H "Authorization: Bearer $API_KEY"uncensored가 포함된 목록이 반환되면 실제 채팅 요청을 보내세요. 전체 키의 경우 최대 8개의 동시 요청과 분당 300개의 요청이 허용되며, 체험 키는 분당 60개의 요청과 2개의 동시 요청만 허용합니다. 각 응답에는 X-Request-Id, X-Balance-USD 및 디버깅에 유용한 속도 제한 헤더가 포함됩니다.
키를 얻으려면 가입하고 API 키 페이지를 사용하여 새 사용자가 한 번의 클릭으로 $0.50 무료 체험 크레딧을 받을 수 있습니다. 문서는 연결이 작동한 후 스트리밍, 도구 호출 및 JSON 모드에 대해 다룹니다.
