StarMagicStarMagic
한국어
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
통합 가이드
MiniMax-M2.5 - 完整参数文档
StarMagicStarMagic
한국어
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
텍스트MiniMaxMinimax.M2.5

MiniMax-M2.5 - 전체 API 레퍼런스

  • OpenAI SDK 형식으로 MiniMax-M2.5 모델 호출
  • 동기 처리 모드, 실시간 응답
  • 텍스트 대화: 단일 또는 다중 턴 컨텍스트 대화
  • 시스템 프롬프트: AI 역할 및 동작 사용자 정의
<Note> **BaseURL**: 기본 BaseURL은 `https://api.starmagic.ai`이며, 텍스트 모델 지원이 더 우수하고 장시간 연결을 지원합니다. `https://api.starmagic.ai`는 멀티모달 서비스의 주력 엔드포인트이며, 텍스트 모델에 대해서는 대체 주소로 사용됩니다. </Note>

인증

Authorizationstringheader필수

##모든 API는 Bearer Token 인증이 필요합니다## **API 키 받기:** [API 키 관리 페이지](https://starmagic.ai/app/api-keys)를 방문하여 API 키를 받으세요 **요청 헤더에 추가:** ``` Authorization: Bearer YOUR_API_KEY ```

Authorization: Bearer YOUR_API_KEY

요청 본문

application/json
modelenum<MiniMax-M2.5>필수

채팅 모델 이름

"MiniMax-M2.5"
messagesobject[]필수

대화 메시지 목록, 다중 턴 대화 지원

[
  {
    "role": "user",
    "content": "자기소개를 해주세요"
  }
]
max_tokensinteger

생성 콘텐츠의 최대 토큰 수, 상한은 2048 **참고**: - 상한을 초과하는 콘텐츠는 잘립니다 - `length` 이유로 생성이 중단된 경우 이 값을 높여보세요

2048
streamboolean

스트리밍 모드로 응답을 반환할지 여부 - `true`: 스트리밍 응답, 실시간으로 청크 단위로 콘텐츠 반환 - `false`: 완전한 응답을 기다린 후 반환

false
temperaturenumber

샘플링 온도, 출력의 무작위성 제어 **참고**: - 낮은 값(예: 0.1): 더 확정적이고 집중된 출력 - 높은 값(예: 0.9): 더 무작위적이고 창의적인 출력 - 범위: (0, 1], 0 제외

0.7
top_pnumber

Nucleus Sampling 매개변수 **참고**: - 누적 확률에서 토큰 샘플링 제어 - 예: 0.9는 누적 확률 90%에 도달하는 토큰에서 선택을 의미 - 범위: (0, 1], 0 제외 **권장**: temperature와 top_p를 동시에 조정하지 마세요

0.9
enable_searchboolean

웹 검색 활성화 여부 - `true`: 웹 검색 활성화, 모델이 필요에 따라 인터넷에서 최신 정보를 검색합니다 - `false`: 웹 검색 비활성화

true
search_optionsobject

웹 검색 옵션, `enable_search: true` 필요

{
  "search_strategy": "max"
}

응답

application/json
成功

응답 본문

idstring

채팅 완성의 고유 식별자

"cmpl-04ea926191a14749b7f2c7a48a68abc6"
modelstring

실제 사용된 모델 이름

"MiniMax-M2.5"
objectenum<chat.completion>

응답 유형

"chat.completion"
createdinteger

생성 타임스탬프

1698999496
choicesobject[]

채팅 완성 선택 목록

[
  {
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "안녕하세요! 무엇을 도와드릴까요?"
    },
    "finish_reason": "stop"
  }
]
usageobject

토큰 사용 통계

{
  "prompt_tokens": 8,
  "completion_tokens": 292,
  "total_tokens": 300
}
POST/v1/chat/completions
curl --request POST \
  --url https://api.starmagic.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "MiniMax-M2.5",
  "messages": [
    {
      "role": "user",
      "content": "자기소개를 해주세요"
    }
  ]
}'
응답: 成功
{
  "id": "cmpl-04ea926191a14749b7f2c7a48a68abc6",
  "model": "MiniMax-M2.5",
  "object": "chat.completion",
  "created": 1698999496,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": null,
        "content": null
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 292,
    "total_tokens": 300
  }
}