KO ▾
API 키 받기

무검열 AI API 첫 호출과 OpenAI SDK 연결

무검열 ai api를 처음 써 본다면 필요한 것은 API 키 하나와 base URL 변경뿐입니다. 이미 OpenAI SDK로 짠 코드가 있다면 주소와 모델 이름만 바꿔도 첫 응답을 받을 수 있습니다.

업데이트일

OpenAI 호환 커넥터가 API 게이트웨이에 꽂혀 데이터가 흐르는 아이소메트릭 일러스트

핵심 요약

  • base URL은 https://api.mugeomyeolapi.com/v1, 모델 ID는 uncensored 하나입니다.
  • chat/completions, responses, models 엔드포인트와 스트리밍, 도구 호출, JSON 모드를 지원합니다.
  • 429 오류는 rate_limited와 concurrency 두 가지로 나뉘며, 원인에 따라 대처가 다릅니다.
  • 텍스트 전용이며, 미성년자가 관련된 성적 콘텐츠는 어떤 경우에도 허용되지 않습니다.

시작 전에 준비할 것

필요한 것은 세 가지입니다. 키, base URL, 모델 ID입니다. 나머지는 평소 쓰던 OpenAI 호환 클라이언트가 처리합니다.

  1. 가입합니다. 구글 계정 또는 이메일과 비밀번호로 가입할 수 있습니다.
  2. API 키 발급 페이지에서 키를 만듭니다. 신규 사용자는 이 페이지에서 버튼 한 번으로 $0.50 체험 크레딧을 받을 수 있습니다. 1인 1회이고 유효기간은 7일이며 결제 정보는 필요 없습니다.
  3. base URL에 https://api.mugeomyeolapi.com/v1을, 모델에 uncensored를 지정합니다.

인증은 표준 방식인 Authorization: Bearer <키> 헤더입니다. 키는 코드에 직접 적지 말고 환경 변수에 넣어 두세요. 아래 예제는 모두 MUGEOMYEOL_API_KEY라는 변수를 읽습니다.

Python으로 첫 호출하기

openai 패키지(v1 이상)를 설치한 뒤 클라이언트를 만들 때 base_url만 바꾸면 됩니다.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.mugeomyeolapi.com/v1",
    api_key=os.environ["MUGEOMYEOL_API_KEY"],
)

res = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "당신은 간결하게 답하는 한국어 어시스턴트입니다."},
        {"role": "user", "content": "HTTP 429 오류가 무엇인지 두 문장으로 설명해 줘."},
    ],
    temperature=0.7,
)
print(res.choices[0].message.content)
print(res.usage)

응답의 usage에는 입력과 출력 토큰 수가 들어 있습니다. 요금은 이 숫자로 계산됩니다. 남은 잔액은 응답 헤더 X-Balance-USD에서 바로 볼 수 있습니다. Python SDK에서는 with_raw_response를 쓰면 헤더에 접근할 수 있습니다.

import os
from openai import OpenAI
client = OpenAI(base_url="https://api.mugeomyeolapi.com/v1", api_key=os.environ["MUGEOMYEOL_API_KEY"])
raw = client.chat.completions.with_raw_response.create(
    model="uncensored",
    messages=[{"role": "user", "content": "안녕"}],
)
print("잔액(USD):", raw.headers.get("X-Balance-USD"))
completion = raw.parse()
print(completion.choices[0].message.content)

curl과 Node.js 예제

SDK 없이 확인만 하고 싶다면 curl이 가장 빠릅니다. 키가 제대로 동작하는지 점검할 때 유용합니다.

curl https://api.mugeomyeolapi.com/v1/chat/completions \
  -H "Authorization: Bearer $MUGEOMYEOL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "한 줄로 자기소개해 줘."}]
  }'

Node.js에서도 구조는 같습니다.

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.mugeomyeolapi.com/v1",
  apiKey: process.env.MUGEOMYEOL_API_KEY,
});

