Hướng dẫn mô hình và phương thức22 tháng 9, 2026Flatkey Team

Truy cập DeepSeek API thông qua một router tương thích OpenAI

Thiết lập truy cập DeepSeek API bằng khóa DeepSeek trực tiếp hoặc router tương thích OpenAI của Flatkey, với kiểm tra model, log, rà soát giá và khả năng rollback.

Truy cập DeepSeek API thông qua một router tương thích OpenAI là một mô hình thiết lập thực tế dành cho các indie hacker muốn dùng các mô hình DeepSeek mà không biến mỗi lựa chọn nhà cung cấp thành một lần tích hợp SDK mới.

Bạn có hai hướng đi rõ ràng. Hướng trực tiếp DeepSeek dùng một khóa API DeepSeek, base URL tương thích OpenAI của DeepSeek và tên mô hình DeepSeek. Hướng router dùng base URL tương thích OpenAI của Flatkey, một khóa API Flatkey và ID mô hình DeepSeek có sẵn cho tài khoản của bạn. Cả hai đều có thể hoạt động. Lựa chọn phù hợp phụ thuộc vào việc DeepSeek có phải là họ mô hình duy nhất của bạn hay chỉ là một tuyến trong một sản phẩm đa mô hình.

Hướng dẫn này cho thấy cách thiết lập Truy cập DeepSeek API thông qua một router tương thích OpenAI, cách giữ cho luồng nhà cung cấp trực tiếp dễ gỡ lỗi, và những gì cần xác minh trước khi traffic production được chuyển sang.

Câu trả lời nhanh: Truy cập DeepSeek API thông qua một router tương thích OpenAI

Với một ứng dụng kiểu OpenAI, truy cập DeepSeek API có hai tuyến thực tế.

Quyết định	DeepSeek API trực tiếp	DeepSeek qua Flatkey
Khóa API	Khóa API DeepSeek	Khóa API Flatkey
Base URL	`https://api.deepseek.com`	`https://router.flatkey.ai/v1`
Tùy chọn định dạng Anthropic	`https://api.deepseek.com/anthropic`	Dùng dạng API Flatkey mà tuyến của bạn hỗ trợ
Tên mô hình DeepSeek hiện tại cần kiểm tra	`deepseek-flash`, `deepseek-v4-pro`	Các ID mô hình DeepSeek mà tài khoản có thể truy cập từ `/v1/models` của Flatkey và thư mục mô hình
Phù hợp nhất	Một prototype chỉ dùng DeepSeek hoặc một tích hợp phụ thuộc vào nhà cung cấp	Một ứng dụng đa mô hình muốn một client, một khóa, một lần rà soát sử dụng và khả năng dự phòng dễ hơn
Kiểm tra vận hành	Dashboard DeepSeek, tài liệu nhà cung cấp, bảng giá hiện tại	Danh sách mô hình Flatkey, nhật ký sử dụng, trang giá, trang trạng thái và manifest rollback

Dùng tuyến trực tiếp khi DeepSeek là mô hình duy nhất bạn cần và quyền kiểm soát ở cấp nhà cung cấp là quan trọng nhất. Dùng Flatkey khi DeepSeek đứng cùng GPT, Claude, Gemini, Qwen, các mô hình media hoặc các tuyến coding-agent phía sau cùng một client tương thích OpenAI.

DeepSeek xác nhận gì về khả năng tương thích API

Tài liệu API hiện tại của DeepSeek cho biết API DeepSeek sử dụng định dạng API tương thích với OpenAI và Anthropic. Base URL theo định dạng OpenAI là:

https://api.deepseek.com

DeepSeek cũng có tài liệu về base URL theo định dạng Anthropic:

https://api.deepseek.com/anthropic

Các tài liệu này cũng liệt kê deepseek-flash và deepseek-v4-pro là các tùy chọn mô hình. Chúng cũng nói rằng các tên cũ deepseek-v4-flash và deepseek-v4-flash-vision-exp vẫn được chấp nhận để tương thích, nhưng các yêu cầu đó được phục vụ bởi DeepSeek-V4.1-Flash và bị tính phí theo giá Flash. Với code mới, hãy xem các tên cũ là rủi ro khi di chuyển, không phải là tên để sao chép vào một sản phẩm mới.

