Minicpm 사용자를 위한 빠른 시작

베이스 URL 및 인증

이 API를 사용하려면 API 키와 올바른 베이스 URL이 필요합니다. 저희 서비스는 표준 OpenAI 클라이언트 라이브러리와 완전히 호환됩니다. 새 의존성 설치나 새로운 SDK 학습이 필요하지 않습니다. 기존 클라이언트를 저희 엔드포인트로만 설정하면 됩니다.

API 키 받기 페이지에서 키를 생성하세요. Google로 로그인하거나 이메일과 비밀번호를 사용할 수 있습니다. 키는 즉시 표시됩니다. 안전하게 저장하세요. 모든 요청에는 Authorization 헤더에 이 키가 포함되어야 합니다.

모든 요청의 베이스 URL은 다음과 같습니다: https://api.minicpm.cc/v1. 이 URL은 채팅 완료, 모델 나열 및 스트리밍 응답을 처리합니다. 임베딩이나 비전을 위한 별도 엔드포인트는 없습니다. 이는 텍스트 전용 API입니다.

첫 번째 요청

표준 채팅 완료 요청을 보내 텍스트 생성을 시작하세요. 모델 ID는 항상 uncensored입니다. 이 모델은 합법적인 성인용 콘텐츠에 대한 거부 없이 답변하도록 조정된 오픈 웨이트 언어 모델입니다. GPT, Claude 또는 기타 벤더의 모델이 아닙니다.

model 필드를 uncensored로 설정하세요. 표준 배열 형식으로 메시지를 제공하세요. API는 텍스트 응답을 반환합니다. max_tokens로 출력 길이를 제어할 수 있습니다. 설정하지 않으면 기본 최대 출력은 2,048 토큰입니다.

Python SDK 통합

공식 OpenAI Python 라이브러리를 사용하여 API와 상호 작용하세요. 베이스 URL과 API 키만 구성하면 됩니다. 라이브러리의 나머지 부분은 예상대로 작동합니다. 여기에는 스트리밍, 함수 호출, JSON 모드 지원이 포함됩니다.

pip install openai로 라이브러리를 설치하세요. 베이스 URL과 키로 클라이언트를 초기화하세요. 채팅 완료 엔드포인트로 메시지를 보내세요. 응답 객체에는 생성된 텍스트, 토큰 사용량 및 종료 이유가 포함됩니다. Python 코드에서 이러한 필드에 직접 접근할 수 있습니다.

Node SDK 통합

Node.js SDK는 Python 버전과 동일하게 작동합니다. 패키지를 설치하고 베이스 URL을 구성하세요. 클라이언트는 인증 및 요청 형식을 자동으로 처리합니다. 이를 통해 백엔드 서비스에 API를 빠르게 통합할 수 있습니다.

베이스 URL과 API 키를 OpenAI 클라이언트 생성자에 전달하세요. chat.completions.create 메서드를 사용하세요. 응답 구조는 OpenAI 표준과 일치합니다. 오류를 처리하고, 토큰 사용량을 확인하며, 콘텐츠를 처리할 수 있습니다. 이 접근 방식은 이미 OpenAI를 사용하는 기존 코드베이스와의 호환성을 보장합니다.

스트리밍 응답

요청에 stream: true을 설정하여 스트리밍을 활성화하세요. API는 서버 전송 이벤트(SSE) 시퀀스를 반환합니다. 각 이벤트는 응답의 청크를 포함합니다. 이를 통해 생성되는 대로 사용자에게 텍스트를 표시할 수 있습니다.

마지막 청크에는 토큰 사용량 통계가 포함됩니다. 이는 비용 추적을 위해 유용합니다. 스트리밍은 사용자의 지각된 지연 시간을 줄여줍니다. 채팅 인터페이스에 권장됩니다. 클라이언트 코드에서 이벤트를 구문 분석하여 최종 응답을 구성하거나 실시간으로 토큰을 표시할 수 있습니다.

제한, 오류 및 컨텍스트

이 모델은 100,000 토큰 컨텍스트 창을 지원합니다. 여기에는 프롬프트와 완료 텍스트가 모두 포함됩니다. 요청당 최대 출력은 32,000 토큰입니다. 이를 제어하려면 max_tokens 매개변수를 조정하세요.

속도 제한은 키당 분당 300 요청으로 설정됩니다. 동시 요청은 8개까지 가능합니다. 요청 본문은 8 MB 미만이어야 합니다. 키가 유효하지 않으면 401 오류가 발생합니다. 크레딧이 없으면 402 오류가 발생합니다. 속도 제한을 초과하면 429 오류가 발생합니다. 오류와 거부 응답은 크레딧을 소모하지 않습니다.

cURL

Copycurl https://api.minicpm.cc/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."}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.minicpm.cc/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)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.minicpm.cc/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);

스트리밍

Copystream = 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)

2026-050