무켄츠 AI API 빠른 시작

기본 설정 및 Base URL

무켄츠 AI는 OpenAI 호환 REST API로 설계되었습니다. 이를 통해 기존 OpenAI 클라이언트나 SDK를 약간의 수정만으로 사용할 수 있습니다. API 통신에는 다음 Base URL을 사용하세요.

https://api.mukenetsuapi.com/v1

다른 LLM 서비스와 달리 복잡한 엔드포인트 선택이나 추가 설정이 필요 없습니다. 단일 채팅 완성 엔드포인트와 모델 목록 엔드포인트만 제공됩니다. 이 단순한 구조로 개발이 빠르게 진행됩니다.

API 키는 API 키 가져오기 페이지에서 이메일과 비밀번호를 사용하여 등록할 때 즉시 발급됩니다. 대시보드 작업이 필요하지 않습니다. 또한 프라이버시를 중시하며, 프롬프트 데이터는 모델 학습에 사용되지 않습니다.

인증 및 API 키

API 접근에는 헤더 Authorization: Bearer <API_KEY> 인증이 필요합니다. 무켄츠 AI API 키는 계정 생성 시 생성된 것을 사용합니다. 계정당 하나의 API 키가 할당되지만 필요 시 언제든지 재생성할 수 있습니다. 키를 재생성하면 이전 키는 무효화되므로 주의하세요.

인증 오류가 발생하면 일반적으로 401(Unauthorized) 또는 402(Payment Required) 응답이 반환됩니다. 401은 키가 잘못되었거나 무효화되었음을, 402는 계정 크레딧 잔고가 부족함을 의미합니다. 크레딧은 선불 방식이며, 암호화폐(USDT·USDC)로 $10 이상부터 충전할 수 있습니다.

채팅 완성 엔드포인트

텍스트 생성의 주요 엔드포인트는 POST /v1/chat/completions입니다. 이 엔드포인트에 요청을 전송하여 대화 기록이나 시스템 프롬프트를 포함해 텍스트를 생성할 수 있습니다. 모델 ID로 uncensored를 지정하세요. 이는 OpenAI의 GPT나 다른 벤더의 모델과는 다른, 자체 오픈 웨이트 모델입니다.

아래 예제는 curl을 사용해 기본 텍스트 생성을 수행하는 방법을 보여줍니다. 필요한 파라미터는 모델 ID, 메시지, 그리고 옵션으로 스트리밍 활성화입니다.

コピーcurl https://api.mukenetsuapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

이 엔드포인트에서는 임베딩(embeddings), 이미지 생성, 음성 변환 등의 기능을 제공하지 않습니다. 순수한 텍스트 완성 및 생성에 특화되어 있습니다.

스트리밍(SSE)

생성된 텍스트를 실시간으로 얻고 싶다면 스트리밍 모드를 사용할 수 있습니다. 요청에 "stream": true을 포함하면 서버는 서버 전송 이벤트(SSE) 형식으로 데이터를 순차적으로 반환합니다. 이를 통해 사용자는 생성이 완료되기 전에 텍스트의 일부를 표시할 수 있습니다.

Python OpenAI SDK나 Node.js 클라이언트 라이브러리를 사용하는 경우, stream=True 옵션을 지정하기만 하면 자동으로 스트리밍 처리가 수행됩니다. 이벤트 핸들러는 토큰별 청크를 수신합니다.

コピーfrom openai import OpenAI

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

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

스트리밍은 긴 응답이나 대화형 애플리케이션에서 사용자 경험을 향상시키는 중요한 기능입니다. 다만, 스트리밍 중 연결이 끊기면 이후 이벤트를 수신할 수 없습니다.

도구/함수 호출

무켄츠 AI API는 도구(함수) 호출을 지원합니다. 이를 통해 외부 API나 데이터베이스와의 연동이 용이해집니다. 요청 본문에 tools 필드와 tool_choice 파라미터를 포함해 모델이 특정 함수를 실행하도록 할 수 있습니다.

모델은 필요에 따라 함수를 호출할지 일반 텍스트를 반환할지 판단합니다. 호출이 완료되면 함수 결과를 messages에 추가해 모델에 전달함으로써 더 상세한 답변을 얻을 수 있습니다.

コピーimport OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

이 기능은 에이전트형 애플리케이션이나 복잡한 작업 자동화에 특히 유용합니다. OpenAI 호환 형식을 채택했으므로 기존 도구 호출 로직을 그대로 이식할 수 있습니다.

속도 제한 및 제약 사항

API 사용에는 다음 제한이 있습니다. 분당 최대 300 요청, 요청 본문 최대 크기 8MB입니다. 이를 초과하면 429(Too Many Requests) 오류가 반환됩니다. 또한 컨텍스트 창은 100,000 토큰(프롬프트 + 생성 텍스트 합계)입니다. 이를 초과하는 긴 대화나 문서는 적절히 분할해 전송해야 합니다.

스트리밍 응답을 수신할 때는 다음 이벤트 흐름을 따르세요.

コピーstream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

또한 미성년자와 관련된 성인 콘텐츠는 엄격히 제한됩니다. 이는 법적 운영을 위한 것입니다. 그 외의 법적 성인 콘텐츠, 픽션, 보안 연구, 논쟁적인 주제들은 검열 없이 생성됩니다.