DeepSeek 모델 | API 문서

# DeepSeek Models

DeepSeek V4 Flash, V4 Pro, and V4.1 Flash model IDs and Chat Completions availability.

POST https://api.apihop.ai/v1/chat-completions

DeepSeek models use the Common Chat Completions endpoint. To switch models, change only the `model` value; the endpoint and authentication stay the same.

```text
POST https://api.apihop.ai/v1/chat-completions
```

## Available Models

| `model` value | Positioning | Non-streaming | SSE streaming |
| --- | --- | --- | --- |
| `deepseek-v4-flash` | Flash tier and a practical starting point for routine chat or batch evaluations | Yes | Yes |
| `deepseek-v4-pro` | Pro tier for evaluations that prioritize complex reasoning and output quality | Yes | Yes |
| `deepseek-v4.1-flash` | DeepSeek V4.1 Flash; a distinct model ID, not a V4 Flash alias | After deployment and enablement | After deployment and enablement |

V4.1 Flash becomes available only after its routing configuration is deployed and enabled. Use it only when `GET https://api.apihop.ai/v1/models` returns `deepseek-v4.1-flash` for your API Key. This reference entry does not confirm a production rollout or a successful inference test. Existing V4 Flash and V4 Pro IDs remain unchanged.

This positioning helps you choose an initial model to test; it is not a latency, throughput, or quality SLA. Compare available models with your own prompts, output lengths, and concurrency before production use.

## Authentication

```http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

## Non-streaming Request

The endpoint returns one complete Chat Completions response by default. The example includes `stream: false` explicitly so its behavior remains obvious when copied.

```json
{
  "model": "deepseek-v4-flash",
  "messages": [
    {
      "role": "system",
      "content": "You are a precise technical assistant."
    },
    {
      "role": "user",
      "content": "Explain three benefits of event-driven architecture."
    }
  ],
  "stream": false
}
```

To use the Pro model, change only the model field:

```json
{
  "model": "deepseek-v4-pro"
}
```

## Streaming Request

Set `stream: true` explicitly for streaming and process the response as SSE events until `[DONE]`.

```json
{
  "model": "deepseek-v4-pro",
  "messages": [
    {
      "role": "user",
      "content": "Create a checklist for a reversible database migration."
    }
  ],
  "stream": true
}
```

## Request Fields

### `model` (string, required)

Use `deepseek-v4-flash`, `deepseek-v4-pro`, or `deepseek-v4.1-flash`, as returned by `GET https://api.apihop.ai/v1/models`.

### `messages` (object[], required)

OpenAI Chat Completions style messages. Each message contains `role` and `content`.

### `stream` (boolean, Default: false)

`true` returns SSE; `false` returns one complete JSON response.

### `max_tokens` (integer)

Optional maximum output tokens, as a positive integer. Omit this field to use the upstream default for the selected model. Depending on the model, the budget may include reasoning tokens as well as final text. A small budget can truncate the answer or be exhausted before final text; increasing it may increase cost.

### `max_completion_tokens` (integer)

Optional compatibility alternative to `max_tokens`, with the same budget considerations. The selected model determines support; omit both fields to use the upstream default.

