MiniMax API: 5분 내 첫 요청

OpenAI SDK 설치

먼저 선호하는 언어용 공식 OpenAI SDK를 설치하세요. 라이브러리는 요청 서식 지정 및 스트리밍을 자동으로 처리합니다. Python 3.8+ 또는 Node.js 18+이 설치되어 있는지 확인하세요. Python의 경우 pip install openai, Node의 경우 npm install openai를 실행하세요. SDK는 /v1/chat/completions 엔드포인트와의 상호 작용을 단순화합니다. SDK는 헤더, 재시도, SSE 파싱을 관리하므로 프롬프트에 집중할 수 있습니다. 이는 당사 API가 OpenAI 채팅 완료 표준을 따르기 때문에 가능합니다. 사용자 정의 클라이언트 라이브러리가 필요하지 않습니다. 표준 SDK 메서드는 당사 엔드포인트에 직접 매핑됩니다. 이는 통합 시간을 줄이고 기존 개발자 지식을 활용합니다.

기본 URL 및 키 구성

환경 변수에 API 키와 기본 URL을 설정하세요. 기본 URL은 https://api.minimaxapikey.com/v1입니다. 이를 통해 수정 없이 표준 OpenAI 클라이언트를 사용할 수 있습니다. 계정을 생성하여 키를 생성하세요. 키는 가입 직후 표시됩니다. 시도에는 카드가 필요하지 않습니다. 키를 안전하게 저장하세요. 헤더 또는 환경 변수로 전달하세요. SDK는 기본적으로 OPENAI_API_KEY을 사용합니다. 기본 URL을 재정의하여 당사 서버를 가리킬 수 있습니다. 이를 통해 모든 요청이 무검열 모델로 전송되도록 보장합니다. 간단한 핑으로 키가 작동하는지 확인하세요. 이 단계는 나중에 인증 오류를 방지합니다.

기본 채팅 완료 보내기

텍스트 생성을 위한 첫 번째 요청을 수행하세요. POST 메서드를 /v1/chat/completions에서 사용하세요. 모델을 uncensored로 지정하세요. 사용자 프롬프트가 포함된 메시지 배열을 전달하세요. API는 완료 토큰을 반환합니다. 이것이 핵심 텍스트 생성 기능입니다. 100k 컨텍스트 창을 지원합니다. 긴 프롬프트나 대화 기록을 보낼 수 있습니다. 응답에는 생성된 텍스트와 토큰 사용량이 포함됩니다. 이는 창의적인 글쓰기 또는 제한 없는 대화에 이상적입니다. 콘텐츠가 합법적인지 확인하세요. 모델은 성인 주제를 거부하지 않습니다. 미성년자가 포함된 성적 콘텐츠만 차단합니다. 연결을 확인하려면 간단하게 시작하세요.

스트리밍 활성화 (SSE)

실시간 출력을 위해 스트리밍을 활성화하세요. stream 매개변수를 true로 설정하세요. API는 서버 전송 이벤트(SSE)를 반환합니다. 각 청크는 응답의 일부를 포함합니다. 이는 지각된 지연 시간을 줄입니다. 사용자는 생성되는 대로 텍스트가 나타나는 것을 봅니다. SDK는 청크 파싱을 자동으로 처리합니다. UI에서 텍스트를 단계적으로 표시할 수 있습니다. 이는 채팅 인터페이스에 중요합니다. 스트리밍은 모든 모델 응답과 함께 작동합니다. 토큰 카운팅에 영향을 주지 않습니다. 각 청크에는 끝에 사용량 데이터가 포함됩니다. 더 나은 사용자 경험을 위해 이를 사용하세요. 전체 응답을 기다리는 것보다 더 반응성이 느껴집니다. 클라이언트를 구성하여 청크를 올바르게 버퍼링하세요.

도구/함수 호출 사용

함수 호출로 구조화된 출력을 지원합니다. 요청 본문에 도구를 정의하세요. 모델은 프롬프트에 기반하여 함수를 호출할 수 있습니다. 이는 외부 시스템과의 통합을 가능하게 합니다. 도구 정의와 사용자 메시지를 전달하세요. 응답에는 도구 호출 객체가 포함됩니다. 함수를 실행하고 결과를 다시 피드하세요. 이는 표준 OpenAI SDK와 함께 작동합니다. 복잡한 워크플로우를 허용합니다. 에이전트 또는 어시스턴트를 구축할 수 있습니다. 모델은 호출 간 컨텍스트를 유지합니다. 이는 자동화에 강력합니다. 도구 정의가 정확하도록 확인하세요. API는 도구 출력의 라우팅을 처리합니다. 대화의 일관성을 유지합니다. 동적 콘텐츠 생성에 사용하세요.

사용 가능한 모델 확인

GET /v1/models를 통해 모델 목록을 확인하세요. 이 엔드포인트는 사용 가능한 모델을 반환합니다. 당사 API는 하나의 모델을 제공합니다: uncensored. 이는 오픈 웨이트 모델입니다. GPT, Claude 또는 Gemini가 아닙니다. 응답은 모델 ID를 확인합니다. 이를 사용하여 클라이언트 구성을 디버깅하세요. 코드가 올바른 모델을 대상으로 하는지 확인하세요. 이 엔드포인트는 빠르고 신뢰할 수 있습니다. JSON 데이터를 반환합니다. 이를 UI 표시를 위해 구문 분석할 수 있습니다. 이는 API 키가 유효함을 확인합니다. 자동화된 상태 확인에 사용하세요. 이는 표준 OpenAI 사양의 일부입니다. 추가 구성이 필요하지 않습니다. 이는 기존 도구와의 호환성을 보장합니다.

cURL

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

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

스트리밍

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)