KO ▾
https://api.unrestrictedaiapi.com/v1uncensored2026-10-06
API 키 받기

OpenAI 호환 API 스펙: 지원 사항

여기의 OpenAI 호환 API 스펙은 매우 단순합니다: 두 가지 메서드, Bearer 토큰 인증, 그리고 익숙한 채팅 생성 요청 및 응답 형식입니다. 이 페이지는 지원되는 기능, 지원되지 않는 기능, 그리고 제한 사항과 오류의 동작 방식을 정확히 나열합니다.

업데이트됨

입력, 중앙 노드 및 데이터 스트림이 흐르는 API의 구조도

주요 포인트

  1. 두 가지 메서드만 지원: POST /v1/chat/completions과 GET /v1/models.
  2. 스트리밍, 함수 호출, JSON 모드는 지원되지만 임베딩, 이미지, 오디오는 지원되지 않습니다.
  3. 전체 키의 경우 동시 8개, 분당 300개의 제한이 있으며, 체험용 키는 각각 2개와 60개로 제한됩니다.
  4. 429는 속도 제한, 동시 요청 초과 또는 일시적 과부하를 의미할 수 있으며 Retry-After: 5가 포함됩니다.

스펙 요약

이미 OpenAI와 통신하는 코드가 있다면, OpenAI 호환 API 스펙의 핵심은 Base URL을 변경하고 키를 설정한 후 모델을 uncensored로 지정하는 것입니다. 요청 및 응답 본문은 채팅 생성 형식을 따르므로 SDK는 변경 없이 이를 구문 분석합니다.

항목내용
기본 URLhttps://api.unrestrictedaiapi.com/v1
인증Authorization: Bearer YOUR_KEY
HTTP 메서드POST /v1/chat/completions, GET /v1/models
모델 IDuncensored
컨텍스트 창100,000 토큰, 프롬프트 및 완성 포함
최대 요청 본문8 MB
출력텍스트 전용

이 모델은 독립적인 제공업체가 운영하는 단일 오픈 웨이트 모델로, 합법적인 성인 사용에 대해 콘텐츠 거부 없이 답변하도록 조정되었습니다. 이는 공식 모델 벤더의 엔드포인트가 아니며 벤더 간 라우팅도 수행하지 않습니다. 따라서 모델 ID가 하나만 존재하고 모델 목록이 짧은 것입니다.

HTTP 메서드

GET /v1/models

귀하의 키로 사용할 수 있는 모델을 반환합니다. 키와 Base URL이 올바른지 확인하는 가장 효율적인 방법이며, 많은 UI 클라이언트는 드롭다운을 채우기 위해 이를 호출합니다.

curl https://api.unrestrictedaiapi.com/v1/models \
  -H "Authorization: Bearer $KEY"

POST /v1/chat/completions

유일한 생성 엔드포인트입니다. messages 객체 배열을 보내야 합니다. 여기에는 role(system, user, assistant 또는 tool)과 content이 포함되어야 하며, 모델과 샘플링 옵션도 지정해야 합니다. 최소 호출 예시:

curl https://api.unrestrictedaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "Answer in one sentence."},
      {"role": "user", "content": "What is a base URL?"}
    ]
  }'

응답에는 생성된 텍스트가 choices[0].message.content에, 토큰 개수가 usage에 포함됩니다. 이 개수가 청구의 기준이 됩니다.

제공되지 않음: 레거시 completions 엔드포인트, embeddings, image, audio, video 엔드포인트, fine-tuning 및 file 엔드포인트. 이러한 엔드포인트를 호출하는 클라이언트는 오류를 받으므로, 기본적으로 이를 사용하는 도구에서 해당 기능을 비활성화하세요.

요청 매개변수

다음 매개변수는 허용되며 모델에 전달됩니다:

  • temperature 및 top_p은 샘플링을 위해 사용됩니다.
  • stop 하나 이상의 중지 시퀀스용.
  • seed 다른 조건을 동일하게 유지할 때 반복 가능한 샘플링용.
  • 반복을 줄이려면 presence_penalty 및 frequency_penalty을 사용하세요.
  • max_tokens (선택 사항). 이 값을 지정하지 않으면 생성 결과가 100,000 토큰 컨텍스트 창의 나머지 부분을 사용할 수 있습니다.
  • stream 서버 전송 이벤트용.
  • tools 및 tool_choice은 함수 호출을 위해 사용됩니다.
  • JSON 모드를 사용하려면 response_format에 {"type":"json_object"}을 설정하세요.

두 가지 실용적인 참고 사항이 있습니다. 첫째, 컨텍스트 창은 프롬프트와 생성 결과를 합산하므로, 90,000 토큰의 프롬프트는 답변에 약 10,000 토큰만 남깁니다. 둘째, 본문 제한은 8 MB로, 100,000 토큰 텍스트에 필요한 용량보다 훨씬 크므로, 메시지에 큰 인코딩된 페이로드를 포함할 때만 이 제한에 도달합니다.