Trang giá của DeepSeek hiện mô tả deepseek-flash là DeepSeek-V4.1-Flash và deepseek-v4-pro là DeepSeek-V4-Pro-0813. Trang này cũng liệt kê độ dài ngữ cảnh 1M và đầu ra tối đa 384K, cùng hỗ trợ đầu ra JSON, gọi công cụ, Responses API và Anthropic API cho cả hai mô hình. Hỗ trợ Vision được liệt kê cho Flash và không có cho Pro. Hãy kiểm tra trang giá DeepSeek trực tiếp trước khi công bố giá chính xác trong tài liệu của bạn, vì bảng này sử dụng mức giá token giờ cao điểm và ngoài giờ cao điểm.

Flatkey thay đổi gì

Flatkey không loại bỏ nhu cầu chọn một model ID DeepSeek hợp lệ. Nó thay đổi nơi cấu hình route và nơi bạn xác minh kết quả.

Tài liệu quickstart và model API của Flatkey sử dụng base URL tương thích OpenAI này:

https://router.flatkey.ai/v1

Endpoint /v1/models của Flatkey trả về các model ID có sẵn cho tài khoản của bạn theo định dạng tương thích OpenAI. Tài liệu sử dụng của Flatkey cho biết mỗi request có thể được xem lại cùng với model đã dùng, số token đầu vào và đầu ra, chi phí, dấu thời gian, API key và trạng thái. Điều đó giúp Truy cập DeepSeek API thông qua một router tương thích OpenAI dễ vận hành hơn khi DeepSeek chỉ là một trong nhiều lựa chọn mô hình.

Bản ghi route của phiên bản router nên được ghi rõ ràng:

deepseek_route:
  provider_access_layer: flatkey
  base_url: https://router.flatkey.ai/v1
  api_key_source: FLATKEY_API_KEY
  candidate_models:
    - deepseek-flash
    - deepseek-v4-pro
  verify_before_launch:
    - account_accessible_v1_models
    - live_model_directory
    - pricing_page_units
    - usage_log_readback
    - fallback_or_rollback_policy

Đừng ẩn tên model dưới dạng một chuỗi trong mã ứng dụng. Hãy đặt nó trong file cấu hình hoặc manifest model để việc cập nhật DeepSeek model trở thành một thay đổi có thể xem xét thay vì một lần triển khai khẩn cấp.

Bước 1: Chọn DeepSeek trực tiếp hay một router

Bắt đầu từ quyết định vận hành, không phải từ SDK.

Câu hỏi	DeepSeek trực tiếp thường là đủ khi...	Router thường tốt hơn khi...
Bạn chỉ gọi DeepSeek?	Có, sản phẩm chỉ dùng DeepSeek.	Không, DeepSeek là một route bên cạnh các nhà cung cấp khác.
Bạn có cần các điều khiển riêng theo nhà cung cấp không?	Có, nhóm của bạn muốn thiết lập và xem xét thanh toán theo kiểu gốc DeepSeek.	Không, ứng dụng của bạn muốn một lớp truy cập dùng chung và log dùng chung.
Người dùng hoặc job có chuyển đổi model không?	Không, một model cố định là đủ.	Có, khối lượng công việc có thể chuyển giữa DeepSeek, Qwen, Gemini, Claude, GPT hoặc các họ model khác.
Ai xem xét chi phí và lỗi?	Một developer có thể kiểm tra tài khoản DeepSeek.	Bạn cần một sổ ghi usage chung cho các key, model và môi trường.
Điều gì xảy ra nếu route thất bại?	Bạn có thể tạm dừng tính năng hoặc thử lại sau.	Bạn cần các điều khiển fallback, rollback hoặc triển khai theo giai đoạn.

Đối với hầu hết indie hackers, bản phát hành đầu tiên có thể đơn giản. DeepSeek trực tiếp là phù hợp cho một prototype chỉ dùng một model. Truy cập DeepSeek API thông qua một router tương thích OpenAI sẽ gọn hơn khi sản phẩm so sánh các model, chạy coding agents, phục vụ khách hàng với nhu cầu độ trễ hoặc chi phí khác nhau, hoặc cần một nơi để gỡ lỗi việc sử dụng token.

Bước 2: Thiết lập OpenAI Client của Flatkey

Nếu dự án của bạn đã sử dụng OpenAI SDK, việc thiết lập router chủ yếu chỉ là thay đổi base URL và khóa.

Python:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["FLATKEY_API_KEY"],
    base_url="https://router.flatkey.ai/v1",
)

