MiniMax api: 시작 가이드 및 SDK 가이드

인증 및 Base URL

제공된 API 키를 사용하고 클라이언트를 전용 기본 URL로 연결하세요. 응답 생성을 위한 엔드포인트는 https://api.minimaxaiapi.com/v1/chat/completions. 키를 Authorization header에 Bearer 토큰으로 설정합니다. 당사가 동일한 프로토콜을 따르기 때문에 모든 표준 OpenAI SDK와 함께 작동합니다.

• 헤더 이름: Authorization
• 헤더 값: Bearer YOUR_API_KEY
• Base URL: https://api.minimaxaiapi.com/v1

복잡한 설정이 필요하지 않습니다. 기존 프로젝트의 구성을 업데이트하기만 하면 됩니다.

Copycurl https://api.minimaxaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json with keys name and age"}]
  }'

채팅 완료 엔드포인트

채팅 완료 엔드포인트로 POST 요청을 보내 텍스트 응답을 받으십시오. 모델 식별자는 uncensored대화 기록이 포함된 messages 배열을 포함해야 합니다. 시스템은 입력을 처리하고 프롬프트에 기반하여 생성된 텍스트를 반환합니다.

이 엔드포인트는 모든 텍스트 생성을 처리합니다. 임베딩, 오디오 또는 비디오는 지원되지 않습니다. 응답을 스트리밍하거나 전체 블록을 기다릴 수 있습니다. 모델은 총 100,000 토큰의 컨텍스트를 처리합니다.

Copyfrom openai import OpenAI

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

스트리밍 및 토큰 사용량

stream을 true로 설정하여 스트리밍 활성화 stream: true 요청에 포함됩니다. API는 생성된 각 토큰에 대해 서버 전송 이벤트(SSE)를 반환합니다. 이를 통해 출력 결과를 실시간으로 표시할 수 있습니다. 토큰 사용량 통계는 스트림의 마지막 청크에 포함됩니다. 이를 통해 각 개별 토큰을 파싱하지 않고도 비용을 정확하게 추적하는 데 도움이 됩니다.

스트리밍은 긴 응답의 지각된 지연 시간을 줄입니다. 채팅 인터페이스와 동적 콘텐츠 생성에 이상적입니다. 사용자가 생성을 중단하면 스트림을 조기에 중단할 수 있습니다.

Copyimport OpenAI from "openai";

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

함수 호출 및 JSON 모드

을 사용하세요 tools 함수 호출을 활성화합니다. 요청 본문에 함수를 정의하고 모델이 어떤 함수를 호출할지 선택하도록 하세요. tool_choice 파라미터는 특정 함수를 강제로 호출하거나 자동 선택할 수 있게 해줍니다. 엄격한 JSON 출력을 위해 설정 response_format 수신하여 {"type": "json_object"}응답이 유효한 JSON임을 보장합니다.

함수 호출은 구조화된 데이터를 추출하거나 작업을 트리거하는 데 유용합니다. JSON 모드는 예측 가능한 형식이 필요한 API 통합에 완벽합니다. 견고한 애플리케이션 로직을 위해 둘을 결합하세요.

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)

모델 매개변수 및 제약 조건

표준 매개변수를 사용하여 생성 동작을 조정합니다. temperature, top_p, 그리고 stop. 최대 컨텍스트 윈도우는 프롬프트와 완료를 포함하여 100,000 토큰입니다. 요청당 최대 출력은 16,000 토큰입니다. 설정하지 않으면 max_tokens, 제한은 기본값이 2,048 토큰입니다.

사용 seed 재현 가능한 결과를 위해 설정하세요. presence_penalty 및 frequency_penalty 반복을 제어합니다. 이러한 매개변수는 모델의 창의성과 일관성에 세밀한 제어를 제공합니다. 올바른 균형을 찾기 위해 특정 사용 사례로 항상 테스트하세요.

속도 제한 및 오류

API는 키당 분당 300개의 요청과 8개의 동시 요청 제한을 시행합니다. 이 제한을 초과하면 429 오류가 발생합니다. 401 오류는 키가 없거나 무효함을 나타내며, 402 오류는 선불 크레딧이 고갈되었음을 의미합니다.

오류는 크레딧이 소모되지 않습니다. 실패한 요청을 패널티 없이 재시도할 수 있습니다. 요청 본문 크기는 8 MB로 제한됩니다. 스로틀링을 피하기 위해 동시성을 신중하게 관리하세요. 스트리밍 응답의 마지막 청크를 통해 사용량을 모니터링하세요.