스트리밍

stream: true를 설정하면 응답이 서버 전송 이벤트로 도착합니다. 각 이벤트는 다음 텍스트 조각을 포함하는 delta를 가진 JSON 청크이며, 사용량은 스트림 끝에 보고됩니다. SDK는 프레임 구조를 숨기지만, 원시 프로토콜을 사용할 경우 스트림이 닫힐 때까지 data:로 시작하는 줄을 읽어야 합니다.

from openai import OpenAI

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

with client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "List five HTTP status codes."}],
    stream=True,
) as stream:
    for chunk in stream:
        if chunk.choices and chunk.choices[0].delta.content:
            print(chunk.choices[0].delta.content, end="")

용량 계획에 영향을 미치는 한 가지 규칙은 스트리밍 요청이 첫 번째 토큰이 아닌 스트림이 끝날 때까지 동시 요청 슬롯을 유지한다는 것입니다. 클라이언트가 읽는 동안 중단되면 슬롯이 계속 점유됩니다. 항상 스트림을 닫거나 완료하고 클라이언트 시간 제한을 설정하세요.

도구 호출 및 JSON 모드

함수 호출

JSON 스키마 매개변수가 있는 함수 정의 목록으로 tools을 전달합니다. 모델이 함수를 호출하기로 결정하면 메시지에 tool_calls이 포함되며, 이는 stream이 활성화된 경우에도 스트리밍됩니다. 함수를 실행하고 결과를 role: "tool" 및 일치하는 tool_call_id과 함께 메시지 형태로 다시 보냅니다. tool_choice을 사용하여 특정 함수를 강제하거나 모델이 결정하도록 맡길 수 있습니다.

{
  "model": "uncensored",
  "messages": [{"role": "user", "content": "Weather in Oslo?"}],
  "tools": [{
    "type": "function",
    "function": {
      "name": "get_weather",
      "description": "Current weather for a city",
      "parameters": {
        "type": "object",
        "properties": {"city": {"type": "string"}},
        "required": ["city"]
      }
    }
  }]
}

모델은 인수를 제안할 뿐 실행하지 않습니다. 사용자 입력을 처리할 때와 마찬가지로 실행하기 전에 인수를 검증하세요.

JSON 모드

"response_format": {"type": "json_object"}를 추가해 유효한 JSON 객체 하나를 요청하세요. 다른 OpenAI 스타일 구현체와 마찬가지로 프롬프트에서 원하는 키를 모델에 알려주세요. 예를 들어 "title과 tags 키가 있는 객체를 반환하세요"라고 지정합니다. 결과는 어쨌든 try 블록에서 파싱하고, 긴 객체가 잘리지 않도록 max_tokens 값을 넉넉히 유지하세요.

제한, 헤더 및 오류

키 유형동시 요청분당 요청 수
전체 키8300
체험 키260

모든 응답에는 X-Request-Id(support에 문의할 때 인용하세요), X-Balance-USD(남은 크레딧), X-RateLimit-Limit-Requests 및 X-RateLimit-Limit-Concurrency이 포함됩니다.

제한을 초과하면 API는 HTTP 429를 반환합니다. 오류 코드는 경우를 구분합니다:

  • rate_limited: 분당 요청이 너무 많습니다. 요청 속도를 줄이거나 부하를 분산하세요.
  • concurrency: 동시에 처리 중인 요청이 너무 많습니다. 클라이언트 측에서 큐에 넣으세요.
  • Retry-After: 5 헤더가 포함된 429: 일시적 과부하입니다. 5초 동안 대기한 후 다시 시도하세요.
import time
import httpx

def post_with_retry(payload, key, tries=4):
    # payload example: {"model": "uncensored", "messages": [...]}
    for attempt in range(tries):
        r = httpx.post(
            "https://api.unrestrictedaiapi.com/v1/chat/completions",
            headers={"Authorization": "Bearer " + key},
            json=payload,
            timeout=120,
        )
        if r.status_code == 429:
            wait = int(r.headers.get("Retry-After", 2 ** attempt))
            time.sleep(wait)
            continue
        return r
    return r

실패하거나 거부된 요청에는 요금이 청구되지 않습니다.

역할, 대화 기록 및 응답 객체

API는 상태가 없습니다. 이전 요청을 기억하지 않으므로 대화는 매번 전송하는 messages 배열로만 존재합니다. 일반적인 대화 기록은 동작을 설정하는 하나의 system 메시지로 시작하며, 그 다음에는 user 및 assistant 메시지가 교대로 나타납니다. 함수 호출이 사용되면 tool 메시지가 그 사이에 나타나며, 각각 tool_call_id로 해당 호출과 연결됩니다.