Node.js:

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.FLATKEY_API_KEY,
  baseURL: "https://router.flatkey.ai/v1",
});

Phiên bản DeepSeek trực tiếp sử dụng cùng kiểu client giống OpenAI nhưng trỏ đến DeepSeek:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DEEPSEEK_API_KEY"],
    base_url="https://api.deepseek.com",
)

Hãy giữ cả hai khóa trong biến môi trường hoặc kho lưu trữ bí mật. Đừng bao giờ commit FLATKEY_API_KEY, DEEPSEEK_API_KEY, hoặc một cấu hình ghi đè cho môi trường staging vào repository.

Bước 3: Xác minh ID mô hình trước yêu cầu đầu tiên

Truy cập DeepSeek API thông qua một router tương thích OpenAI nên bắt đầu bằng việc khám phá model, không phải bằng một chuỗi model sao chép sẵn.

Với Flatkey, hãy hỏi router xem các model ID nào tài khoản của bạn có thể truy cập:

curl https://router.flatkey.ai/v1/models \
  -H "Authorization: Bearer $FLATKEY_API_KEY"

Sau đó xác nhận lựa chọn ứng viên trên thư mục model và trang giá của Flatkey đang hoạt động. Với DeepSeek trực tiếp, xác nhận tên model trong tài liệu và trang giá của DeepSeek. Tại thời điểm kiểm tra nguồn này, tài liệu của DeepSeek chỉ code mới tới deepseek-flash và deepseek-v4-pro, đồng thời cảnh báo rằng các bí danh V4 Flash cũ chỉ là tên tương thích.

Tạo một manifest nhỏ:

models:
  deepseek_default:
    id: deepseek-flash
    route: flatkey
    base_url: https://router.flatkey.ai/v1
    use_for:
      - coding_assistant
      - structured_extraction
      - long_context_review
    owner: product_engineering
    rollback: previous_production_model

Đây là bản ghi review lộ trình DeepSeek. Nó cho bạn một nơi để ghi lại model ID, chủ sở hữu route, trường hợp sử dụng, và mục tiêu rollback trước khi lưu lượng production phụ thuộc vào route. Hãy giữ nó cùng checklist phát hành của bạn để Truy cập DeepSeek API thông qua một router tương thích OpenAI luôn có thể kiểm toán sau khi ra mắt.

Bước 4: Thực hiện Chat Completion đầu tiên

Bắt đầu với một yêu cầu ngắn, mang tính xác định. Đây là một bài kiểm tra route, không phải benchmark.

response = client.chat.completions.create(
    model="deepseek-flash",
    messages=[
        {"role": "system", "content": "Trả lời ngắn gọn các khuyến nghị triển khai."},
        {"role": "user", "content": "Giải thích vì sao cấu hình base_url quan trọng trong một câu."},
    ],
    temperature=0.2,
    max_tokens=120,
)

print(response.choices[0].message.content)

Nếu yêu cầu thất bại, hãy kiểm tra theo thứ tự sau:

Kiểm tra	Nó phát hiện điều gì
`base_url`	Nhầm lẫn giữa direct và router, thiếu `/v1`, sai đường dẫn nhà cung cấp
Biến API key	Biến môi trường rỗng, sai loại key, key staging trong production
ID mô hình	Alias đã lỗi thời, tài khoản không có quyền truy cập, lỗi chính tả
Dạng endpoint	Không khớp giữa Chat Completions, Responses và Anthropic Messages
Hỗ trợ tính năng	Giả định về vision, chế độ thinking, JSON, tools hoặc streaming
Nhật ký sử dụng	Yêu cầu chưa bao giờ tới router, lỗi nhà cung cấp, sai lệch token/chi phí

Thứ tự này ngăn một lỗi gỡ lỗi phổ biến: coi lỗi cấu hình là lỗi mô hình.

Bước 5: Kiểm tra các tính năng mà ứng dụng của bạn thực sự sử dụng

OpenAI-compatible không có nghĩa là mọi nhà cung cấp, mô hình hoặc đường dẫn router đều hoạt động giống hệt nhau. Hãy kiểm tra những tính năng quan trọng đối với workload của bạn.

