메인 콘텐츠로 건너뛰기
POST
BaseURL: 기본 BaseURL은 https://direct.evolink.ai이며, 텍스트 모델 지원이 더 우수하고 장시간 연결을 지원합니다. https://api.evolink.ai는 멀티모달 서비스의 주력 엔드포인트이며, 텍스트 모델에 대해서는 대체 주소로 사용됩니다.

인증

Authorization
string
header
필수

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

API Key 받기:

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

요청 헤더에 추가:

본문

application/json
model
enum<string>
기본값:Gemini-3.0-pro
필수

채팅 모델 이름

사용 가능한 옵션:
Gemini-3.0-pro
예시:

"Gemini-3.0-pro"

messages
object[]
필수

채팅 메시지 목록, 다중 턴 대화 및 멀티모달 입력 지원

Minimum array length: 1
stream
boolean
기본값:false

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

  • true: 스트리밍 반환, 실시간 청크로 내용 수신
  • false: 완전한 응답을 한 번에 반환
예시:

false

max_completion_tokens
integer | null

Maximum number of completion tokens for the generated response, corresponding to Gemini's maxOutputTokens.

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

2000

max_tokens
integer

Maximum number of tokens for the generated response, compatible with the legacy OpenAI parameter.

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

2000

temperature
number
기본값:1

샘플링 온도, 출력의 무작위성을 제어합니다

설명:

  • 낮은 값 (예: 0.2): 더 결정적이고 집중된 출력
  • 높은 값 (예: 1.5): 더 무작위적이고 창의적인 출력
필수 범위: 0 <= x <= 2
예시:

0.7

top_p
number
기본값:1

Nucleus Sampling 매개변수

설명:

  • 누적 확률을 기반으로 토큰에서 샘플링을 제어합니다
  • 예를 들어, 0.9는 누적 확률 상위 90%까지의 토큰에서 선택하는 것을 의미합니다
  • 기본값: 1.0 (모든 토큰 고려)

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

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

0.9

frequency_penalty
number | null
기본값:0

Frequency penalty coefficient. Range: -2.0 to 2.0. Corresponds to Gemini's frequencyPenalty.

필수 범위: -2 <= x <= 2
예시:

0

presence_penalty
number | null
기본값:0

Presence penalty coefficient. Range: -2.0 to 2.0. Corresponds to Gemini's presencePenalty.

필수 범위: -2 <= x <= 2
예시:

0

stop

Stop sequences. Supports a string or string array, corresponding to Gemini's stopSequences.

n
integer | null
기본값:1

Number of generated candidates.

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

1

reasoning_effort
enum<string> | null
기본값:medium

추론 부담을 제한합니다. Gemini 2.5 Pro는 none을 지원하지 않으며 low, medium, high를 사용합니다.

사용 가능한 옵션:
low,
medium,
high
예시:

"medium"

seed
integer | null

Random seed used to make output as reproducible as possible, corresponding to Gemini's seed.

예시:

12345

logprobs
boolean | null
기본값:false

Whether to return token logprob information, corresponding to Gemini's responseLogprobs.

예시:

true

top_logprobs
integer | null

Number of top logprob values returned for each token, corresponding to Gemini's logprobs.

필수 범위: 0 <= x <= 20
예시:

5

response_format
object

Response format settings, supporting JSON mode and JSON Schema, corresponding to Gemini's responseMimeType, responseSchema and responseJsonSchema.

stream_options
object | null

Streaming response options. Can be set when stream is true.

tools
object[] | null

List of tool definitions for Function Calling.

tool_choice

Controls tool-calling behavior.

사용 가능한 옵션:
none,
auto,
required
extra_body
object | null

Gemini extension parameters.

응답

채팅 완성이 성공적으로 생성되었습니다

id
string

채팅 완성의 고유 식별자

예시:

"chatcmpl-20251010015944503180122WJNB8Eid"

model
string

실제 사용된 모델 이름

예시:

"Gemini-3.0-pro"

object
enum<string>

응답 유형

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

"chat.completion"

created
integer

생성 타임스탬프

예시:

1760032810

choices
object[]

채팅 완성 선택지 목록

usage
object

토큰 사용 통계