KO ▾
API 키 받기

OpenAI 호환 API 엔드포인트: 지원 기능

이 서비스가 지원하는 OpenAI 호환 API 엔드포인트 목록, 각 항목의 작동 요청 및 누락된 항목의 명확한 목록.

업데이트

주요 포인트

  1. 5개 경로: 채팅 완성, 응답, 모델 및 두 가지 잔액 경로.
  2. 모델 ID는 uncensored이며, 이 키는 모든 OpenAI SDK와 호환됩니다.
  3. 이미지, 오디오, 비디오, 임베딩 또는 파인튜닝 없음.
  4. 제한 초과 시 HTTP 429와 명확한 오류 코드가 반환됩니다.
지원되는 API 엔드포인트 각각에 하나씩 연결된, 총 다섯 개의 케이블을 가진 중앙 허브

엔드포인트 개요

제공자가 실제로 구현한 OpenAI 스타일 경로는 무엇인가요? 이 API의 짧은 목록입니다. Base URL: https://api.uncensoredendpoint.com/v1. 인증은 모든 호출에 대한 베어러 키입니다.

메서드 및 경로목적
POST /v1/chat/completions채팅 요청, 스트리밍, 도구, JSON 모드
POST /v1/responses새로운 Responses 스타일 요청 형식
GET /v1/models모델을 나열합니다. ID는 uncensored입니다.
GET /v1/dashboard/billing/credit_grantsOpenAI 스타일의 잔액 형식
GET /v1/balance단순한 형태의 잔액

이것이 전체 범위입니다. 표에 없는 항목은 제공되지 않습니다. 코드 작성 전에 작동하는 요청과 누락된 목록을 확인하고 계획할 수 있도록 계속 읽으세요.

채팅 완성

이 엔드포인트는 대부분의 클라이언트가 사용합니다. 모든 OpenAI SDK를 베이스 URL에 연결하고 모델 이름 uncensored를 사용하세요.

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": "List three uses of a webhook."},
    ],
    temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)

지원되는 파라미터에는 stream, tools, tool_choice, response_format (json_object 설정), 그리고 샘플링 파라미터인 temperature, top_p, stop, seed과 페널티가 포함됩니다. max_tokens은 선택 사항입니다. 응답 생성은 100,000 토큰 컨텍스트 창에 남은 토큰을 모두 사용할 수 있기 때문입니다.

stream: true를 사용하면 응답이 서버 전송 이벤트로 도착하고 끝에 사용량이 포함되어 있으므로 토큰 수를 여전히 로깅할 수 있습니다.

다중 턴 채팅

API는 대화 상태를 유지하지 않습니다. 다중 턴 채팅의 경우 매번 전체 메시지 목록을 전송해야 합니다: 시스템 메시지 먼저, 그 다음 사용자 및 어시스턴트 턴을 교대로 보냅니다. 이는 입력 토큰이 턴이 거듭될수록 증가하고 비용도 증가함을 의미하므로, 대화가 길어지면 이전 턴을 줄이거나 요약해야 합니다. 프롬프트와 응답 생성을 합한 컨텍스트 창은 100,000 토큰이며, 이는 대부분의 채팅에 충분하지만 붙여넣은 문서로 쉽게 가득 차게 될 수 있습니다.

응답, 모델 및 잔액

응답

최신 OpenAI 예시는 /v1/responses를 사용합니다. 여기에서도 사용 가능하므로 해당 형식을 위해 작성된 코드는 다시 작성할 필요가 없습니다.

curl https://api.uncensoredendpoint.com/v1/responses \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "uncensored", "input": "Write a haiku about caching."}'

클라이언트가 기대하는 방식을 사용하세요. 처음부터 시작한다면 chat completions이 가장 넓은 도구 지원을 제공합니다.

모델 및 잔액

키가 작동하는지 확인하기 위해 모델을 나열하세요. 단일 항목 uncensored이 표시되어야 합니다. 이는 서비스가 하나의 모델을 실행하고 벤더 간 라우터가 아니기 때문입니다.

curl https://api.uncensoredendpoint.com/v1/models -H "Authorization: Bearer YOUR_KEY"

# remaining credit, OpenAI-style
curl https://api.uncensoredendpoint.com/v1/dashboard/billing/credit_grants -H "Authorization: Bearer YOUR_KEY"