See [Common Chat Completions](https://apihop.ai/en/docs/api-reference/common-chat-completions) for shared fields such as `temperature`, `top_p`, `frequency_penalty`, `presence_penalty`, `stop`, and `n`. Support and semantic effects may vary by model; this guide does not establish V4.1 Flash support for every optional field.

## Success Response

```json
{
  "id": "chatcmpl_...",
  "object": "chat.completion",
  "created": 1787200000,
  "model": "deepseek-v4-flash",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "1. Services can remain loosely coupled..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 31,
    "completion_tokens": 96,
    "total_tokens": 127
  }
}
```

Responses may contain additional usage details; treat them as optional.

## Usage Notes

- The current public contract is Chat Completions, including non-streaming and SSE streaming.
- These models are not currently available through OpenAI Responses or Claude Messages.
- Set the request body's `model` field to the exact ID: `deepseek-v4-flash`, `deepseek-v4-pro`, or `deepseek-v4.1-flash`.
- Use only model IDs returned by `GET https://api.apihop.ai/v1/models`.
- Use `GET https://api.apihop.ai/v1/models` for the models visible to the current API Key, and use the console for current pricing.

## Related Docs

- [Common Chat Completions](https://apihop.ai/en/docs/api-reference/common-chat-completions)
- [Model Catalog](https://apihop.ai/en/docs/api-reference/models)

DeepSeek 모델은 공통 Chat Completions 엔드포인트를 사용합니다. 모델을 바꿀 때는 model 값만 변경하며 엔드포인트와 인증은 같습니다.

text

POST https://api.apihop.ai/v1/chat-completions

사용 가능한 모델

`model` 값	포지셔닝	비스트리밍	SSE 스트리밍
`deepseek-v4-flash`	일상 채팅이나 배치 평가를 시작하기 좋은 Flash 등급	지원	지원
`deepseek-v4-pro`	복잡한 추론과 출력 품질을 우선하는 평가용 Pro 등급	지원	지원
`deepseek-v4.1-flash`	DeepSeek V4.1 Flash: V4 Flash 별칭이 아닌 독립 모델 ID	배포 및 활성화 후	배포 및 활성화 후

V4.1 Flash는 라우팅 설정을 배포하고 활성화한 후에만 사용할 수 있습니다. 키의 GET https://api.apihop.ai/v1/models가 deepseek-v4.1-flash를 반환할 때만 사용하세요. 이 참조 항목은 운영 배포나 성공적인 추론 테스트를 확인하는 것이 아닙니다. 기존 V4 Flash 및 V4 Pro ID는 바뀌지 않습니다.

이 포지셔닝은 처음 테스트할 모델을 고르기 위한 것이며 지연, 처리량 또는 품질 SLA가 아닙니다. 운영 사용 전에 자신의 프롬프트, 출력 길이 및 동시 실행 수로 사용 가능한 모델을 비교하세요.

인증

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

비스트리밍 요청

기본적으로 완전한 Chat Completions 응답 하나를 반환합니다. 복사 후에도 동작이 분명하도록 예제에 stream: false를 명시했습니다.

json

{
  "model": "deepseek-v4-flash",
  "messages": [
    {
      "role": "system",
      "content": "You are a precise technical assistant."
    },
    {
      "role": "user",
      "content": "Explain three benefits of event-driven architecture."
    }
  ],
  "stream": false
}

Pro 모델을 사용하려면 모델 필드만 바꾸세요.

json

{
  "model": "deepseek-v4-pro"
}

스트리밍 요청

스트리밍은 stream: true를 명시하고 [DONE]까지 응답을 SSE 이벤트로 처리하세요.

json

{
  "model": "deepseek-v4-pro",
  "messages": [
    {
      "role": "user",
      "content": "Create a checklist for a reversible database migration."
    }
  ],
  "stream": true
}

요청 필드

modelstring필수

GET https://api.apihop.ai/v1/models에서 반환한 deepseek-v4-flash 또는 deepseek-v4-pro 또는 deepseek-v4.1-flash을(를) 사용하세요.

messagesobject[]필수

OpenAI Chat Completions 형식의 메시지입니다. 각 메시지는 role과 content를 포함합니다.

streamboolean기본값: false

true는 SSE를, false는 하나의 완전한 JSON 응답을 반환합니다.

max_tokensinteger

양의 정수로 지정하는 선택적 최대 출력 토큰입니다. 생략하면 선택한 모델의 상위 제공자 기본값을 사용합니다. 모델에 따라 추론 토큰과 최종 텍스트가 같은 한도를 사용할 수 있습니다. 작은 한도는 응답을 자르거나 최종 텍스트 전에 소진될 수 있으며, 늘리면 비용이 증가할 수 있습니다.

max_completion_tokensinteger

max_tokens의 선택적 호환 대안으로 같은 한도 고려 사항이 적용됩니다. 지원 여부는 선택한 모델에 달려 있습니다. 둘 다 생략하면 상위 기본값을 사용합니다.

temperature, top_p, frequency_penalty, presence_penalty, stop, n 같은 공통 필드는 공통 Chat Completions를 참조하세요. 지원 및 의미적 효과는 모델별로 다를 수 있으며 이 안내는 V4.1 Flash의 모든 선택 필드 지원을 확정하지 않습니다.

성공 응답

json

{
  "id": "chatcmpl_...",
  "object": "chat.completion",
  "created": 1787200000,
  "model": "deepseek-v4-flash",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "1. Services can remain loosely coupled..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 31,
    "completion_tokens": 96,
    "total_tokens": 127
  }
}

응답에 추가 사용량 상세 정보가 포함될 수 있으며 선택 사항으로 처리해야 합니다.

사용 참고 사항

현재 공개 계약은 비스트리밍 및 SSE 스트리밍을 포함한 Chat Completions입니다.
이 모델은 현재 OpenAI Responses나 Claude Messages로 사용할 수 없습니다.
요청 본문의 model을 정확한 ID인 deepseek-v4-flash, deepseek-v4-pro 또는 deepseek-v4.1-flash로 설정하세요.
GET https://api.apihop.ai/v1/models가 반환한 모델 ID만 사용하세요.
현재 키에 보이는 모델은 GET https://api.apihop.ai/v1/models로, 현재 가격은 콘솔에서 확인하세요.