메인 콘텐츠로 건너뛰기
POST
/
v1
/
chat
/
completions
curl --request POST \ --url https://api.evolink.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": "assistant",
        "content": "안녕하세요! 무엇을 도와드릴까요?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 292,
    "total_tokens": 300
  }
}

인증

​
Authorization
string
header
필수

##모든 API는 Bearer Token 인증이 필요합니다##

API 키 받기:

API 키 관리 페이지를 방문하여 API 키를 받으세요

요청 헤더에 추가:

Authorization: Bearer YOUR_API_KEY

본문

application/json
​
model
enum<string>
필수

채팅 모델 이름

사용 가능한 옵션:
MiniMax-M2.5
예시:

"MiniMax-M2.5"

​
messages
object[]
필수

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

Minimum array length: 1
​
max_tokens
integer

생성 콘텐츠의 최대 토큰 수, 상한은 2048

참고:

  • 상한을 초과하는 콘텐츠는 잘립니다
  • length 이유로 생성이 중단된 경우 이 값을 높여보세요
필수 범위: 1 <= x <= 2048
예시:

2048

​
stream
boolean

스트리밍 모드로 응답을 반환할지 여부

  • true: 스트리밍 응답, 실시간으로 청크 단위로 콘텐츠 반환
  • false: 완전한 응답을 기다린 후 반환
예시:

false

​
temperature
number

샘플링 온도, 출력의 무작위성 제어

참고:

  • 낮은 값(예: 0.1): 더 확정적이고 집중된 출력
  • 높은 값(예: 0.9): 더 무작위적이고 창의적인 출력
  • 범위: (0, 1], 0 제외
필수 범위: x <= 1
예시:

0.7

​
top_p
number

Nucleus Sampling 매개변수

참고:

  • 누적 확률에서 토큰 샘플링 제어
  • 예: 0.9는 누적 확률 90%에 도달하는 토큰에서 선택을 의미
  • 범위: (0, 1], 0 제외

권장: temperature와 top_p를 동시에 조정하지 마세요

필수 범위: x <= 1
예시:

0.9

​
enable_search
boolean

웹 검색 활성화 여부

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

true

​
search_options
object

웹 검색 옵션, enable_search: true 필요

응답

채팅 완성 성공

​
id
string

채팅 완성의 고유 식별자

예시:

"cmpl-04ea926191a14749b7f2c7a48a68abc6"

​
model
string

실제 사용된 모델 이름

예시:

"MiniMax-M2.5"

​
object
enum<string>

응답 유형

사용 가능한 옵션:
chat.completion
예시:

"chat.completion"

​
created
integer

생성 타임스탬프

예시:

1698999496

​
choices
object[]

채팅 완성 선택 목록

​
usage
object

토큰 사용 통계