# remaining credit, short form
curl https://api.uncensoredendpoint.com/v1/balance -H "Authorization: Bearer YOUR_KEY"

모든 응답의 X-Balance-USD 헤더에도 잔액이 포함되므로 추가 요청 없이 앱에서 낮은 크레딧 경고를 쉽게 설정할 수 있습니다. 다른 헤더에는 지원 문의를 위한 X-Request-Id, 그리고 X-RateLimit-Limit-Requests 및 X-RateLimit-Limit-Concurrency이 포함됩니다.

실제 도구 및 JSON 모드

두 가지 기능은 채팅 엔드포인트를 제품 구축의 기반으로 만듭니다. 도구 호출은 모델이 함수를 실행하도록 당신의 코드를 호출하게 합니다. JSON 모드는 구문 분석 가능한 출력을 반환하게 합니다. 둘 다 표준 요청 필드를 사용합니다.

도구 호출은 다음과 같습니다. 모델은 tool_calls 항목을 반환하고, 함수를 실행한 후 role: "tool" 메시지로 결과를 다시 보냅니다.

import json
from openai import OpenAI

client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")
tools = [{
    "type": "function",
    "function": {
        "name": "get_weather",
        "description": "Current weather for a city",
        "parameters": {
            "type": "object",
            "properties": {"city": {"type": "string"}},
            "required": ["city"],
        },
    },
}]

msgs = [{"role": "user", "content": "Weather in Oslo?"}]
r = client.chat.completions.create(model="uncensored", messages=msgs, tools=tools)
call = r.choices[0].message.tool_calls[0]
args = json.loads(call.function.arguments)

msgs.append(r.choices[0].message)
msgs.append({"role": "tool", "tool_call_id": call.id, "content": '{"temp_c": 4}'})
final = client.chat.completions.create(model="uncensored", messages=msgs, tools=tools)
print(final.choices[0].message.content)

JSON 모드에서는 response_format={"type": "json_object"}를 추가하고 프롬프트에서 JSON 형식을 원한다고 명시하세요. 이상적으로는 기대하는 키를 지정하세요. 항상 try 블록 내에서 응답을 파싱하세요: 모든 호출에서 모델이 스키마를 보장하지 않으므로, 신뢰하기 전에 결과를 검증해야 합니다.

기존 OpenAI 프로젝트 이동

앱이 이미 OpenAI SDK를 사용한다면 마이그레이션은 세 가지 수정과 새 라이브러리 없이 가능합니다. 대부분의 SDK는 동일한 두 환경 변수를 읽으므로 코드 변경이 필요 없을 수 있습니다.

export OPENAI_BASE_URL=https://api.uncensoredendpoint.com/v1
export OPENAI_API_KEY=YOUR_KEY
import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.uncensoredendpoint.com/v1", apiKey: process.env.KEY });
const r = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Ping" }],
});
console.log(r.choices[0].message.content);

그런 다음 코드에서 GPT 모델 ID와 같은 모델 이름을 찾아 uncensored로 교체하세요. 이 서비스는 하나의 모델만 제공합니다. 임베딩, 이미지 또는 오디오 호출을 제거하고 해당 요청을 다른 제공업체로 라우팅하세요. 짧은 체크리스트를 유지하세요: Base URL 변경, 모델 이름 변경, API 키를 저장소 대신 환경 변수에 저장, 429 에러에 대한 재시도 로직, 잔액 헤더를 기반으로 한 낮은 잔액 알림. 키 설정 방법은 uncensored AI API 키 얻는 방법을 참조하세요. 그런 다음 단일 테스트 요청을 실행하고 실제 트래픽을 전환하기 전에 X-Balance-USD 헤더가 반환되는지 확인하세요.

미제공 항목

누락된 항목을 알면 디버깅 시간을 하루 절약할 수 있습니다. 이 API는 텍스트 전용입니다. 다음 OpenAI 엔드포인트는 사용할 수 없습니다:

  • 이미지 및 시각 생성. 이미지 생성 또는 편집이 없습니다.
  • 오디오. 음성-텍스트 변환 또는 텍스트-음성 변환이 없습니다.
  • 비디오. 제공되지 않음.
  • 임베딩. 검색을 구축하려면 별도의 임베딩 서비스가 필요합니다.
  • 파인튜닝. 서비스에서 훈련할 수 없습니다.

