OpenAI 호환 API 5단계로 사용법
OpenAI 스타일 API 사용은 키 발급, SDK 설치, 베이스 URL 설정, 모델 지정, 메시지 전송의 5단계로 구성됩니다. 아래에 복사할 수 있는 코드와 함께 각 단계를 설명합니다.

주요 포인트
- 베이스 URL을 https://api.uncensoredaiapis.com/v1로 변경하고 자신의 키를 사용하면 모든 OpenAI SDK가 여기서 작동합니다.
- 모델 ID는 uncensored이며 주요 엔드포인트는 POST /v1/chat/completions과 GET /v1/models입니다.
- 스트리밍, JSON 모드, 함수 호출은 공식 API와 동일한 매개변수를 사용합니다.
- 가격은 입력 토큰 100만 토큰당 $0.15, 출력 토큰 100만 토큰당 $0.50이며, $0.50의 무료 체험 크레딧으로 시작할 수 있습니다.
간단 요약
OpenAI가 아닌 서비스에서 OpenAI 스타일 API 호출을 사용하려면, 요청 형식이 공유된 관례임을 알면 됩니다. 이를 지원하는 클라이언트에는 요청을 보낼 위치(베이스 URL), 사용자 인증(키), 실행할 모델 세 가지 값이 필요합니다. 이 세 가지만 변경하면 동일한 코드가 작동합니다. 이 사이트는 해당 관례를 따르므로 표준 OpenAI Python 및 Node 패키지와 일반 curl 모두에서 작동합니다.
그것이 무엇을 의미하고 무엇을 의미하지 않는지 명확히 하십시오. 호환성이라는 것은 인터페이스가 일치한다는 뜻입니다. 이것이 공식 OpenAI 서비스이거나 OpenAI 모델을 실행한다는 뜻은 아닙니다. 백엔드는 독립적인 제공자가 실행하는 단일 오픈 웨이트 모델이며, 합법적인 성인 사용에 대해 콘텐츠 거부 없이 답변하도록 조정되었습니다. 모델 ID uncensored를 선택하여 사용합니다. 텍스트만 처리하며, 이미지, 오디오, 임베딩 또는 파인튜닝은 지원하지 않습니다.
아래 5단계는 약 10분이 소요됩니다. 여러 언어로 완성된 코드 스니펫을 읽는 것을 선호한다면 코드 예제 페이지를 참조하세요.
1단계: 키 받기
Google 또는 이메일과 비밀번호로 가입하고 API 키 페이지를 엽니다. 신규 사용자는 클릭 한 번으로 $0.50의 체험 크레딧을 받을 수 있습니다. 7일 동안 유효하며, 인원당 한 번만 사용 가능하고 카드가 필요하지 않습니다. 키를 복사하여 코드에 붙여넣는 대신 환경 변수로 저장하십시오:
# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
export API_KEY="paste-your-key-here"시험용 키는 동시 요청 2개, 분당 요청 60개로 제한됩니다. 충전된 키는 동시 8개, 분당 300개를 허용합니다. 시험용 키의 세부 사항은 무료 체험 FAQ를 참조하십시오.
2단계: SDK 설치 및 첫 번째 요청 보내기
사용하는 언어에 맞는 공식 패키지를 설치하세요. 이 두 라이브러리는 모든 OpenAI 스타일 서비스에서 사용하는 것과 동일합니다:
# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
pip install openai
npm install openai이제 Python으로 첫 번째 호출을 수행합니다. 기본 설정과의 유일한 차이점은 base_url 인수입니다:
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.uncensoredaiapis.com/v1",
api_key=os.environ["API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise writing assistant."},
{"role": "user", "content": "Give me three titles for a noir short story."},
],
)
print(resp.choices[0].message.content)Node에서의 동일한 호출:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.uncensoredaiapis.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Give me three titles for a noir short story." }],
});
console.log(resp.choices[0].message.content);3단계: messages 배열 이해하기
채팅 모델은 호출 간에 어떤 정보도 기억하지 않습니다. 각 요청은 전체 대화 내용을 메시지 목록으로 전달하며, 각 메시지에는 역할이 있습니다.
system은 동작과 스타일을 설정합니다. 페르소나, 형식 규칙 및 제약 조건을 여기에 지정하세요.user은 사용자가 요청한 내용을 포함합니다.assistant은 모델의 이전 응답을 포함합니다. 대화 이어서 진행할 때 직접 추가합니다.tool은 함수 호출의 결과를 전달하며, 아래에서 다룹니다.
대화를 계속하려면 어시스턴트의 응답과 다음 사용자 메시지를 동일한 목록에 추가한 후 전체를 다시 전송하십시오. 긴 대화의 비용이 더 많이 드는 이유입니다: 모든 호출은 입력 토큰으로 전체 기록에 대해 비용을 지불합니다. 컨텍스트 창은 프롬프트와 completion을 합쳐 총 100,000개의 토큰을 유지하므로, 오래된 턴을 다듬는 것은 채팅 앱 구축의 정상적인 부분입니다.
유용한 샘플링 필드가 전달됩니다: temperature, top_p, stop, seed 및 빈도/존재 패널티입니다. max_tokens은 선택 사항입니다. 응답 길이를 제한하고 비용을 절감하려면 설정하세요.
4단계: 스트리밍, JSON 모드 및 도구
스트리밍
서버 전송 이벤트를 통해 토큰을 받으려면 stream: true를 추가하세요. 모델이 아직 작성 중일 때 텍스트가 표시되므로 인터페이스가 빠르게 느껴지며, 스트림 종료 시 사용량이 보고됩니다.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredaiapis.com/v1", apiKey: process.env.API_KEY });
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a short toast for a retirement party." }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}JSON 모드
코드에서 응답을 구문 분석할 때 response_format: {"type": "json_object"}를 사용하세요. 원하는 키를 프롬프트에 설명하세요.
curl https://api.uncensoredaiapis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [
{"role": "system", "content": "Reply with JSON: {\"mood\": string, \"score\": number}"},
{"role": "user", "content": "Rate this line: the rain finally stopped."}
]
}'함수 호출
함수 스키마가 포함된 tools 목록과 선택적으로 tool_choice을 전달하세요. 모델이 함수 실행을 원하면 응답에 tool_calls가 포함됩니다. 함수를 자신의 코드에서 실행하고 결과를 role tool로 메시지 전송하여 반환합니다. 도구 호출도 스트리밍됩니다. 이는 에이전트의 기본 구성 요소이며, 사용 사례 페이지에서 이점이 있는 경우를 확인할 수 있습니다.
5단계: 제한 사항, 비용 및 오류 이해하기
한도를 초과하면 API는 HTTP 429를 반환합니다. 오류 코드는 분당 요청 수가 너무 많을 경우 rate_limited이고, 동시에 너무 많은 경우 concurrency입니다. 일시적인 과부하도 429를 반환하며, Retry-After: 5 헤더가 포함됩니다. 스트리밍 요청은 스트림이 끝날 때까지 동시성 슬롯을 유지하므로 더 이상 읽지 않는 스트림은 닫으십시오. 요청 바디 한도는 8 MB입니다. 모든 응답에는 X-Request-Id 및 X-Balance-USD 헤더가 포함되며, 첫 번째는 지원 요청 시 인용해야 하는 값입니다.
비용은 단순합니다. 입력 토큰 3,000개와 출력 토큰 700개의 채팅 호출 비용은 백만 토큰당 $0.15의 3,000배인 $0.00045와, 백만 토큰당 $0.50의 700배인 $0.00035를 합한 총 $0.0008입니다. 이러한 호출 1,000개의 비용은 $0.80입니다. 실패하거나 거부된 요청에는 요금이 부과되지 않으며, 크레딧은 만료되지 않습니다. 가격 책정 페이지에는 $20부터 $500까지의 충전 옵션과 $50부터 +5%, $100부터 +10%, $200부터 +15%의 보너스가 나열되어 있습니다. 암호화폐(TRC20의 USDT, Base의 USDC)로 결제할 수 있습니다.
공식 API와의 차이점
계획해야 할 세 가지 차이가 있습니다. 첫째, 모델 이름: OpenAI 모델 이름이 아닌 uncensored를 사용하십시오. 둘째, 범위: 채팅 완료와 모델 목록만 제공되므로, 이미지 생성, 음성, 임베딩 및 파인튜닝과 같은 기능은 여기에 없습니다. 셋째, 동작: 모델은 합법적인 성인 요청을 거부하지 않도록 조정되었으므로, 출력은 강하게 필터링된 어시스턴트와 다를 수 있습니다. 한 가지 규칙은 항상 동일합니다: 미성년자가 포함된 성 콘텐츠는 금지됩니다.
첫날 도움이 되는 몇 가지 습관이 있습니다. 키를 환경 변수에 보관하고, 모든 호출의 X-Request-Id를 로깅하며, 실험 중일 때 max_tokens를 설정하여 과도한 응답이 계획한 금액보다 더 많이 사용하지 않도록 하십시오. 채팅 인터페이스를 구축할 때는 스트리밍으로 응답을 처리하고, 기록이 길어지면 오래된 턴을 다듬으십시오. 출력을 구문 분석하는 파이프라인을 구축할 때는 JSON 모드를 사용하고 구문 분석을 여전히 보호하십시오. 토큰 한도에서 잘린 응답은 유효한 JSON이 아니기 때문입니다. 그리고 프로그램의 두 부분이 동시에 API를 호출할 때, 전체 키가 허용하는 8개의 동시 요청에 대해 계산하십시오.
테스트 비용을 잊지 마세요. 짧은 프롬프트로 몇십 번의 실험은 총 비용이 1센트 미만으로 매우 저렴하므로, 요청 형식을 배우는 동안 $0.50의 무료 체험 크레딧은 충분히 활용됩니다.
기존 앱을 이동하는 경우 이동 가이드가 순서대로 변경 사항을 안내합니다. 여기서 전송된 프롬프트는 학습에 사용되지 않습니다. 대부분의 앱에 대해 이동은 이 페이지 시작부의 세 가지 값과 모델 이름으로 구성됩니다.
더 많은 가이드
질문과 답변
공식 OpenAI SDK가 필요합니까?
사용할 수 있으며, 이것이 가장 쉬운 경로입니다. 커스텀 Base URL을 지원하는 한, 모든 OpenAI 호환 클라이언트 또는 일반 HTTP도 작동합니다.
어떤 모델 이름을 전송해야 하나요?
uncensored를 전송하세요. 베이스 URL은 https://api.uncensoredaiapis.com/v1 입니다.
이것이 공식 OpenAI API인가요?
아닙니다. 동일한 요청 형식을 따르지만, 이 모델은 독립적인 공급자가 운영하는 오픈 웨이트 모델이며 서비스는 OpenAI와 별개입니다.
요청 비용은 얼마입니까?
입력 토큰은 100만 토큰당 $0.15, 출력 토큰은 100만 토큰당 $0.50입니다. 입력 3,000개와 출력 700개의 요청 하나당 비용은 약 $0.0008입니다.
결제 전에 사용해 볼 수 있나요?
네. 가입 후 한 번의 클릭으로 $0.50의 무료 체험 크레딧을 받을 수 있습니다. 7일 동안 유효하며 카드가 필요 없습니다.