Tính năng	Smoke test	Điều kiện đạt
Chat không streaming	Một prompt ngắn	Trả về được tin nhắn dùng được kèm dữ liệu usage
Streaming	Cùng prompt với streaming bật	Các chunk đến theo đúng thứ tự và giao diện đóng sạch sẽ
Đầu ra JSON	Một tác vụ trích xuất nhỏ	Đầu ra xác thực được theo schema của bạn hoặc đường dẫn sửa lỗi
Gọi tool	Một schema hàm đơn giản	Các trường tool-call phân tích được mà không cần hack tùy biến
Ngữ cảnh dài	Đầu vào dài đại diện	Độ trễ, chi phí và chất lượng vẫn chấp nhận được
Vision	Prompt bằng hình ảnh chỉ khi dùng mô hình có hỗ trợ vision	Yêu cầu chỉ thành công trên route hỗ trợ vision
Xử lý lỗi	ID mô hình không hợp lệ trong staging	Ứng dụng ghi log lỗi route mà không lộ keys

Sau mỗi bài kiểm tra Flatkey, hãy mở Usage Logs. Yêu cầu nên hiển thị mô hình dự kiến, số token, trạng thái, dấu thời gian, API key, độ trễ và chi phí. Nếu không thấy gì, hãy xác nhận base URL và key mà yêu cầu thực sự đã dùng.

Bước 6: Chuẩn hóa chi phí theo đầu ra được chấp nhận

Giá token được công bố của DeepSeek có thể trông rất hấp dẫn, nhưng giá token chỉ là một phần của chi phí production. Hãy so sánh theo đầu ra được chấp nhận.

Hãy dùng bảng tính này:

Chỉ số	Vì sao nó quan trọng
Token đầu vào	Prompt ngữ cảnh dài có thể chi phối chi phí.
Token đầu ra	Các tác vụ agent và coding có thể tạo ra phản hồi dài hơn nhiều so với tác vụ chat.
Hành vi cache	Đầu vào cache-hit và cache-miss có thể được tính giá khác nhau.
Tỷ lệ retry	Một route rẻ sẽ trở nên đắt nếu nó cần lặp lại nhiều lần.
Tỷ lệ bị từ chối	JSON không hợp lệ, tool call yếu hoặc câu trả lời chất lượng thấp nên bị tính vào chi phí của route.
Sử dụng fallback	Lưu lượng fallback phải được nhìn thấy, không được coi như sai số làm tròn.
Thời gian sửa thủ công	Dọn dẹp thủ công là một phần của chi phí sản phẩm thực tế.

Công thức thực tế:

accepted_output_cost =
  (successful_request_cost + retry_cost + fallback_cost + human_repair_cost)
  / accepted_outputs

Sử dụng trang giá trực tiếp của DeepSeek cho các đơn vị của nhà cung cấp trực tiếp. Sử dụng trang giá trực tiếp của Flatkey và Usage Logs của bạn cho các khoản phí theo đường đi router. Không sao chép một hàng giá tĩnh vào tài liệu ứng dụng nếu không có ngày kiểm tra và người chịu trách nhiệm làm mới.

Bước 7: Thêm Chính sách Rollback

Việc truy cập DeepSeek API thông qua một router tương thích OpenAI phải có thể đảo ngược trước khi người dùng phụ thuộc vào nó.

deepseek_rollout:
  environment: production
  default_model: deepseek-flash
  route: flatkey
  start_percentage: 10
  increase_when:
    - accepted_output_rate >= 0.95
    - p95_latency_ms <= 4500
    - error_rate <= 0.02
    - usage_log_present: true
    - accepted_output_cost_within_budget: true
  rollback_when:
    - error_rate > 0.05
    - schema_failures_above_threshold: true
    - usage_log_missing: true
    - unexpected_cost_spike: true
  rollback_action:
    set_model: previous_production_model
    notify: engineering_owner

Chính sách này không yêu cầu một team platform. Nó cần một người sở hữu route, một manifest mô hình, một thói quen rà soát usage, và một bài kiểm thử staging trước khi bạn tăng lưu lượng.

Phù hợp ở đâu trong Flatkey

Flatkey phù hợp khi DeepSeek là một phần của quy trình định tuyến mô hình rộng hơn:

Bạn đã dùng các SDK tương thích OpenAI và muốn một base URL cho nhiều họ mô hình.
Bạn cần các key hoặc quota riêng cho development, staging, production, hoặc các coding agent.
Bạn muốn DeepSeek, Qwen, Gemini, Claude, GPT, và các mô hình khác được xem xét thông qua một danh mục mô hình và quy trình usage duy nhất.
Bạn cần một đường rollback khi model ID, đơn vị giá, tính năng, hoặc tuyến provider thay đổi.