이러한 경로에 대한 호출은 실패하므로 공유 클라이언트 구성에서 제외하세요. 일반적인 설정은 채팅에 이 API를 사용하고 임베딩에 다른 제공자를 사용하며, 앱은 작업당 베이스 URL을 선택합니다.

제한, 오류 및 재시도

전체 키는 동시 요청 8개와 분당 300개의 요청을 허용합니다. 체험 키는 동시 2개와 분당 60개를 허용합니다. 최대 본문 크기는 8 MB입니다. 제한을 초과하면 HTTP 429가 반환되며, 에러 코드로 인해 어떤 제한을 초과했는지 알 수 있습니다: 분당 요청 수 초과 시 rate_limited, 동시 요청 초과 시 concurrency. 일시적 과부하 시에도 429가 반환되며, Retry-After: 5 헤더가 포함됩니다.

주의할 점이 하나 있습니다: 스트리밍 요청은 스트리밍이 끝날 때까지 동시성 슬롯을 점유하므로, 느리게 읽는 클라이언트는 제한에 포함됩니다. 간단한 재시도 래퍼는 이를 모두 처리합니다:

import time
from openai import OpenAI, RateLimitError

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

def ask(prompt, tries=4):
    for i in range(tries):
        try:
            r = client.chat.completions.create(
                model="uncensored",
                messages=[{"role": "user", "content": prompt}],
            )
            return r.choices[0].message.content
        except RateLimitError:
            time.sleep(5 * (i + 1))
    raise RuntimeError("still rate limited")

실패하거나 거부된 요청에는 요금이 부과되지 않으므로 오류 발생 시 재시도해도 추가 비용이 들지 않습니다. 배치 작업의 경우 재시도에 의존하기보다 전체 키 기준 8, 체험 키 기준 2로 워커 풀을 제한하세요. 고정된 풀은 추론이 더 간단하며, 하나의 느린 스트림이 다른 스트림을 기아 상태로 만들지 않도록 합니다.

비용 및 접근

가격은 선불 크레딧에서 구독 또는 만료 없이 입력 토큰 1M당 $0.15, 출력 토큰 1M당 $0.50입니다. $20에서 $500 사이의 전체 금액으로 암호화폐(TRC20의 USDT, Base의 USDC)로 충전할 수 있습니다. 더 큰 충전에는 보너스가 추가됩니다: $50부터 +5%, $100부터 +10%, $200부터 +15%. 가격 페이지를 참조하세요.

시도하려면 Google 또는 이메일로 가입한 후 API 키 페이지에서 한 번의 클릭으로 $0.50 체험 크레딧을 청구하세요. 문서은 각 매개변수를 다루며, 엔드포인트 개요은 서비스의 성격을 설명합니다: 합법적인 성인 사용자를 위한 하나의 오픈 웨이트 모델, 콘텐츠 거부 없음 및 미성년자 관련 성 콘텐츠에 대한 엄격한 금지.

질문과 답변

스트리밍과 함수 호출을 지원하나요?

네. 서버 전송 이벤트(SSE)를 사용하고 마지막에 사용량 정보를 얻으려면 stream: true를 설정하세요. 함수 호출에는 tools와 tool_choice를 사용하세요.

임베딩 엔드포인트가 있나요?

아니요. 본 서비스는 텍스트 채팅 전용이므로 임베딩은 다른 제공업체를 사용하세요.

잔액을 어떻게 확인합니까?

GET /v1/balance 또는 OpenAI 스타일의 credit_grants 경로를 호출하거나, 모든 응답에서 X-Balance-USD 헤더를 읽으세요.

속도 제한에 도달하면 어떻게 되나요?

rate_limited 또는 concurrency 코드로 HTTP 429를 받습니다. 기다렸다가 다시 시도하세요. 일시적 과부하 시 Retry-After 헤더에 5초가 표시됩니다.

키는 양식 하나만 작성하면 받을 수 있습니다

계정을 생성하고 키를 복사한 후 기본 URL을 변경하세요. 설정은 이것으로 끝입니다.

API 키 받기문서 읽기