API Hop

Tài liệu

Tài liệu API Hop

Mô hình DeepSeek

>-

POSThttps://api.apihop.ai/v1/chat-completions

Mô hình DeepSeek dùng điểm cuối Hoàn thành hội thoại chung. Để chuyển mô hình, chỉ đổi giá trị model; điểm cuối và xác thực giữ nguyên.

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

Mô hình khả dụng

Giá trị modelĐịnh vịKhông truyền luồngTruyền luồng SSE
deepseek-v4-flashCấp Flash và điểm khởi đầu thực tế cho hội thoại thường ngày hoặc đánh giá theo lôCóCó
deepseek-v4-proCấp Pro cho đánh giá ưu tiên suy luận phức tạp và chất lượng đầu raCóCó
deepseek-v4.1-flashDeepSeek V4.1 Flash; ID mô hình riêng, không phải bí danh V4 FlashSau khi triển khai và bậtSau khi triển khai và bật

V4.1 Flash chỉ khả dụng sau khi cấu hình định tuyến được triển khai và bật. Chỉ dùng khi GET https://api.apihop.ai/v1/models trả deepseek-v4.1-flash cho khóa API của bạn. Mục tham chiếu này không xác nhận đã triển khai sản xuất hoặc kiểm thử suy luận thành công. ID V4 Flash và V4 Pro hiện có giữ nguyên.

Định vị này giúp chọn mô hình ban đầu để thử; đây không phải SLA độ trễ, thông lượng hay chất lượng. So sánh mô hình khả dụng bằng prompt, độ dài đầu ra và mức đồng thời của chính bạn trước khi dùng trong sản xuất.

Xác thực

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

Yêu cầu không truyền luồng

Điểm cuối mặc định trả một phản hồi Chat Completions hoàn chỉnh. Ví dụ đặt rõ stream: false để hành vi vẫn rõ ràng khi sao chép.

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
}

Để dùng mô hình Pro, chỉ đổi trường mô hình:

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

Yêu cầu truyền luồng

Đặt rõ stream: true để truyền luồng và xử lý phản hồi dưới dạng sự kiện SSE cho đến [DONE].

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

Trường yêu cầu

modelstringbắt buộc

Dùng deepseek-v4-flash, deepseek-v4-pro hoặc deepseek-v4.1-flash theo kết quả GET https://api.apihop.ai/v1/models.

messagesobject[]bắt buộc

Tin nhắn kiểu OpenAI Chat Completions. Mỗi tin nhắn chứa role và content.

streambooleanMặc định: false

true trả SSE; false trả một phản hồi JSON hoàn chỉnh.

max_tokensinteger

Số token đầu ra tối đa tùy chọn, là số nguyên dương. Bỏ trường này để dùng mặc định thượng nguồn cho mô hình được chọn. Tùy mô hình, ngân sách có thể gồm token suy luận và văn bản cuối cùng. Ngân sách nhỏ có thể cắt câu trả lời hoặc cạn trước văn bản cuối cùng; tăng ngân sách có thể tăng chi phí.

max_completion_tokensinteger

Lựa chọn tương thích tùy chọn thay cho max_tokens, với cùng lưu ý ngân sách. Mô hình được chọn quyết định hỗ trợ; bỏ cả hai trường để dùng mặc định thượng nguồn.

Xem Hoàn thành hội thoại chung để biết các trường dùng chung như temperature, top_p, frequency_penalty, presence_penalty, stop và n. Hỗ trợ và tác dụng ngữ nghĩa có thể khác theo mô hình; hướng dẫn này không xác nhận V4.1 Flash hỗ trợ mọi trường tùy chọn.

Phản hồi thành công

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
  }
}

Phản hồi có thể chứa thêm chi tiết sử dụng; coi chúng là tùy chọn.

Lưu ý sử dụng

  • Hợp đồng công khai hiện tại là Chat Completions, gồm không truyền luồng và truyền luồng SSE.
  • Các mô hình này hiện không khả dụng qua OpenAI Responses hoặc Claude Messages.
  • Đặt trường model trong thân yêu cầu thành ID chính xác: deepseek-v4-flash, deepseek-v4-pro hoặc deepseek-v4.1-flash.
  • Chỉ dùng ID mô hình do GET https://api.apihop.ai/v1/models trả về.
  • Dùng GET https://api.apihop.ai/v1/models để biết mô hình hiển thị với khóa API hiện tại, và dùng bảng điều khiển để xem giá hiện hành.