DeepSeek - 전체 API 레퍼런스

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

Authorization: Bearer YOUR_API_KEY

채팅 모델 이름 - `deepseek-chat`: 일반 대화 모델 - `deepseek-reasoner`: 심층 추론 모델, 수학, 코딩 및 복잡한 논리 추론에 뛰어남 **참고**: `deepseek-reasoner`는 `temperature`, `top_p`, `tools`, `tool_choice`, `response_format` 파라미터를 지원하지 않습니다. 이러한 파라미터를 전달하면 업스트림에서 거부됩니다

"deepseek-chat"

대화 메시지 목록, 다중 턴 대화 지원 역할에 따라 필드 구조가 다르며, 해당 역할을 선택하여 확인하세요

[
  null
]

사고 모드 제어 (Beta) **상세 정보**: - `deepseek-reasoner` 모델의 심층 사고 기능을 제어합니다 - 활성화 시 모델이 응답 전에 심층 추론을 수행합니다

{
  "type": "enabled"
}

반복 콘텐츠를 줄이기 위한 빈도 패널티 파라미터 **상세 설명**: - 양수 값은 생성된 텍스트에서의 빈도에 따라 토큰에 패널티를 부여합니다 - 높은 값은 기존 콘텐츠를 반복할 가능성을 줄입니다 - 기본값: 0 (패널티 없음)

0

생성할 최대 토큰 수 **상세**: - 이 제한에 도달하면 모델이 생성을 중단합니다 - 설정하지 않으면 모델이 생성 길이를 결정합니다

4096

새로운 주제를 장려하기 위한 존재 페널티 매개변수 **상세**: - 양수 값은 텍스트에 나타났는지 여부에 따라 토큰에 페널티를 부여합니다 - 높은 값은 새로운 주제 논의를 장려합니다 - 기본값: 0 (페널티 없음)

0

응답 형식을 지정합니다 **상세 정보**: - `{"type": "json_object"}`로 설정하여 JSON 모드를 활성화합니다 - JSON 모드에서 모델은 유효한 JSON 콘텐츠를 출력합니다

{
  "type": "text"
}

중지 시퀀스. 모델이 이 문자열을 만나면 생성을 중지합니다 **상세 정보**: - 단일 문자열 또는 문자열 배열이 가능합니다 - 최대 16개 중지 시퀀스

응답을 스트리밍할지 여부 - `true`: SSE (Server-Sent Events)를 통해 스트리밍하며, 실시간 청크로 콘텐츠를 반환합니다 - `false`: 완전한 응답을 기다린 후 반환합니다

false

스트리밍 응답 옵션 `stream=true`일 때만 적용됩니다

{
  "include_usage": true
}

샘플링 온도, 출력의 무작위성을 제어합니다 **상세 정보**: - 낮은 값 (예: 0.2): 더 결정적이고 집중된 출력 - 높은 값 (예: 1.5): 더 무작위적이고 창의적인 출력 - 기본값: 1

1

Nucleus Sampling 매개변수 **설명**: - 누적 확률에서 토큰 샘플링을 제어합니다 - 예를 들어, 0.9는 누적 확률 90%까지의 토큰에서 선택하는 것을 의미합니다 - 기본값: 1.0 (모든 토큰 고려) **권장사항**: temperature와 topP를 동시에 조정하지 마세요

1

Function Calling을 위한 도구 정의 목록 **상세 정보**: - 최대 128개 도구 정의 - 각 도구에는 이름, 설명 및 매개변수 스키마가 필요합니다

[
  {
    "type": "function",
    "function": {
      "name": "string",
      "description": "string",
      "parameters": {},
      "strict": false
    }
  }
]

도구 호출 동작을 제어합니다 **옵션**: - `none`: 도구를 호출하지 않음 - `auto`: 모델이 도구 호출 여부를 결정 - `required`: 모델이 하나 이상의 도구를 호출하도록 강제 **기본값**: 도구가 제공되지 않으면 `none`, 도구가 제공되면 `auto`

토큰 로그 확률을 반환할지 여부 **상세 정보**: - `true`로 설정하면 응답에 각 토큰의 로그 확률 정보가 포함됩니다

false

상위 N개의 가장 가능성 높은 토큰의 로그 확률 반환 **상세**: - `logprobs`를 `true`로 설정해야 합니다 - 범위: `[0, 20]`

0