โมเดล 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 เป็น ID โมเดลแยก ไม่ใช่ชื่อแทน V4 Flash	หลังติดตั้งและเปิดใช้	หลังติดตั้งและเปิดใช้

V4.1 Flash พร้อมใช้หลังติดตั้งและเปิดการตั้งค่าเส้นทางเท่านั้น ใช้เมื่อ GET https://api.apihop.ai/v1/models ส่ง deepseek-v4.1-flash สำหรับคีย์ API ของคุณ รายการอ้างอิงนี้ไม่ยืนยันการเปิดใช้ในระบบจริงหรือการทดสอบอนุมานสำเร็จ ID V4 Flash และ V4 Pro เดิมไม่เปลี่ยน

การวางตำแหน่งนี้ช่วยเลือกโมเดลเริ่มทดสอบ ไม่ใช่ 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 ชัดเจนสำหรับสตรีม แล้วประมวลผลการตอบกลับเป็นเหตุการณ์ SSE จนถึง [DONE]

json

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

ฟิลด์คำขอ

modelstringจำเป็น

ใช้ deepseek-v4-flash, deepseek-v4-pro หรือ deepseek-v4.1-flash ตามที่ GET https://api.apihop.ai/v1/models ส่งกลับ

messagesobject[]จำเป็น

ข้อความรูปแบบ OpenAI Chat Completions แต่ละข้อความมี role และ content

streambooleanค่าเริ่มต้น: false

true ส่ง SSE ส่วน false ส่งการตอบกลับ JSON สมบูรณ์หนึ่งชุด

max_tokensinteger

โทเคนเอาต์พุตสูงสุดแบบไม่บังคับ เป็นจำนวนเต็มบวก ไม่ระบุเพื่อใช้ค่าเริ่มต้นต้นทางของโมเดลที่เลือก งบอาจรวมโทเคนการให้เหตุผลและข้อความสุดท้ายตามโมเดล งบน้อยอาจตัดคำตอบหรือหมดก่อนข้อความสุดท้าย การเพิ่มอาจเพิ่มค่าใช้จ่าย

max_completion_tokensinteger

ตัวเลือกเพื่อความเข้ากันได้แทน max_tokens แบบไม่บังคับ มีข้อพิจารณางบเดียวกัน การรองรับขึ้นอยู่กับโมเดลที่เลือก ไม่ระบุทั้งสองฟิลด์เพื่อใช้ค่าเริ่มต้นต้นทาง

ดูChat Completions ร่วม สำหรับฟิลด์ร่วม เช่น temperature, top_p, frequency_penalty, presence_penalty, stop และ n การรองรับและผลต่อความหมายอาจต่างกันตามโมเดล คู่มือนี้ไม่ยืนยันว่า 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
  }
}

การตอบกลับอาจมีรายละเอียดการใช้งานเพิ่มเติม ให้ถือเป็นตัวเลือก

หมายเหตุการใช้งาน

ข้อกำหนดสาธารณะปัจจุบันคือ Chat Completions รวมทั้งแบบไม่สตรีมและสตรีม SSE
โมเดลเหล่านี้ยังใช้ผ่าน OpenAI Responses หรือ Claude Messages ไม่ได้ในปัจจุบัน
ตั้งฟิลด์ model ในเนื้อหาคำขอเป็น ID ที่ตรง: deepseek-v4-flash, deepseek-v4-pro หรือ deepseek-v4.1-flash
ใช้เฉพาะ ID โมเดลที่ GET https://api.apihop.ai/v1/models ส่งกลับ
ใช้ GET https://api.apihop.ai/v1/models ดูโมเดลที่คีย์ API ปัจจุบันมองเห็น และใช้คอนโซลดูราคาปัจจุบัน