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

인증

Authorization
string
header
필수

##모든 인터페이스는 Bearer Token 인증이 필요합니다##

API Key 받기:

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

사용 시 요청 헤더에 추가:

본문

application/json
model
enum<string>
기본값:deepseek-v4-flash
필수

모델 ID

  • deepseek-v4-flash: 빠른 범용 모델로 일상 대화, 요약, 추출에 적합합니다
  • deepseek-v4-pro: 심층 추론 모델로 복잡한 수학, 코드, 다단계 계획에 적합합니다
사용 가능한 옵션:
deepseek-v4-flash,
deepseek-v4-pro
예시:

"deepseek-v4-flash"

input

모델 입력입니다. inputinstructions 중 최소 하나는 제공해야 합니다.

  • 문자열 형태: 전체 텍스트가 하나의 user 메시지로 처리됩니다
  • 배열 형태: 입력 항목 목록으로 message, function_call, function_call_output, reasoning, web_search_call 다섯 가지 유형을 지원합니다

멀티턴 대화: 본 인터페이스는 무상태이므로 대화를 이어가려면 전체 히스토리를 배열에 담아야 합니다.

예시:

"항저우를 한 문장으로 소개해 주세요."

instructions
string

시스템 수준 지시로, 맨 앞에 삽입되는 system 메시지와 동일하며 역할, 어조, 출력 제약을 설정하는 데 사용합니다.

예시:

"당신은 꼼꼼한 기술 문서 작성자입니다. 답변은 간결하게 유지하세요."

stream
boolean
기본값:false

스트리밍 반환 여부

  • false(기본값): 완전한 응답 객체를 한 번에 반환합니다
  • true: 시맨틱 SSE 이벤트로 전송하며, 마지막 이벤트는 response.completed / response.incomplete / response.failed이고 [DONE]은 전송되지 않습니다
예시:

false

max_output_tokens
integer

이번 생성의 최대 출력 토큰 수(사고 토큰 포함)입니다. 범위는 1 ~ 393216(384K)이며, 비워 두면 모델이 스스로 결정합니다.

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

4096

temperature
number
기본값:1

샘플링 온도로, 값이 클수록 출력이 무작위해집니다. 사고 모드에서는 적용되지 않습니다.

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

1

top_p
number
기본값:1

뉴클리어스 샘플링 임계값으로, temperature와 둘 중 하나만 조정하기를 권장합니다. 사고 모드에서는 적용되지 않습니다.

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

1

top_logprobs
integer

각 위치에서 확률이 가장 높은 후보 토큰과 그 로그 확률을 반환합니다.

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

0

reasoning
object

사고 모드 설정입니다. DeepSeek V4는 기본적으로 사고가 활성화되어 있으며, 사고 내용은 reasoning 출력 항목으로 반환되고 해당 토큰은 출력에 포함되어 출력 단가로 과금됩니다.

text
object

텍스트 출력 형식 설정입니다.

tools
도구 정의 · object[]

모델이 호출할 수 있는 도구 목록입니다. 함수 도구는 클라이언트가 실행하고 결과를 function_call_output으로 반환하며, web_search는 서버 측에서 직접 실행되어 클라이언트 개입이 필요 없습니다.

tool_choice

도구 호출 전략

  • none: 도구 호출 금지
  • auto(기본값): 모델이 결정
  • required: 최소 하나의 도구를 반드시 호출
  • {"type": "function", "name": "get_weather"}: 지정한 함수를 강제로 호출
  • {"type": "web_search"}: 웹 검색을 강제로 실행
예시:

"auto"

응답

생성 성공

Responses 인터페이스의 응답 객체입니다.

id
string

이번 응답의 고유 식별자

예시:

"resp_9f2c1a4b8e7d"

object
string

객체 유형이며 항상 response

예시:

"response"

created_at
integer

생성 시각(Unix 타임스탬프, 초)

예시:

1755000000

status
enum<string>

응답 상태

  • completed: 정상 완료
  • in_progress: 생성 중
  • incomplete: 길이 등의 이유로 잘림. 자세한 내용은 incomplete_details 참조
  • failed: 생성 실패. 자세한 내용은 error 참조
사용 가능한 옵션:
in_progress,
completed,
incomplete,
failed
예시:

"completed"

model
string

실제로 이번 응답을 생성한 모델 ID

예시:

"deepseek-v4-flash"

output
object[]

생성 순서대로 나열된 출력 항목 목록입니다. 유형별 필드:

  • reasoning: 사고 과정이며 id, status, content(reasoning_text 블록 목록), summary를 포함합니다
  • message: 최종 답변이며 id, status, role, content(output_text 블록 목록)를 포함합니다
  • function_call: 모델이 발생시킨 함수 호출이며 id, status, call_id, name, arguments를 포함하고, 클라이언트가 실행한 뒤 function_call_output으로 반환합니다
  • web_search_call: 서버 측에서 실행된 웹 검색 기록이며 id, status, action(수행된 검색 내용)을 포함합니다
error
object | null

실패 원인이며 성공 시에는 null

incomplete_details
object | null

잘림 원인이며 잘리지 않았을 때는 null

usage
object

토큰 사용 통계(캐시 및 추론 세부 항목 포함)