const stream = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "짧은 시를 한 편 써 줘." }],
  stream: true,
  stream_options: { include_usage: true },
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

스트리밍은 stream: true 하나로 켜지며 SSE로 전달됩니다. 사용량은 스트림 끝에서 확인할 수 있습니다. 사용 가능한 모델 목록은 GET /v1/models로 조회합니다. 이 서비스는 모델이 uncensored 하나뿐이라 목록도 짧습니다.

자주 쓰는 매개변수

OpenAI Chat Completions에서 쓰던 매개변수는 대부분 그대로 통합니다. 자주 쓰는 것만 정리하면 다음과 같습니다.

매개변수용도
temperature, top_p답변의 무작위성 조절. 둘 다 동시에 크게 바꾸기보다 하나만 조정하는 편이 결과를 예측하기 쉽습니다.
stop, seed종료 문자열 지정, 재현성 확보 시도
presence/frequency penalty반복 억제
max_tokens선택 사항. 생략하면 컨텍스트 창의 남은 부분까지 쓸 수 있습니다.
tools, tool_choice도구 호출. 결과는 role: "tool" 메시지로 돌려보냅니다.
response_format{"type":"json_object"}로 JSON 모드를 켭니다.

컨텍스트 창은 프롬프트와 출력을 합쳐 100,000토큰입니다. 긴 문서를 넣을 때는 입력이 이 한도의 대부분을 차지하지 않도록 확인하세요. JSON 모드를 쓸 때는 프롬프트에도 JSON으로 답하라고 적어 두면 안정적입니다.

import os, json
from openai import OpenAI

client = OpenAI(base_url="https://api.mugeomyeolapi.com/v1", api_key=os.environ["MUGEOMYEOL_API_KEY"])

res = client.chat.completions.create(
    model="uncensored",
    response_format={"type": "json_object"},
    messages=[{"role": "user", "content": "도시 3곳의 이름과 인구 규모 느낌을 JSON 객체로 줘. 키는 cities 하나."}],
)
data = json.loads(res.choices[0].message.content)
print(data)

엔드포인트는 POST /v1/chat/completions 외에 POST /v1/responses도 있습니다. 새로 만드는 코드에서 Responses 형식을 쓰고 있다면 같은 base URL에서 호출하면 됩니다. 세부 필드는 API 문서에서 확인하세요.

오류 코드와 재시도 처리

가장 먼저 만나게 되는 오류는 HTTP 429입니다. 이 서비스에서는 의미가 두 가지로 나뉩니다.

  • rate_limited: 분당 요청 수를 넘었습니다. 정식 키는 분당 300건, 체험 키는 분당 60건입니다.
  • concurrency: 동시에 처리 중인 요청이 너무 많습니다. 정식 키는 8개, 체험 키는 2개까지입니다.

서버가 일시적으로 바쁠 때도 429가 오며, 이때는 Retry-After: 5 헤더가 붙습니다. 5초 뒤에 다시 보내면 됩니다. 스트리밍 요청은 스트림이 끝날 때까지 동시 처리 슬롯 하나를 차지한다는 점을 기억하세요. 스트림을 열어 놓고 닫지 않으면 동시 한도에 금방 걸립니다.

import os, time
from openai import OpenAI, RateLimitError

client = OpenAI(base_url="https://api.mugeomyeolapi.com/v1", api_key=os.environ["MUGEOMYEOL_API_KEY"], max_retries=0)

def ask(prompt, tries=5):
    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))  # 5초, 10초, 15초 ... 점점 늘려 기다림
    raise RuntimeError("재시도 한도를 넘었습니다")

print(ask("테스트 메시지"))