이에는 두 가지 결과가 있습니다. 첫 번째는 비용입니다: 모든 턴은 전체 대화 기록을 입력으로 사용하므로, 각 질문이 짧더라도 긴 대화는 메시지당 비용이 더 많이 듭니다. 두 번째는 제어입니다. 대화 기록을 자유롭게 편집, 축소 또는 다시 작성할 수 있습니다. 가장 오래된 턴을 제거하거나 요약으로 대체하거나 수정된 assistant 메시지를 삽입하는 것은 모두 일반적인 작업이며, 모델은 전송된 모든 것을 사실로 간주합니다.

응답에서 세 가지 항목을 읽어야 합니다. choices[0].message에는 텍스트 또는 함수 호출이 포함됩니다. choices[0].finish_reason은 생성이 중단된 이유(자연스러운 종료, 토큰 한도 도달 또는 함수 호출)를 알려줍니다. usage에는 프롬프트, 생성 결과 및 총 토큰 사용량이 포함됩니다. finish_reason이 토큰 한도에 도달했음을 나타내면 텍스트가 잘리므로, 한도를 높이거나 후속 턴에서 모델에게 계속 생성하도록 요청해야 합니다.

짧은 호환성 체크리스트

이 엔드포인트에 대한 클라이언트를 출시하기 전에 다음 확인 사항을 확인하세요. 몇 분 안에 대부분의 통합 문제를 발견할 수 있습니다.

  1. 키를 사용하여 GET /v1/models을 호출하고 uncensored이 포함된 목록이 반환되는지 확인하세요.
  2. 옵션 없이 일반 채팅 요청을 보내고 usage 블록이 있는 정상적인 응답이 반환되는지 확인하세요.
  3. stream: true로 반복하여 클라이언트가 스트림 종료 및 최종 사용량 데이터를 처리하는지 확인하세요.
  4. 도구를 사용하는 경우, tool 메시지가 포함된 후속 요청을 포함하여 전체 도구 호출 왕복을 테스트하세요.
  5. 체험용 키로 10개의 요청을 동시에 전송하고, 두 번째 동시 요청 후 발생하는 429 오류를 코드가 처리하는지 확인하세요.
  6. 모든 호출에 대해 X-Request-Id를 로그에 기록하여 이상한 결과가 발생했을 때 나중에 추적할 수 있도록 하세요.

이 여섯 가지 항목을 모두 통과하면 클라이언트가 실제 트래픽에 준비된 것입니다.

전체 OpenAI 플랫폼과 다른 점

호환성은 전체 플랫폼이 아닌 채팅 프로토콜을 의미합니다. 텍스트 채팅 외의 기능은 모두 제공되지 않으며, 일부 동작은 프로토콜이 아닌 모델에서 비롯됩니다. 모델 이름은 고정되어 있으며, 답변 스타일은 이전에 사용하던 모델과 다를 수 있습니다. 또한 seed를 사용한 샘플링은 프롬프트와 매개변수가 동일하게 유지되는 동안에만 반복 가능합니다.

변경할 수 없는 유일한 콘텐츠 규칙은 미성년자가 포함된 성적인 콘텐츠가 차단된다는 것입니다. 그 외에는 모델이 합법적인 성인 사용에 대한 거부를 피하도록 조정되었으며, 프롬프트는 학습에 사용되지 않습니다.

5개 언어의 코드 예시는 퀵스타트를 참조하세요. 제한 없는 모델 프롬프트 기법에 대해서는 제한 없는 모델에 프롬프트 작성하기를 읽고, 계정 관련 정보는 요금에서 확인할 수 있습니다. 여기에는 1M 입력 토큰당 $0.15, 1M 출력 토큰당 $0.50의 요금이 명시되어 있으며, 크레딧은 만료되지 않습니다. 문서에는 동일한 스펙이 간략하게 정리되어 있습니다.

질문과 답변

어떤 OpenAI 엔드포인트가 지원되나요?

POST /v1/chat/completions과 GET /v1/models만 지원됩니다. 임베딩, 이미지, 오디오, 파인튜닝 및 레거시 completions 엔드포인트는 사용할 수 없습니다.

스트리밍과 함수 호출을 지원합니까?

두 가지 모두 가능합니다. 스트리밍은 사용량 정보를 마지막에 포함하는 서버 전송 이벤트(SSE)를 사용하며, 함수 호출도 스트리밍됩니다. 결과는 role이 tool인 메시지 형태로 반환됩니다.

최대 컨텍스트 길이는 얼마인가요?

프롬프트와 생성 결과를 합쳐서 100,000 토큰입니다. 요청 본문 크기는 최대 8 MB까지 가능합니다.

여기서 429는 무엇을 의미하나요?

분당 요청 한도(rate_limited)를 초과했거나, 동시 요청(concurrency)이 너무 많았거나, 서비스의 일시적인 과부하로 인해 Retry-After: 5가 전송된 경우입니다.

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

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

API 키 받기