Bắt đầu với Flatkey API quickstart, dùng hướng dẫn di chuyển sang lựa chọn thay thế OpenAI API nếu bạn đang thay thế các lời gọi trực tiếp tới provider, và ghép checklist này với các kiểm tra định tuyến API DeepSeek so với Qwen khi các workload nhạy cảm về chi phí so sánh các nhà cung cấp theo khu vực.

Đối với các quyết định production, hãy kiểm tra thư mục mô hình Flatkey, trang giá, và trang trạng thái trực tiếp. Đối với hành vi mô hình DeepSeek và giá trực tiếp từ nhà cung cấp, hãy kiểm tra tài liệu API và trang giá của DeepSeek vào đúng ngày bạn triển khai.

Checklist cuối cùng cho việc truy cập DeepSeek API thông qua một router tương thích OpenAI

Trước khi triển khai quyền truy cập DeepSeek API cho người dùng, hãy xác nhận:

Mã model hiện tại trong tài liệu DeepSeek và trong danh sách model có thể truy cập của tài khoản Flatkey.
Các bài kiểm tra trực tiếp với DeepSeek sử dụng https://api.deepseek.com và một khóa API DeepSeek.
Các bài kiểm tra router Flatkey sử dụng https://router.flatkey.ai/v1 và một khóa API Flatkey.
Bạn không đang dùng deepseek-v4-flash hoặc deepseek-v4-flash-vision-exp như một tên model sản xuất mới.
Chat, streaming, đầu ra JSON, lời gọi tool, ngữ cảnh dài và vision được kiểm thử riêng khi ứng dụng của bạn cần chúng.
Usage Logs hiển thị ID model dự kiến, trạng thái, số lượng token, dấu thời gian, độ trễ, khóa API và chi phí.
Chi phí được chuẩn hóa theo đầu ra đã được chấp nhận, không chỉ theo mức token niêm yết.
Rollback là một thay đổi cấu hình, không phải viết lại code khẩn cấp.
Khóa của nhà cung cấp được lưu trong biến môi trường hoặc kho bí mật, không bao giờ trong code.

Truy cập DeepSeek API thông qua một router tương thích OpenAI là một mẫu tích hợp đơn giản khi tuyến đường được xác định rõ. Hãy dùng trực tiếp DeepSeek khi bạn chỉ cần DeepSeek. Hãy dùng Flatkey khi DeepSeek nằm trong một sản phẩm đa model cần một client, một base URL, một vòng lặp sử dụng duy nhất và một đường dẫn rollback rõ ràng.

Câu hỏi thường gặp

DeepSeek có hỗ trợ API của OpenAI không?

Tài liệu hiện tại của DeepSeek cho biết API DeepSeek sử dụng định dạng API tương thích với OpenAI và Anthropic. Base URL theo định dạng OpenAI là https://api.deepseek.com.

Base URL của Flatkey cho truy cập DeepSeek API là gì?

Sử dụng https://router.flatkey.ai/v1 cho API tương thích OpenAI của Flatkey. Sau đó chọn một ID model DeepSeek hiện tại từ phản hồi /v1/models mà tài khoản của bạn có thể truy cập và từ thư mục model trực tiếp của Flatkey.

Tôi có thể dùng cùng một OpenAI SDK cho DeepSeek thông qua Flatkey không?

Có. Cấu hình OpenAI SDK với khóa API Flatkey và https://router.flatkey.ai/v1 làm base URL. Yêu cầu vẫn giữ cấu trúc Chat Completions quen thuộc cho các model tương thích.

Tên model DeepSeek nào nên được code mới sử dụng?

Hãy kiểm tra tài liệu DeepSeek trực tiếp trước khi triển khai. Tại thời điểm kiểm tra nguồn này, DeepSeek liệt kê deepseek-flash và deepseek-v4-pro; họ nói các tên V4 Flash cũ được chấp nhận để tương thích nhưng được phục vụ bởi DeepSeek-V4.1-Flash.

Tôi có nên công bố chính xác giá DeepSeek trong tài liệu ứng dụng của mình không?

Chỉ khi bạn bao gồm ngày đã kiểm tra và người chịu trách nhiệm cập nhật. Trang giá của DeepSeek sử dụng mức token giờ cao điểm và giờ thấp điểm, và tính khả dụng của tuyến Flatkey hoặc đơn vị giá nên được xác minh trên các trang giá và model trực tiếp của Flatkey.