동시 요청이 문제라면 재시도보다 호출 쪽에서 세마포어로 동시 수를 제한하는 편이 낫습니다. 응답 헤더 X-RateLimit-Limit-Requests와 X-RateLimit-Limit-Concurrency로 현재 키의 한도를 확인할 수 있습니다. 요청 본문은 최대 8MB입니다. 실패하거나 거절된 요청에는 요금이 청구되지 않습니다. 문제를 문의할 때는 응답 헤더의 X-Request-Id를 함께 전달하면 지원 페이지에서 원인을 찾기가 쉬워집니다.

사용 규칙과 알아 둘 한계

이 서비스는 합법적인 성인 이용을 전제로, 콘텐츠 거절 없이 답하도록 조정된 오픈 웨이트 모델 하나를 독립 사업자가 운영하는 API입니다. Meta, Mistral, Qwen, DeepSeek, OpenAI, xAI, Google, Anthropic 등 어느 회사의 공식 API도 아니고, 여러 업체의 모델로 요청을 나눠 보내는 라우터도 아닙니다. 무검열 ai api를 고를 때 이 차이를 알고 있어야 문서와 실제 동작을 헷갈리지 않습니다.

  • 미성년자가 관련된 성적 콘텐츠는 어떤 경우에도 허용되지 않습니다. 이 한계는 풀리지 않습니다.
  • 텍스트 전용입니다. 이미지, 음성, 영상 생성, 임베딩, 파인튜닝은 제공하지 않습니다.
  • 입력한 프롬프트는 모델 학습에 쓰이지 않습니다. 자세한 내용은 개인정보 처리방침을 참고하세요.

답변에 거절이 없다는 것은 책임이 없다는 뜻이 아닙니다. 서비스를 만드는 쪽에서 이용 약관과 관련 법규를 지켜야 합니다.

비용 감각과 충전

요금은 입력 100만 토큰당 $0.15, 출력 100만 토큰당 $0.50이며 선불 크레딧에서 차감됩니다. 구독은 없고 크레딧은 만료되지 않습니다. 예를 들어 입력 2,000토큰, 출력 500토큰인 요청 한 건은 입력 $0.0003과 출력 $0.00025를 합해 $0.00055입니다. 1,000건을 보내도 $0.55입니다.

체험 크레딧 $0.50으로 위 규모의 요청을 약 900건 시험해 볼 수 있습니다. 충전은 $20부터 $500까지 정수 금액으로 가능하고, $50 이상 5%, $100 이상 10%, $200 이상 15% 보너스가 붙습니다. 결제 수단은 USDT(TRC20)와 USDC(Base)입니다. 자세한 표는 요금 페이지에 있습니다.

더 많은 가이드

자주 묻는 질문

OpenAI SDK 코드를 얼마나 바꿔야 하나요?

base URL, API 키, 모델 이름 세 가지만 바꾸면 됩니다. 모델 ID는 uncensored, base URL은 https://api.mugeomyeolapi.com/v1입니다.

체험 크레딧은 어떻게 받나요?

가입 후 API 키 페이지에서 버튼을 한 번 누르면 $0.50이 지급됩니다. 1인 1회, 유효기간 7일이며 결제 정보는 필요 없습니다.

429 오류가 나는데 어떻게 해야 하나요?

오류 코드가 rate_limited인지 concurrency인지 먼저 확인하세요. 전자는 분당 요청 수 초과이고 후자는 동시 요청 수 초과입니다. Retry-After 헤더가 있으면 그 시간만큼 기다린 뒤 재시도합니다.

이미지도 생성할 수 있나요?

아니요. 이 API는 텍스트 전용이며 이미지, 음성, 영상 생성과 임베딩은 지원하지 않습니다.

긴 문서도 한 번에 넣을 수 있나요?

프롬프트와 출력을 합쳐 100,000토큰까지 쓸 수 있습니다. 요청 본문 크기는 최대 8MB입니다.

API 키는 가입만으로

계정 생성, 키 복사, 베이스 URL 변경. 설정은 이걸로 끝입니다.

API 키 받기
API 키 받기