DeepSeek v4 API

Tài liệu tham chiếu API đầy đủ cho các mô hình DeepSeek v4 LLM do DeepSeek cung cấp.

Cập nhật mô hình

DeepSeek v4 Flash 0731

• Flaq AI đã cập nhật DeepSeek v4 Flash lên bản phát hành chính thức deepseek-v4-flash-0731 của DeepSeek.
• Sử dụng các ID mô hình 0731 dưới đây để truy cập phiên bản đã cập nhật.
• Các ID mô hình ban đầu vẫn khả dụng cho các tích hợp API hiện có.

Biến thể mô hình

API này hỗ trợ bốn biến thể mô hình DeepSeek v4:

So sánh nhanh

DeepSeek v4 Pro Text to Text

Điểm cuối

httpSao chép
POST /api/v1/chat/completions

Tham số yêu cầu

Bắt buộc

Hỗ trợ tin nhắn

Tùy chọn

Ví dụ yêu cầu

javascriptSao chép
const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Accept': 'text/event-stream',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'deepseek-v4-pro-text-to-text',
    messages: [
      {
        role: 'user',
        content: 'Hello'
      }
    ],
    stream: true,
    max_tokens: 500,
    top_p: 0.5,
    top_k: 1
  })
});

DeepSeek v4 Flash Text to Text

Điểm cuối

httpSao chép
POST /api/v1/chat/completions

Tham số yêu cầu

Bắt buộc

Hỗ trợ tin nhắn

Tùy chọn

Ví dụ yêu cầu

javascriptSao chép
const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'deepseek-v4-flash-text-to-text',
    messages: [
      {
        role: 'user',
        content: 'Write a four-line modern poem about a programmer drinking coffee.'
      }
    ],
    stream: false,
    max_tokens: 500,
    top_p: 0.5,
    top_k: 1
  })
});

DeepSeek v4 Pro Web Search

Điểm cuối

httpSao chép
POST /api/v1/chat/completions

Tham số yêu cầu

Bắt buộc

Hỗ trợ tin nhắn

Tùy chọn

Ví dụ yêu cầu

javascriptSao chép
const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Accept': 'text/event-stream',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'deepseek-v4-pro-web-search',
    messages: [
      {
        role: 'user',
        content: 'What date is it today?'
      }
    ],
    stream: true,
    max_tokens: 500,
    top_p: 0.5,
    top_k: 1
  })
});

DeepSeek v4 Flash Web Search

Điểm cuối

httpSao chép
POST /api/v1/chat/completions

Tham số yêu cầu

Bắt buộc

Hỗ trợ tin nhắn

Tùy chọn

Ví dụ yêu cầu

javascriptSao chép
const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Accept': 'text/event-stream',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'deepseek-v4-flash-web-search',
    messages: [
      {
        role: 'user',
        content: 'What date is it today?'
      }
    ],
    stream: true,
    max_tokens: 500,
    top_p: 0.5,
    top_k: 1
  })
});

Định dạng phản hồi

Các mô hình LLM DeepSeek V4 trả về phản hồi completion tương thích với OpenAI. Với stream: true, phản hồi là Server-Sent Events; với stream: false, phản hồi là một đối tượng JSON duy nhất.

Phản hồi lỗi

jsonSao chép
{
  "error": {
    "code": "1001",
    "param": null,
    "message": "Authorization is empty",
    "type": "invalid_request_error"
  }
}

Thực hành tốt nhất

1. Chọn đúng biến thể: Dùng mô hình Pro cho lập luận chất lượng cao hơn và mô hình Flash cho workload có độ trễ thấp, chi phí thấp hơn.
2. Dùng Web Search cho sự kiện hiện tại: Chọn Pro hoặc Flash Web Search khi câu trả lời phụ thuộc vào thông tin trực tuyến cập nhật.
3. Tinh chỉnh tham số sampling cẩn thận: top_p và top_k được hỗ trợ trên mọi biến thể DeepSeek v4 và có thể thay đổi độ đa dạng của đầu ra.
4. Chỉ gửi đầu vào được hỗ trợ: Không gửi phần tệp hoặc hình ảnh tới bất kỳ route DeepSeek v4 nào.
5. Khớp Accept với chế độ stream: Dùng Accept: text/event-stream cho yêu cầu streaming và Accept: application/json cho yêu cầu không streaming.