Forem: Sebastian Petrus

Cập Nhật APIDOG Tháng 4: Gỡ Lỗi AI Agent, Gỡ Lỗi A2A, Dễ Dàng Chuyển Đổi Postman

Sebastian Petrus — Wed, 29 Apr 2026 08:49:23 +0000

Bản phát hành tháng 4 tập trung vào một mục tiêu chính: giúp việc kiểm tra và gỡ lỗi quá trình phát triển AI Agent dễ thực hiện hơn trong các dự án thực tế.

Dùng thử Apidog ngay hôm nay

Nếu bạn đang xây dựng agent, vấn đề khó không chỉ là câu trả lời cuối cùng. Phần cần kiểm tra thường nằm ở toàn bộ chuỗi xử lý trước đó:

Agent hiểu yêu cầu người dùng như thế nào?
Agent đã gọi công cụ nào?
Công cụ trả về dữ liệu gì?
Lỗi đến từ prompt, cấu hình model, tham số tool hay logic nghiệp vụ?

Trong bản cập nhật này, Apidog bổ sung một số công cụ để xử lý các tình huống đó: AI Agent Debugger, A2A Debugger, nhập API Postman cho các đợt di chuyển lớn, trải nghiệm Ask AI tốt hơn trong tài liệu đã xuất bản và hỗ trợ nhà cung cấp mô hình tùy chỉnh.

⭐ Cập Nhật Mới

🔥 AI Agent Debugger: Kiểm Tra Toàn Bộ Quá Trình Hoạt Động Của Agent

Apidog đã hỗ trợ gỡ lỗi trực quan cho các endpoint SSE trong một thời gian. Tính năng này hữu ích khi bạn cần kiểm tra:

phản hồi streaming từ model,
cập nhật tiến độ,
thông báo thời gian thực,
các API dựa trên event.

Tuy nhiên, gỡ lỗi agent cần nhiều hơn một trình xem stream.

Một phản hồi cuối cùng chỉ cho bạn biết agent đã kết thúc ở đâu. Nó không cho biết agent đã đi qua những bước nào để tạo ra phản hồi đó.

Trong một workflow agent thực tế, bạn thường cần kiểm tra:

các lượt hội thoại,
các lần gọi model,
các lần gọi công cụ MCP,
quá trình chạy Skill tùy chỉnh,
kết quả trả về từ tool,
đầu ra cuối cùng.

AI Agent Debugger được xây dựng cho mục đích này.

Thay vì chỉ kiểm tra response cuối cùng, bạn có thể theo dõi đường dẫn thực thi của agent trong Apidog. Mỗi vòng hội thoại, model call, MCP tool call, Skill run và kết quả cuối cùng đều được ghi lại ở một nơi.

Một quy trình kiểm tra thực tế có thể như sau:

Chạy agent với input cần debug.
Mở trace thực thi trong AI Agent Debugger.
Kiểm tra từng bước agent đã thực hiện.
Xác minh prompt có đủ ngữ cảnh hay không.
Kiểm tra tool được chọn có đúng với ý định người dùng không.
Xem dữ liệu tool trả về trước khi agent tạo câu trả lời cuối cùng.
Khoanh vùng lỗi ở prompt, model config, tool params hoặc business logic.

Các câu hỏi bạn có thể trả lời nhanh hơn:

Prompt có cung cấp đủ ngữ cảnh cho model không?
Agent có chọn đúng tool không?
Công cụ MCP có trả về kết quả mong đợi không?
Vấn đề đến từ cấu hình model, tham số tool hay logic nghiệp vụ?

Với các hệ thống agent phức tạp, trace thực thi giúp nhóm phát triển nhìn rõ điều gì thực sự đã xảy ra, thay vì chỉ đoán dựa trên output cuối cùng.

🤝 A2A Debugger: Kiểm Tra Giao Tiếp Giữa Các Agent

Các hệ thống multi-agent đang xuất hiện nhiều hơn. Khi nhiều agent phối hợp với nhau, bạn cần kiểm tra luồng giao tiếp giữa chúng một cách đáng tin cậy.

Apidog hiện hỗ trợ gỡ lỗi cho giao thức A2A của Google, tức Agent-to-Agent.

Bạn có thể dùng A2A Debugger để:

gửi request A2A trực tiếp,
kiểm tra request parameters,
xem response,
xác minh kết quả của tương tác giữa các agent.

Quy trình kiểm tra cơ bản:

Chuẩn bị request A2A.
Gửi request trong Apidog.
Kiểm tra payload và tham số.
Xem response từ agent nhận.
Xác minh kết quả có đúng với nhiệm vụ được chuyển giao không.

Điểm khác nhau giữa hai công cụ gỡ lỗi mới:

AI Agent Debugger: kiểm tra những gì xảy ra bên trong một agent khi nó thực hiện một tác vụ.
A2A Debugger: kiểm tra một agent có thể giao tiếp với agent khác hay không.

Nếu bạn đang xây dựng hệ thống multi-agent, bạn sẽ thường cần cả hai: một công cụ để debug nội bộ từng agent, và một công cụ để debug giao tiếp giữa các agent.

📦 Nhập Dữ Liệu Postman Thông Qua Postman API

Tính năng di chuyển từ Postman hiện có thêm lựa chọn phù hợp hơn cho các nhóm lớn.

Trước đây, Apidog đã hỗ trợ nhập file Postman cục bộ. Bây giờ, bạn cũng có thể nhập:

Workspaces,
Collections,
Environments,

thông qua Postman API.

Cách tiếp cận này phù hợp với các đợt di chuyển hàng loạt khi tạo dự án mới trong Apidog.

Về mặt thực tế, nó gần giống như di chuyển toàn bộ Postman Workspace vào Apidog. Nếu tài khoản Postman của bạn có nhiều Workspace, Apidog sẽ tạo các dự án tương ứng sau khi nhập.

Khi nào nên dùng từng cách:

Tình huống	Cách nhập phù hợp
Chỉ có một vài collection nhỏ	Nhập file Postman cục bộ
Có nhiều workspace, collection và environment	Nhập thông qua Postman API
Cần giảm thao tác export/upload thủ công	Nhập thông qua Postman API

Lợi ích chính là giảm các bước xuất file, tải lên và dọn dẹp thủ công. Với các lần nhập nhỏ, file cục bộ vẫn hoạt động tốt. Với workspace lớn hơn, tuyến API sẽ ít tốn công hơn.

📄 Hỏi AI Trong Tài Liệu Đã Xuất Bản Giờ Đây Mở Ở Thanh Bên

Tính năng Ask AI trong tài liệu đã xuất bản giờ hoạt động trong một thanh bên.

Điều này giúp người đọc giữ nguyên tài liệu hiện tại trong khi đặt câu hỏi về nội dung trên trang.

Một luồng sử dụng thực tế:

Mở tài liệu API đã xuất bản.
Đọc endpoint hoặc phần mô tả đang cần tìm hiểu.
Mở Ask AI ở thanh bên.
Đặt câu hỏi về tài liệu hiện tại.
Tiếp tục đọc mà không mất vị trí trên trang.

Thay đổi này đặc biệt hữu ích với tài liệu dài, nơi câu trả lời có thể đã nằm trong trang nhưng không dễ tìm nhanh.

🧠 Các Nhà Cung Cấp Mô Hình AI Tùy Chỉnh

Các nhóm hiện có thể kết nối nhà cung cấp model tùy chỉnh bằng Base URL tùy chỉnh.

Điều này hữu ích nếu công ty bạn đang dùng:

dịch vụ model tự lưu trữ,
model gateway nội bộ,
hạ tầng AI riêng của tổ chức.

Thay vì chuyển đổi giữa nhiều công cụ khi cần debug workflow liên quan đến AI, bạn có thể đưa thiết lập model đó vào Apidog và kiểm tra trong cùng một môi trường làm việc.

🐞 Sửa Lỗi và Các Cải Thiện Nhỏ Hơn

Bản phát hành tháng này cũng bao gồm một số bản sửa lỗi và cập nhật tiện ích:

Đã khắc phục sự cố khi tính năng hợp nhất thông minh OpenAPI không giữ lại các ví dụ phản hồi endpoint.
Đã khắc phục sự cố khi hợp nhất từ một nhánh con vào một nhánh chính được bảo vệ có thể bao gồm các endpoint không được chọn.
Đã khắc phục hiển thị dropdown không chính xác khi tạo các phiên bản endpoint từ các nhánh.
Đã khắc phục sự cố khi TestData và TestCases không hoạt động khi chạy thử nghiệm thông qua CLI.
Đã khắc phục sự cố khi xuất OpenAPI bao gồm các thành phần response từ các module không liên quan.
Đã khắc phục định dạng xuất Markdown cho JSON có nhận xét.
Đã khắc phục lỗi xuất Word do crypto is not defined.
Đã khắc phục sự cố khi nhập Knife4j với Basic Auth được bật không hiển thị các trường tên người dùng và mật khẩu.
Đã khắc phục lỗi lọc endpoint khi các tag là số.
Đã khắc phục sự cố khi apidog endpoint list --branch không trả về dữ liệu cho nhánh được chỉ định.
Đã khắc phục một số vấn đề về tham số, lọc và thông báo lỗi của công cụ MCP.
Đã khắc phục sự cố khi mã được tạo thiếu tùy chọn cấu hình typescriptThreePlus.

🌟 Ý Nghĩa Của Bản Cập Nhật Này

Bản phát hành tháng 4 tập trung vào các nhu cầu thực tế của nhóm đang xây dựng sản phẩm AI Agent.

Tóm tắt cách dùng từng tính năng:

Tính năng	Dùng khi nào
AI Agent Debugger	Cần xem toàn bộ quá trình thực thi bên trong một agent
A2A Debugger	Cần kiểm tra giao tiếp giữa các agent
Nhập Postman qua API	Cần di chuyển nhiều workspace, collection hoặc environment
Ask AI trong thanh bên	Cần đọc tài liệu và hỏi AI mà không rời trang
Nhà cung cấp model tùy chỉnh	Cần dùng model tự lưu trữ hoặc gateway nội bộ trong Apidog

Các cập nhật này không chỉ phục vụ demo. Chúng giải quyết những vấn đề thường xuất hiện khi agent workflow chuyển từ thử nghiệm sang triển khai thực tế: trace khó đọc, tool call khó kiểm tra, giao tiếp giữa agent khó xác minh và di chuyển dữ liệu API tốn thời gian.

💬 Tham Gia Cuộc Trò Chuyện

Kết nối với các kỹ sư API khác và nhóm Apidog:

Tham gia cộng đồng Discord của chúng tôi để thảo luận và hỗ trợ theo thời gian thực.
Tham gia cộng đồng Slack của chúng tôi để trao đổi kỹ thuật.
Theo dõi chúng tôi trên X (Twitter) để nhận các cập nhật mới nhất.

Tái bút: Để biết đầy đủ chi tiết về tất cả các cập nhật, hãy xem Apidog Changelog!

Trân trọng,

Đội ngũ Apidog

Giá GitHub Copilot: Những Điều Đội API Cần Biết

Sebastian Petrus — Wed, 29 Apr 2026 07:10:19 +0000

Mô hình thanh toán của GitHub Copilot đã thay đổi nhiều lần trong năm qua. Từ tháng này, tính năng Copilot code review trên pull request bắt đầu tiêu thụ GitHub Actions minutes từ tài khoản thanh toán sở hữu repository. Với các nhóm API, điều này có nghĩa là bạn cần theo dõi đồng thời ba chỉ số: Copilot seats, premium requests và Actions minutes.

Dùng thử Apidog hôm nay

Bài viết này tập trung vào cách ước tính chi phí, cấu hình workflow để giảm lãng phí và tổ chức lại quy trình API để các bước spec, contract test và AI review không nằm rải rác trên nhiều dashboard thanh toán.

TL;DR

Copilot hiện có ba nhóm chi phí chính:
- License theo seat
- Premium requests
- GitHub Actions minutes cho Copilot code review
Copilot code review trên PR chạy như một GitHub Action ẩn và tiêu thụ Actions minutes của tổ chức.
Repository API thường tốn nhiều hơn vì PR lớn hơn: openapi.yaml, generated client, handler và contract test.
Premium requests áp dụng cho các tác vụ agentic như Workspace, agent mode và Copilot Spaces.
Hãy đặt spending limit trước chu kỳ thanh toán tiếp theo.
Với repository API đang hoạt động, nên dự trù khoảng 400–800 Actions minutes/tháng/repository cho Copilot review, sau đó đo lại sau 30 ngày.

1. Ba chỉ số Copilot cần theo dõi

Trước đây Copilot chủ yếu là chi phí theo seat. Hiện tại bạn cần tách thành ba phần.

Chỉ số 1: License theo seat

Đây là khoản phí cố định:

Gói	Giá
Copilot Business	$10/user/month
Copilot Enterprise	$19/user/month

Khoản này bao gồm:

Chat
Inline autocomplete
Multi-line suggestions
IDE integration
Truy cập nhóm model tiêu chuẩn

Seat là phần dễ dự báo nhất, nhưng cũng dễ bị cấp phát thừa nhất.

Việc nên làm:

Xuất danh sách người dùng Copilot mỗi quý.
Kiểm tra người dùng không hoạt động.
Thu hồi seat khỏi tài khoản không còn dùng.
So sánh số seat với số developer thực sự viết code hằng tuần.

Công thức đơn giản:

seat_cost = active_users × seat_price

Ví dụ:

Copilot Business:   active_users × $10
Copilot Enterprise: active_users × $19

Chỉ số 2: Premium requests

Premium request là đơn vị GitHub dùng cho các tính năng tốn tài nguyên hơn.

Các tác vụ thường bị tính premium request gồm:

Agent mode
Workspace
Copilot Spaces
Chọn model ngoài mặc định

Bảng tham chiếu hiện tại:

Tính năng	Chi phí theo premium request
Chat với model mặc định	Miễn phí cho gói trả phí
Inline autocomplete	Miễn phí cho gói trả phí
Agent mode với model mặc định	1 request
Workspace với model mặc định	1 request
Chọn Claude Sonnet 4.5	Hệ số 1.5x
Chọn GPT-5.5	Hệ số 2x
Chọn GPT-5.5 Pro	Hệ số 6x
Truy vấn Copilot Spaces	1 request/truy vấn

Hạn mức bao gồm:

Gói	Premium requests bao gồm
Copilot Business	300 requests/seat/month
Copilot Enterprise	1.000 requests/seat/month

Phần vượt mức hiện được tính:

$0.04 / premium request

Công thức ước tính:

premium_overage = max(0, requests_used - included_requests) × $0.04

Với nhóm API, các prompt dễ tạo premium usage cao thường là:

Tạo lại OpenAPI client từ spec mới

Viết contract test cho endpoint này

Refactor handler và cập nhật test tương ứng

Một prompt duy nhất có thể tạo ra nhiều bước nội bộ, nên một yêu cầu của người dùng có thể dẫn đến nhiều premium requests.

Chỉ số 3: GitHub Actions minutes cho Copilot code review

Đây là thay đổi mới dễ gây bất ngờ nhất.

Khi Copilot tự động review một pull request, quá trình review chạy trên hạ tầng GitHub Actions. Vì vậy, thời gian chạy của review bị trừ vào Actions minutes của tổ chức.

Cần lưu ý:

Số phút này dùng chung với quota GitHub Actions hiện có.
Đây không phải quota riêng cho Copilot.
Repository private tiêu thụ Actions minutes.
Repository public thường không làm phát sinh chi phí Actions minutes tương tự.

Hạn mức tham chiếu:

Gói GitHub	Actions minutes Linux
Team	3.000 minutes/month
Enterprise	50.000 minutes/month

Một Copilot review trên PR API thường tiêu thụ:

2–6 minutes/review

Với PR lớn, nhiều file hoặc cần nhiều ngữ cảnh repository hơn, con số có thể lên đến:

~15 minutes/review

Công thức ước tính:

review_minutes = prs_per_month × average_review_minutes

Ví dụ:

50 PRs/month × 4 minutes = 200 Actions minutes/month

Nếu bạn có ba repository API tương tự:

200 × 3 = 600 Actions minutes/month

2. Vì sao repository API thường tốn nhiều hơn?

Repository API thường tiêu thụ nhiều Copilot và Actions hơn repository frontend nhỏ vì ba lý do.

1. Pull request lớn hơn

Một thay đổi API thường đụng đến nhiều loại file:

openapi.yaml
generated clients
server handlers
contract tests
integration tests

Copilot review phải đọc diff lớn hơn, nên thời gian chạy lâu hơn.

2. Generated code làm tăng kích thước diff

Nhiều nhóm vẫn commit generated clients vào repository.

Ví dụ:

clients/typescript/**
clients/python/**
clients/java/**

Nếu PR cập nhật spec và regenerate toàn bộ client, Copilot review sẽ đọc cả phần generated diff đó, dù giá trị review ở phần này thường thấp.

3. Nhiều scanner cùng chạy trên một PR

Một PR có thể đồng thời kích hoạt:

Copilot review
CodeQL
Snyk
Custom security scanner
Contract test
Integration test

Copilot review là phần mới được thêm vào bill, nhưng nó chạy cùng nhóm Actions minutes với các bước còn lại.

3. Cách ước tính chi phí Copilot hằng tháng

Hãy tính theo ba lớp: seat, premium request và Actions minutes.

Bước 1: Tính seat cost

seat_cost = active_users × seat_price

Ví dụ với 10 developer dùng Copilot Enterprise:

10 × $19 = $190/month

Bước 2: Tính premium request overage

Ước lượng usage theo nhóm người dùng:

Kiểu người dùng	Premium requests/tháng ước tính
Chủ yếu chat và autocomplete	~150
Dùng Workspace/agent mode thường xuyên	~600–800

Với Copilot Business:

included_requests = seats × 300

Với Copilot Enterprise:

included_requests = seats × 1.000

Công thức:

premium_overage = max(0, requests_used - included_requests) × $0.04

Ví dụ:

requests_used = 4.000
included_requests = 3.000
overage = (4.000 - 3.000) × $0.04
        = $40

Việc nên làm ngay:

Đặt spending limit ở cấp organization.
Không để mặc định không giới hạn.
Theo dõi nhóm dùng agent mode nhiều nhất.

Bước 3: Tính Actions minutes cho Copilot review

Dùng mức trung bình 4 phút cho mỗi PR API cỡ vừa:

review_minutes = prs_per_month × 4

Nếu vượt quota Actions còn lại:

review_overage = max(0, review_minutes - actions_quota_remaining) × $0.008

Áp dụng cho Linux private repositories theo mức được nêu trong bài gốc.

Ví dụ nhóm 10 developer, 200 PRs/tháng:

review_minutes = 200 × 4
               = 800 minutes/month

Nếu vẫn nằm trong quota Enterprise thì chi phí review phát sinh có thể là:

$0

Tổng ước tính:

seat_cost       = $190
premium_overage = $40
review_overage  = $0
total           = ~$230/month

Với nhóm nhỏ hơn trên Copilot Business và GitHub Team, quota thấp hơn nên nguy cơ vượt mức sẽ cao hơn.

4. Tối ưu workflow CI để giảm Actions minutes

Ba thay đổi dưới đây thường giúp giảm chi phí ngay mà không làm mất giá trị review.

4.1. Bỏ qua Copilot review cho bot PRs

Các PR từ Dependabot hoặc Renovate thường là update dependency tự động. Không phải lúc nào cũng cần Copilot review.

Ví dụ workflow:

on:
  pull_request:
    types: [opened, synchronize]

jobs:
  copilot-review:
    if: github.actor != 'dependabot[bot]' && github.actor != 'renovate[bot]'
    runs-on: ubuntu-latest
    steps:
      - uses: github/copilot-review@v1

Nếu tổ chức có bot nội bộ, thêm vào điều kiện:

if: >
  github.actor != 'dependabot[bot]' &&
  github.actor != 'renovate[bot]' &&
  github.actor != 'internal-release-bot'

4.2. Không review generated clients

Nếu repository commit generated clients, hãy loại chúng khỏi trigger review.

Ví dụ cấu trúc repository:

apis/openapi.yaml
internal/handlers/**
tests/contract/**
clients/typescript/**
clients/python/**

Bạn thường muốn review:

apis/**
internal/**
tests/**

Và bỏ qua:

clients/**

4.3. Giới hạn Copilot review bằng path filter

Chỉ chạy review khi PR thay đổi các file quan trọng với API behavior.

Ví dụ:

on:
  pull_request:
    paths:
      - 'apis/**/*.yaml'
      - 'cmd/**'
      - 'internal/**'
      - 'tests/**'

Cách này giúp Copilot tập trung vào:

API spec
Handler logic
Test coverage
Contract behavior

Thay vì tốn phút cho generated code hoặc file không liên quan.

5. Bốn kiểm soát governance nên bật

Những thiết lập này thường mất ít thời gian nhưng giúp tránh bill bất ngờ.

5.1. Đặt spending limit ở cấp organization

Không nên để mặc định không giới hạn.

Quy trình đề xuất:

Xem chi phí Copilot và Actions tháng trước.
Chọn mức ngân sách chấp nhận được.
Đặt limit thấp hơn khoảng 20%.
Kiểm tra lại sau 30 ngày.

5.2. Bật cảnh báo premium request

GitHub gửi cảnh báo ở các mốc:

50%
75%
90%

Không nên chỉ để email trong inbox cá nhân.

Nên route cảnh báo vào:

Slack
Microsoft Teams
Incident tool
FinOps channel

5.3. Dùng label để kích hoạt review có chọn lọc

Thay vì chạy Copilot review trên mọi PR, có thể chỉ chạy khi PR có label:

review-please

Mô hình này phù hợp với:

PR thay đổi API behavior
PR có logic phức tạp
PR đụng đến security-sensitive handler
PR có migration hoặc breaking change

Cách này có thể giảm đáng kể số lượt review không cần thiết.

5.4. Rollout theo team

Không nên bật toàn bộ tính năng Copilot Enterprise cho cả organization cùng lúc.

Cách an toàn hơn:

Chọn một team API nhỏ.
Bật tính năng mới.
Theo dõi 30 ngày.
Đo premium requests và Actions minutes.
Mở rộng nếu chi phí và chất lượng review hợp lý.

6. Đặt Apidog vào workflow API như thế nào?

Apidog không thay thế Copilot. Vai trò phù hợp hơn là giữ spec, mock và contract test trong cùng một workflow để Copilot chỉ review những PR đã vượt qua kiểm tra rẻ hơn.

Một workflow thực tế:

Developer cập nhật API spec.
Request examples và collection được lưu cùng repository.
Contract test chạy với Apidog mock server.
CI chạy apidog-cli để validate contract.
Chỉ khi contract validation pass, Copilot review mới chạy.

Luồng đề xuất:

OpenAPI spec change
        ↓
Apidog mock + contract validation
        ↓
apidog-cli in CI
        ↓
Copilot code review
        ↓
Merge

Lý do nên đặt contract validation trước Copilot review:

Contract test thường nhanh hơn.
Lỗi spec nên fail sớm.
Copilot review là bước tốn Actions minutes hơn.
AI review nên tập trung vào handler logic và test coverage, không phải lỗi contract cơ bản.

Ví dụ logic CI ở mức khái niệm:

jobs:
  contract-test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run API contract validation
        run: apidog-cli validate

  copilot-review:
    needs: contract-test
    if: success()
    runs-on: ubuntu-latest
    steps:
      - uses: github/copilot-review@v1

Mục tiêu là fail nhanh ở bước rẻ hơn, rồi mới dùng Copilot review cho phần đáng review.

7. Theo dõi gì trong chu kỳ billing tiếp theo?

Nên kiểm tra theo ba giai đoạn.

Ngày 1–7

Premium request usage thường vẫn thấp.

Việc cần làm:

Ghi baseline usage.
Kiểm tra số seat active.
Xác nhận spending limit đã bật.

Ngày 14–21

Người dùng nặng bắt đầu vượt hạn mức included requests.

Việc cần làm:

Kiểm tra ai dùng agent mode nhiều.
Xem premium request overage.
Điều chỉnh model hoặc workflow nếu cần.

Ngày 28–30

Actions minutes từ Copilot review bắt đầu rõ hơn trên bill.

Việc cần làm:

So sánh với tháng trước.
Tính minutes/PR.
Lọc bot PRs nếu chưa làm.
Loại generated clients khỏi review.
Tắt review ở repository không cần thiết.

8. Các lỗi phổ biến

Sau khi kiểm toán nhiều nhóm API, các lỗi lặp lại thường là:

8.1. Không đặt spending limit

Một vòng lặp agent có thể chạy lâu hơn dự kiến.

Luôn đặt limit.

8.2. Bật review trên mọi repository

Không phải repository nào cũng cần Copilot review.

Nên phân loại:

Loại repository	Có nên bật review?
Core API	Có
Public SDK generated	Tùy trường hợp
Docs-only repo	Thường không
Sandbox/prototype	Thường không
Internal tooling nhỏ	Tùy mức độ rủi ro

8.3. Review generated clients

Generated code thường tạo diff lớn nhưng giá trị review thấp.

Hãy lọc bằng path.

8.4. Review PR của bot

Dependabot, Renovate và bot update nội bộ có thể tạo nhiều PR nhỏ.

Hãy loại khỏi Copilot review mặc định.

8.5. Không có baseline

Nếu không có số liệu trước khi thay đổi workflow, bạn không biết mình có tiết kiệm được chi phí hay không.

Nên tải CSV billing của GitHub hằng tháng và lưu lại:

billing/YYYY-MM.csv

Theo dõi tối thiểu:

Copilot seats
Premium requests
Actions minutes
Actions overage
PR count
Average review minutes per PR

FAQ

Giá seat vẫn là $10/user?

Copilot Business là $10/user/month. Copilot Enterprise là $19/user/month. Copilot Pro cho cá nhân là $10/month. Gói seat cũng quyết định hạn mức premium requests được bao gồm.

Inline autocomplete có bị tính phí không?

Không. Chat với model mặc định và inline autocomplete không bị tính phí premium request trên các gói trả phí. Premium requests áp dụng cho các tính năng tốn tài nguyên hơn và lựa chọn model ngoài mặc định.

Điều gì xảy ra khi hết premium request?

Theo mặc định, request có thể bắt đầu thất bại do vượt hạn mức. Bạn có thể đặt spending limit để cho phép overage ở mức $0.04/request cho đến giới hạn đã cấu hình.

Actions minutes cho Copilot review có được thanh toán riêng không?

Không. Chúng dùng cùng pool GitHub Actions minutes với CI/CD còn lại. Vì vậy, cần theo dõi tổng Actions usage và điều chỉnh workflow trigger.

Có thể tắt hoàn toàn Copilot code review không?

Có. Organization admin có thể kiểm soát repository nào được bật Copilot review thông qua policy.

Copilot review có hoạt động với private API spec không?

Có. Với private repository, review tiêu thụ Actions minutes. Copilot đọc spec, handler và test như các file source khác.

Copilot review có dùng premium requests không?

Theo nội dung hiện tại, Copilot review tiêu thụ Actions minutes. Nó không được tính riêng như premium request. Tuy nhiên, đây là phần nên tiếp tục theo dõi trong các changelog của GitHub.

Checklist triển khai nhanh

Nếu bạn chỉ có 30 phút, hãy làm theo thứ tự này:

Đặt organization spending limit.
Xuất danh sách Copilot seats và thu hồi user không hoạt động.
Lọc Dependabot/Renovate khỏi Copilot review.
Thêm paths filter để bỏ qua generated clients.
Đặt contract validation trước Copilot review.
Tải CSV billing cuối tháng.
Tính average_review_minutes_per_pr.
Điều chỉnh lại sau 30 ngày.

Với nhóm API, mục tiêu không phải là tắt AI review. Mục tiêu là để AI review chạy đúng nơi: sau khi contract test đã pass, trên các file có giá trị review cao, và trong giới hạn chi phí mà nhóm kiểm soát được.

Cách sử dụng API Zuplo

Sebastian Petrus — Mon, 27 Apr 2026 08:44:57 +0000

Nếu bạn đã tìm hiểu về Zuplo và muốn triển khai một sản phẩm thực tế, đây là hướng dẫn từng bước tập trung vào triển khai: tạo dự án, cấu hình route, thêm xác thực API key, limit rate, viết chính sách TypeScript tùy chỉnh, deploy ra edge, và kiểm thử toàn bộ với Apidog.

Dùng thử Apidog ngay hôm nay

Đến cuối hướng dẫn, bạn sẽ có một API gateway thực tế trước backend, có xác thực, giới hạn tốc độ, cổng thông tin dev tự động, CI-friendly Git workflow. Thực hiện tất cả trong khoảng 30 phút.

Nếu bạn chưa chắc về Zuplo, hãy đọc bài gốc: Zuplo API gateway là gì. Các trường hợp chi tiết khác xem tại tài liệu Zuplo.

Tóm tắt (TL;DR)

Đăng ký tại portal.zuplo.com hoặc tạo local project với npm create zuplo.
Định nghĩa route trong config/routes.oas.json, dùng URL Forward Handler để proxy đến backend.
Thêm policies (API key, limit rate, schema validation) trong file route hoặc Route Designer.
Code logic custom bằng TypeScript ở modules/; runtime cung cấp kiểu cho request, context, env.
Git push lên nhánh liên kết để deploy preview; merge để production rollout trên hơn 300 PoP.
Kiểm thử routes bằng Apidog trước production.
Miễn phí 100K requests/tháng; Builder $25/tháng.

Điều kiện tiên quyết

Bạn cần:

Tài khoản Zuplo
Một backend API (hoặc dùng https://echo.zuplo.io để test)
Node.js 18+ nếu dùng CLI

Nếu phát triển local, dùng VS Code & extension TypeScript là tiện nhất, có thể kết hợp tiện ích mở rộng Apidog VS Code để gửi request trực tiếp từ editor.

Bước 1: Tạo dự án Zuplo

Có hai cách: qua web portal hoặc CLI.

Tùy chọn A: Bắt đầu từ portal

Đăng nhập portal.zuplo.com.
Chọn "New Project", đặt tên (ví dụ: acme-gateway).
Chọn "Empty Project" để bắt đầu trống.
Tab Code sẽ hiển thị cây file dự án.

Portal sẽ liên kết project với kho Git (GitHub, GitLab, Bitbucket, Azure DevOps). Có thể đổi kho trong Settings.

Tùy chọn B: Bắt đầu từ CLI

Tạo local project để thao tác trên IDE, push/pull Git từ đầu.

npm create zuplo@latest -- --name acme-gateway
cd acme-gateway
npm install
npm run dev

Dev server chạy trên port 9000, mở Route Designer local tại http://localhost:9100. Mọi thay đổi tự reload.

Liên kết dự án local với tài khoản Zuplo để deploy:

npx zuplo link

Chọn tài khoản/môi trường. Sau đó, npx zuplo deploy để deploy nhánh Git hiện tại.

Bước 2: Định nghĩa route đầu tiên

Mở config/routes.oas.json – file OpenAPI 3 mở rộng cho Zuplo.

Ví dụ, thêm route GET /v1/products proxy về backend:

{
  "openapi": "3.1.0",
  "info": { "title": "Acme Gateway", "version": "1.0.0" },
  "paths": {
    "/v1/products": {
      "get": {
        "summary": "Liệt kê sản phẩm",
        "operationId": "list-products",
        "x-zuplo-route": {
          "corsPolicy": "anything-goes",
          "handler": {
            "export": "urlForwardHandler",
            "module": "$import(@zuplo/runtime)",
            "options": {
              "baseUrl": "${env.ORIGIN_URL}"
            }
          },
          "policies": { "inbound": [] }
        },
        "responses": {
          "200": { "description": "Thành công" }
        }
      }
    }
  }
}

x-zuplo-route: mở rộng cho Zuplo nằm trong OpenAPI.
handler: định nghĩa proxy (urlForwardHandler), target từ biến env.

Cấu hình biến ORIGIN_URL trong Settings > Environment Variables (portal) hoặc config/.env (local). Chưa có backend? Dùng https://echo.zuplo.io để test.

Sau khi lưu, dev server reload. Truy cập http://localhost:9000/v1/products sẽ thấy response từ backend.

Bước 3: Thêm xác thực API key

Sửa route để thêm policy:

"policies": {
  "inbound": ["api-key-auth"]
}

Khai báo policy ở config/policies.json:

{
  "name": "api-key-auth",
  "policyType": "api-key-inbound",
  "handler": {
    "export": "ApiKeyInboundPolicy",
    "module": "$import(@zuplo/runtime)",
    "options": {
      "allowUnauthenticatedRequests": false
    }
  }
}

Tạo consumer (chủ sở hữu API key):

Vào Services > API Key Service.
Chọn "Create Consumer".
Đặt subject (ví dụ: acme-customer-1).
Thêm email quản lý key.
Copy API key.

Kiểm thử:

Không gửi header: trả về 401.

curl -i https://YOUR-PROJECT.zuplo.app/v1/products
# HTTP/2 401

Có API key:

curl -i https://YOUR-PROJECT.zuplo.app/v1/products \
  -H "Authorization: Bearer YOUR_API_KEY"
# HTTP/2 200

Để test qua client, import OpenAPI spec vào Apidog, set header mặc định Authorization: Bearer {{api_key}}, link api_key vào biến môi trường – kiểm thử nhanh mọi route.

Bước 4: Giới hạn tốc độ (rate limit) route

Không nên public API mà thiếu rate limit. Thêm policy:

"policies": {
  "inbound": ["api-key-auth", "rate-limit-by-key"]
}

Thêm policy vào config/policies.json:

{
  "name": "rate-limit-by-key",
  "policyType": "rate-limit-inbound",
  "handler": {
    "export": "RateLimitInboundPolicy",
    "module": "$import(@zuplo/runtime)",
    "options": {
      "rateLimitBy": "sub",
      "requestsAllowed": 60,
      "timeWindowMinutes": 1
    }
  }
}

"rateLimitBy": "sub": rate limit theo subject (API key).
"ip": limit theo địa chỉ IP.

Kiểm tra bằng bash:

for i in {1..70}; do
  curl -s -o /dev/null -w "%{http_code}\n" \
    https://YOUR-PROJECT.zuplo.app/v1/products \
    -H "Authorization: Bearer YOUR_API_KEY"
done | sort | uniq -c

Bạn sẽ thấy 60 dòng 200 và 10 dòng 429.

Bước 5: Xác thực payload request (schema validation)

Với route POST nhận JSON body, policy xác thực sẽ reject payload sai format tại gateway.

Thêm route POST:

"/v1/products": {
  "post": {
    "summary": "Tạo sản phẩm",
    "operationId": "create-product",
    "requestBody": {
      "required": true,
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "required": ["name", "priceCents"],
            "properties": {
              "name": { "type": "string", "minLength": 1 },
              "priceCents": { "type": "integer", "minimum": 1 },
              "category": { "type": "string", "enum": ["food", "drink"] }
            }
          }
        }
      }
    },
    "x-zuplo-route": {
      "handler": {/* ... */},
      "policies": {
        "inbound": [
          "api-key-auth",
          "rate-limit-by-key",
          "validate-request"
        ]
      }
    }
  }
}

Thêm policy:

{
  "name": "validate-request",
  "policyType": "open-api-request-validation-inbound",
  "handler": {
    "export": "OpenApiRequestValidationInboundPolicy",
    "module": "$import(@zuplo/runtime)",
    "options": {
      "validateBody": "reject"
    }
  }
}

Gửi POST thiếu trường sẽ bị reject 400 trước khi tới backend. Test với Apidog: tạo các request "thành công", "thiếu trường", "enum sai" thành nhóm, chạy batch chỉ với 1 click.

Bước 6: Viết policy TypeScript custom

Nếu cần logic đặc biệt, chỉ cần viết hàm TypeScript.

Ví dụ: Policy outbound set header Cache-Control khác nhau cho khách trả phí/miễn phí.

Tạo modules/tiered-cache.ts:

import { ZuploRequest, ZuploContext, HttpProblems } from "@zuplo/runtime";

interface PolicyOptions {
  paidPlanHeader: string;
  paidMaxAge: number;
}

export default async function (
  response: Response,
  request: ZuploRequest,
  context: ZuploContext,
  options: PolicyOptions,
): Promise<Response> {
  const plan = request.user?.data?.plan ?? "free";
  if (plan === "free") {
    response.headers.set("Cache-Control", "no-store");
  } else {
    response.headers.set(
      "Cache-Control",
      `public, max-age=${options.paidMaxAge}`,
    );
  }
  context.log.info(`Cache header set for plan=${plan}`);
  return response;
}

Khai báo policy trong config/policies.json:

{
  "name": "tiered-cache",
  "policyType": "custom-code-outbound",
  "handler": {
    "export": "default",
    "module": "$import(./modules/tiered-cache)",
    "options": {
      "paidPlanHeader": "x-plan",
      "paidMaxAge": 300
    }
  }
}

Tham chiếu ở route:

"policies": {
  "inbound": ["api-key-auth", "rate-limit-by-key"],
  "outbound": ["tiered-cache"]
}

Policy chỉ là hàm TypeScript, có thể unit test độc lập (dùng Vitest/Jest) mà không cần deploy.

Bước 7: Triển khai ra edge

Deploy = git push:

git add .
git commit -m "Thêm gateway sản phẩm với xác thực, giới hạn tỷ lệ và bộ nhớ đệm phân cấp"
git push origin feature/products-gateway

Mỗi branch đều có môi trường preview, URL riêng dạng https://acme-gateway-feature-products-gateway-abc123.zuplo.app.

Kiểm thử preview URL qua Apidog bằng cách set làm env mới. Nếu pass, merge branch:

git checkout main
git merge feature/products-gateway
git push origin main

Sau merge, production deploy trên 300+ PoP global trong ~60s. Rollback chỉ cần git revert và push.

Bước 8: Tạo cổng thông tin developer

Cổng thông tin ở https://YOUR-PROJECT.developers.zuplo.com, rebuild mỗi lần deploy. Bao gồm:

Trang docs cho từng route, schema, mô tả, try console
Code sample (cURL, JS, Python, Go, ...)
API key self-service cho user đăng ký
Branding chỉnh ở Developer Portal > Settings

Spec OpenAPI tốt = docs auto hoàn chỉnh. Tuỳ biến? Fork source portal (Next.js) tại GitHub Zuplo/zudoku, nhưng phần lớn dùng bản hosted là đủ.

Bước 9: Kiểm thử toàn bộ với Apidog

Kiểm thử mọi route, policy, error path trước khi production bằng Apidog:

Workflow đề xuất:

Import OpenAPI spec từ https://YOUR-PROJECT.zuplo.app/openapi vào Apidog.
Tạo env cho local, preview, production (mỗi env có base_url, api_key riêng).
Lưu ít nhất 3 request cho mỗi route: success, validation error, rate limit. Batch run trước mỗi deploy.
Dùng test script nối các call (create, list, delete) và kiểm tra response shape.
Gen code sample (ngôn ngữ chính của team) để dán vào runbook.

Chuyển từ Postman? Xem hướng dẫn kiểm thử API không dùng Postman. Tải Apidog nếu chưa có.

FAQ: Sử dụng Zuplo

Làm sao chuyển route giữa các môi trường mà không sửa spec?

Dùng biến môi trường. Định nghĩa ORIGIN_URL cho từng env (portal hoặc local .env), dùng ${env.ORIGIN_URL} trong handler option.

Có chạy Zuplo offline được không?

Được. npm run dev chạy local gateway port 9000, Route Designer port 9100. Policy, xác thực, rate limit vẫn chạy local; chỉ API Key Service cần mạng (có thể dùng npx zuplo link để sync cloud key).

Làm sao rollback deploy lỗi?

git revert commit merge, push lên remote. Zuplo redeploy trạng thái trước. Không cần UI rollback – Git là nguồn sự thật.

Deploy có downtime không?

Không. Deploy atomic tại edge; request đang chạy hoàn thành trên phiên bản cũ, request mới lên version mới.

Zuplo hỗ trợ gRPC/WebSocket không?

Có. urlForwardHandler proxy WebSocket upgrade, có hỗ trợ gRPC handler. REST & GraphQL là phổ biến nhất.

Làm sao public API Zuplo cho AI agent?

Thêm MCP Server Handler vào route, trỏ vào OpenAPI spec, chọn operation public. Auth & rate limit vẫn áp dụng. Xem docs Zuplo MCP Server.

Chi phí gateway Zuplo?

Miễn phí 100K request/tháng. Builder: $25/tháng + 1M request. Thêm request: $100/100K. Enterprise: từ $1,000/tháng. Xem chi tiết tại Zuplo pricing.

Kết luận

Bạn đã có gateway Zuplo có xác thực API key, rate limit, validate request, policy TypeScript custom, cổng dev portal – tất cả deploy qua Git lên edge toàn cầu. Quản lý preview, production, AI agent với cùng một cấu hình.

Vòng lặp kiểm thử giữ mọi thứ ổn định. Dùng Apidog để test preview trước khi merge, tránh lỗi header, thiếu field, rate limit... Tải Apidog và tích hợp ngay với gateway của bạn.

Zuplo API Gateway là gì?

Sebastian Petrus — Mon, 27 Apr 2026 06:31:19 +0000

Hầu hết các cổng API hiện nay vẫn mang cảm giác lỗi thời: phải viết YAML, thao tác thủ công trên bảng điều khiển và phụ thuộc vào đội ngũ vận hành để đẩy thay đổi. Zuplo thay đổi hoàn toàn mô hình này: một cổng API có thể lập trình, edge-native, mọi tuyến đường lưu trữ trên Git, chính sách là TypeScript, và mỗi lần commit được triển khai trên hơn 300 địa điểm chỉ trong vài giây.

Dùng thử Apidog ngay hôm nay

Bài viết này hướng dẫn từng bước cách Zuplo hoạt động, so sánh với Kong và AWS API Gateway, chi phí, và cách triển khai cổng đầu tiên chỉ trong 30 phút. Bạn sẽ thấy các ví dụ code thực tế về routing, xác thực, giới hạn tốc độ, cùng hướng dẫn kiểm thử mọi endpoint bằng Apidog trước khi đưa lên production.

Tóm tắt nhanh

Zuplo là cổng API edge-native, managed, chạy trên hơn 300 data center Cloudflare, độ trễ <50ms, không cold start.
Cấu hình hoàn toàn GitOps; mọi thay đổi đều thông qua CI/CD và pull request.
Chính sách là TypeScript, hỗ trợ IDE đầy đủ, không YAML hay Lua.
Gói miễn phí: 100K request/tháng, unlimited environment, API key, developer portal.
Tích hợp sẵn: xác thực API key, JWT, OAuth2, rate limit, request validation, developer portal tự động, kiếm tiền qua Stripe.
MCP Server Handler: mọi route có thể công khai cho Claude, Codex, Cursor hoặc bất kỳ client MCP nào.
Kiểm thử mọi endpoint Zuplo với Apidog trước production.

Zuplo là gì?

Zuplo là nền tảng quản lý API dựa trên 3 nguyên tắc: code hơn config, edge hơn region, Git hơn GUI. Mọi thứ là TypeScript và deploy thẳng lên biên Cloudflare, không cần tự quản lý hạ tầng.

Thay vì YAML lưu ở control plane DB như Kong, Zuplo coi cổng của bạn là dự án TypeScript: file routes.oas.json mô tả endpoint, thư mục module TS cho code tuỳ chỉnh, file config cho policy. Push lên GitHub là tự động build, validate, deploy.

Hỗ trợ REST, GraphQL, gRPC, WebSocket, SOAP. Đạt SOC2 Type II, backend trên AWS/Azure/GCP, có tuỳ chọn self-hosted Kubernetes. Giá tính theo request, không tính theo user. Xem chi tiết giá tại đây.

Vì sao chọn Zuplo thay vì Kong, Apigee, AWS API Gateway?

Kong: open source mạnh mẽ, cần hiểu sâu Lua, plugin nhiều nhưng developer portal chỉ có ở bản enterprise.
Apigee: enterprise, analytics mạnh, học khó, build developer portal phức tạp.
AWS API Gateway: native AWS, thiếu developer portal, cold start Lambda tốn thời gian.

Zuplo nhắm đến team nhỏ cần tính năng enterprise mà không tốn công vận hành.

Khác biệt nổi bật:

Code, không YAML: Policy rate limit Zuplo chỉ 3 dòng TypeScript (Kong: 15 dòng YAML).
Developer Portal có sẵn: Tự động tạo từ OpenAPI, mọi gói đều có, kể cả free.
GitOps: Mọi thay đổi là pull request, rollback dễ dàng, không cần click UI.
Edge-native, không cold start: Cloudflare Workers, latency cực thấp.

Nếu bạn chưa đầu tư sâu vào Kong, Apigee, hoặc backend đang gặp bottleneck, nên thử workflow của Zuplo.

Các tính năng cốt lõi của Zuplo

Lập trình bằng TypeScript

Mọi policy là file TypeScript. Viết hàm async nhận request/response, tuỳ biến logic, trả về kết quả. Ví dụ: xoá header nội bộ khỏi response:

import { ZuploRequest, ZuploContext } from "@zuplo/runtime";

export default async function (
  response: Response,
  request: ZuploRequest,
  context: ZuploContext,
) {
  response.headers.delete("x-internal-trace-id");
  return response;
}

Chỉ cần đặt vào modules/strip-internal-header.ts, tham chiếu trong route, push lên Git là deploy.

60+ policy dựng sẵn

Hầu hết tính năng phổ biến đã có sẵn policy: API key, JWT, OAuth 2.0, rate limiting (fixed/sliding window, token bucket), request/response validation, CORS, IP allowlist, request transformation... Chỉ cần chỉnh định nghĩa route, không phải viết code cho case phổ thông.

Developer portal tự động

Chỉ cần trỏ portal đến OpenAPI spec, Zuplo tạo ngay docs, playground, code mẫu cURL/JS/Python/Go, user có thể tự đăng ký, lấy API key, gọi thử API. Phù hợp cho SaaS, giảm công sức vận hành.

Kiếm tiền API tích hợp Stripe

Định nghĩa plan (free/pro/enterprise), kết nối Stripe, portal lo phần thanh toán/subscription/billing theo usage. Kong, AWS API Gateway không hỗ trợ built-in như vậy.

MCP Server Handler cho AI agent

Chỉ định MCP handler vào OpenAPI, chọn operation cần công khai, API của bạn có thể gọi từ Claude, OpenAI Codex, Cursor... Policy xác thực và rate limit vẫn giữ nguyên cho agent. Xem hướng dẫn cấu hình MCP tại đây.

Edge deploy, latency <50ms

Mặc định deploy lên 300+ location của Cloudflare, user ở đâu cũng nhận response từ biên gần nhất, không phải tự cấu hình.

Kiến trúc hoạt động của Zuplo

Match route: URL/method khớp trong routes.oas.json.
Policy inbound: Policy như auth/rate limit/validation chạy theo thứ tự. Nếu fail, trả kết quả luôn.
Handler: Uỷ quyền upstream backend/trả static/run code/call MCP handler.
Policy outbound: Biến đổi response, xoá header, logic tuỳ chỉnh.
Response: Trả về client, gửi log & metric sang hệ observability.

Tất cả chạy trong Cloudflare Worker, đảm bảo latency thấp, không trả phí idle.

Hướng dẫn triển khai Zuplo đầu tiên

Bạn có thể có cổng Zuplo hoạt động trong ~30 phút:

Đăng ký zuplo.com, tạo project mới, tích hợp GitHub để project sync với repo của bạn.
Nhập spec OpenAPI: Nếu có sẵn, import vào. Zuplo tạo route từ operation. Nếu chưa có thì phác route UI, export spec sau.
Thêm policy xác thực API key: Trong route editor, thêm api-key-inbound. Zuplo tự tạo DB consumer và UI cấp key.
Thêm rate limit: Thêm rate-limit-inbound, ví dụ 100 request/phút/key, chỉnh JSON trong file route.
Deploy: Push lên branch, Zuplo build môi trường preview với URL riêng. Merge là lên production.
Kiểm thử end-to-end: Dùng Apidog gửi request với API key đúng/sai, vượt rate, payload lỗi... Xác nhận policy hoạt động đúng.

Bạn đã có cổng Zuplo sẵn sàng. Việc khó chỉ là đặt tên route hợp lý và quyết định logic tuỳ chỉnh nằm đâu.

Viết policy tuỳ chỉnh bằng TypeScript

Nếu policy dựng sẵn không đủ, bạn tự viết TypeScript. Ví dụ enrich request bằng user info nội bộ:

import { ZuploRequest, ZuploContext } from "@zuplo/runtime";

interface UserContext {
  userId: string;
  plan: "free" | "pro" | "enterprise";
}

export default async function (
  request: ZuploRequest,
  context: ZuploContext,
): Promise<ZuploRequest | Response> {
  const apiKey = request.user?.sub;
  if (!apiKey) {
    return new Response("Unauthorized", { status: 401 });
  }

  const lookupUrl = `https://internal.example.com/users/${apiKey}`;
  const userResponse = await fetch(lookupUrl, {
    headers: { authorization: `Bearer ${context.environment.INTERNAL_TOKEN}` },
  });

  if (!userResponse.ok) {
    return new Response("User lookup failed", { status: 502 });
  }

  const user = (await userResponse.json()) as UserContext;
  request.headers.set("x-user-id", user.userId);
  request.headers.set("x-user-plan", user.plan);
  return request;
}

Policy là hàm async bình thường, unit test dễ dàng.
Biến môi trường lấy từ context.environment, type-safe.
Trả về Response để ngắt quy trình khi gặp lỗi.

Giá Zuplo năm 2026

Free: 0 USD/tháng. 100K request/tháng, unlimited environment, API key, developer portal, 1GB egress, deploy edge, tối đa 2 developer.
Builder: 25 USD/tháng. 1M request/tháng, 2 custom domain, thêm egress, 100 USD/100K request vượt mức, support cộng đồng.
Enterprise: Từ 1.000 USD/tháng (contract năm). Unlimited request/domain, SLA 99.5–99.999%, SSO, RBAC, add-on observability...

AI Gateway và Developer Portal có tier riêng; portal open source self-hosted dùng miễn phí. Xem giá mới nhất.

So sánh: AWS API Gateway: 3.5 USD/million REST request + egress + Lambda. Kong Enterprise thường đắt hơn Zuplo. Gói free Zuplo đủ dùng cho production giai đoạn đầu.

Khi nào nên chọn Zuplo (và khi nào không)

Nên chọn khi:

Muốn cổng managed, không tự vận hành Kong.
Team thành thạo TypeScript/Javascript.
Cần developer portal không phải tự build.
Muốn kiếm tiền API, cần Stripe tích hợp.
Muốn publish API cho AI agent (Claude, Codex...) qua MCP.
Lưu lượng global, latency biên là cần thiết.

Không nên chọn khi:

Cần kiểm soát hoàn toàn mã nguồn mở (Kong).
Hạ tầng on-prem không ra internet (Kong/Tyk self-hosted).
Yêu cầu customize sâu trên NGINX.
Đã đầu tư lớn vào Apigee/MuleSoft, migration cost cao.

Kiểm thử Zuplo gateway với Apidog

Sau khi deploy môi trường preview, cần test từng route, policy, edge case trước production. Dùng client API chuyên dụng là tối ưu nhất.

Apidog import trực tiếp OpenAPI spec — cùng spec dùng cho Zuplo cũng là spec dùng cho test.

Bạn có thể:

Gọi từng route với API key đúng/sai, test policy auth.
Gửi payload lỗi để check request validation.
Tấn công rate limit để xác nhận policy hoạt động đúng.
Lưu variable cho URL Zuplo preview, production, API key — chuyển môi trường chỉ 1 click.
Sinh code mẫu (cURL, JS, Python, Go) cho tài liệu/devops.
Chạy test script tự động của Apidog, nhanh hơn viết script thủ công.

Nếu bạn chưa dùng Apidog, thử extension VS Code hoặc hướng dẫn chuyển đổi từ Postman. Tải Apidog tại đây.

FAQ về Zuplo

Zuplo có open source không?

Core gateway runtime là closed source, nhưng developer portal và một số thư viện phụ đã open source trên GitHub. Enterprise có tuỳ chọn self-hosted Kubernetes và open source portal đáp ứng hầu hết nhu cầu. Phần lớn team sẽ dùng managed service.

Zuplo có chạy được on-prem/private cloud không?

Có, bản Enterprise hỗ trợ Kubernetes self-hosted. Đổi lại, bạn tự vận hành, không còn deploy edge toàn cầu.

Zuplo khác gì Cloudflare API Shield?

API Shield chỉ tập trung security (schema validation, abuse protection, mTLS). Zuplo là platform quản lý API: routing, policy, portal, monetization, MCP... Có thể dùng song song. Nếu chỉ cần security, dùng API Shield; nếu cần toàn bộ vòng đời, chọn Zuplo.

Zuplo có dùng được với OpenAPI spec cũ của tôi không?

Có, OpenAPI là nguồn chân lý của Zuplo. Nhập spec, tự tạo route, portal, policy validation. Spec bẩn sẽ phát hiện lỗi khi import.

Có thể publish Zuplo cho AI agent (Claude, Codex...) không?

Có, dùng MCP Server Handler. Trỏ handler vào OpenAPI, chọn operation, cổng sẽ gọi được từ mọi client MCP. Policy auth/rate limit tự động áp dụng cho agent.

Deploy Zuplo mất bao lâu?

Chạy build preview trong ~60 giây, lên production còn nhanh hơn. Triển khai atomic, không downtime.

Nếu Cloudflare gặp sự cố thì sao?

Zuplo chạy trên edge Cloudflare, sự cố khu vực Cloudflare sẽ ảnh hưởng cục bộ. Gói Enterprise có tuỳ chọn multi-cloud failover cho SLA 99.999%. Phần lớn team chấp nhận trade-off này vì Cloudflare rất ổn định.

Kết luận

Zuplo phù hợp cho team cần tính năng enterprise mà không muốn vận hành cồng kềnh. TypeScript-first, GitOps, developer portal tự động, kiếm tiền Stripe, hỗ trợ AI MCP — đây là platform API hoàn chỉnh, không chỉ là routing layer. Gói free đủ mạnh cho production nhỏ; gói Enterprise đáp ứng mọi nhu cầu lớn.

Hãy thử setup 30 phút với API thực, test kỹ mọi policy bằng Apidog, rồi quyết định dựa trên trải nghiệm thực tế. Sự kết hợp giữa API gateway edge-managed và client kiểm thử mạnh là con đường nhanh nhất từ “có API” thành “có sản phẩm”. Tải Apidog tại đây và bắt đầu kiểm thử.

Cách Sử Dụng DeepSeek V4 Miễn Phí

Sebastian Petrus — Fri, 24 Apr 2026 05:20:42 +0000

DeepSeek V4 ra mắt ngày 23/4/2026 với lựa chọn miễn phí thực sự: trò chuyện web chính thức chạy V4-Pro mà không cần thẻ tín dụng, trọng số cấp phép MIT có thể tải về ngay, và các aggregator như OpenRouter, Chutes thường mở tầng miễn phí chỉ sau vài ngày. Bạn có thể bắt đầu ngay các tác vụ nghiêm túc mà không tốn chi phí trước khi quyết định trả tiền.

Dùng thử Apidog ngay hôm nay

Bài viết này trình bày chi tiết các phương pháp miễn phí đã được xác minh, phù hợp từng trường hợp sử dụng, và hướng dẫn thiết lập bộ sưu tập sẵn sàng cho sản xuất trong Apidog để việc chuyển đổi trả phí diễn ra mượt mà khi cần.

Tham khảo tổng quan sản phẩm tại DeepSeek V4 là gì và hướng dẫn API đầy đủ tại Cách sử dụng API DeepSeek V4.

Tóm tắt

chat.deepseek.com — Giao diện chat web miễn phí trên V4-Pro, hỗ trợ Think High/Think Max. Không cần thẻ, hoạt động ngay.
Trọng số Hugging Face + GPU cá nhân — MIT license, V4-Flash chạy trên 2-4 H100, V4-Pro cần cụm lớn hơn.
Tầng miễn phí OpenRouter, Chutes — Cổng bên thứ ba thường có quota miễn phí cho DeepSeek sau 1 tuần ra mắt.
Inference provider Hugging Face — Điểm cuối dùng chung, giới hạn tốc độ, phù hợp thử nghiệm.
Tín dụng thử Kaggle, Colab, RunPod — Miễn phí cho các lần chạy thử nghiệm tự lưu trữ.
Mọi phương pháp miễn phí đều có hạn mức sử dụng. Với tác vụ production, chuyển sang trả phí trước khi chạm ngưỡng.

Phương pháp 1: chat.deepseek.com (cách nhanh nhất và mặc định)

Giao diện trò chuyện chính thức là cách miễn phí, nhanh, đáng tin cậy nhất để trải nghiệm V4-Pro. Chọn chế độ Non-Think, Think High hoặc Think Max ngay trên editor.

Thiết lập

Truy cập chat.deepseek.com.
Đăng nhập bằng email, Google hoặc WeChat.
Xác nhận đang dùng model V4-Pro.
Bắt đầu trò chuyện.

Tính năng

Ngữ cảnh 1M token đầy đủ.
Hỗ trợ upload PDF, ảnh, gói mã.
Tìm kiếm web theo yêu cầu.
Đầy đủ ba chế độ lập luận.
Lưu lịch sử chat và tổ chức thư mục.

Giới hạn

Không công bố số lượng tin nhắn/ngày, nhưng có giảm tốc độ nhẹ khi tải cao.
Sử dụng nhiều có thể khiến phản hồi bị chậm hoặc hàng đợi, nhưng hiếm khi bị chặn cứng.
Khi bị giới hạn tốc độ liên tục, cân nhắc giảm tần suất hoặc chuyển sang API.

Nên dùng webchat cho: kiểm tra khả năng V4, dán repo, review hợp đồng lớn, thử Think Max.

Không nên dùng: automation, yêu cầu tái lập.

Phương pháp 2: Tự lưu trữ V4-Flash trên GPU riêng

V4-Flash là biến thể MIT, phù hợp tự lưu trữ thực tế. Tổng 284B, 13B hoạt động; chạy trên 2 H100 FP8 hoặc 1 H100 80GB INT4.

Ưu điểm: Không phụ thuộc vào quota/tốc độ, không bị revoke.

Chi phí: Chỉ tốn phần cứng.

Tải trọng số

pip install -U "huggingface_hub[cli]"
huggingface-cli login
huggingface-cli download deepseek-ai/DeepSeek-V4-Flash \
  --local-dir ./models/deepseek-v4-flash

Khoảng 500GB FP8, cần chuẩn bị ổ đĩa đủ lớn.

Phục vụ với vLLM

pip install "vllm>=0.9.0"

vllm serve deepseek-ai/DeepSeek-V4-Flash \
  --tensor-parallel-size 4 \
  --max-model-len 1048576 \
  --dtype auto \
  --port 8000

Khi chạy, trỏ client OpenAI về http://localhost:8000/v1. Định dạng API giống DeepSeek trả phí; Apidog coi như một base URL mới, không cần sửa lại request.

Kiểm tra phần cứng thực tế

Biến thể	Card tối thiểu (FP8)	Card tối thiểu (INT4)	Thông lượng thực tế
V4-Flash	2 × H100 80GB	1 × H100 80GB	50 – 150 tok/s
V4-Pro	16 × H100 80GB	8 × H100 80GB	Phụ thuộc cụm

Nếu không có GPU dư, dùng API rẻ hơn thuê GPU. Tự lưu trữ phù hợp với nhóm đã sẵn hạ tầng hoặc yêu cầu compliance.

Phương pháp 3: Tầng miễn phí OpenRouter

OpenRouter tổng hợp nhiều model (open source, closed) qua một API. Tầng miễn phí thường mở cho DeepSeek chỉ sau 1 tuần ra mắt.

Thiết lập

Đăng ký tại openrouter.ai.
Sinh API key.
Xem danh mục model: deepseek/deepseek-v4-pro hoặc deepseek/deepseek-v4-flash. Model miễn phí có hậu tố :free.
Gọi API bằng SDK OpenAI.

from openai import OpenAI

client = OpenAI(
    api_key=OPENROUTER_KEY,
    base_url="https://openrouter.ai/api/v1",
)

response = client.chat.completions.create(
    model="deepseek/deepseek-v4-flash:free",
    messages=[{"role": "user", "content": "Write a Python CLI for semver bumping."}],
)

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

Giới hạn

Thường ~vài trăm request/ngày/key, giảm ưu tiên khi tải cao.
Phù hợp tạo mẫu, không đảm bảo production.

Phương pháp 4: Nhà cung cấp suy luận Hugging Face

Hugging Face host endpoint inference cho các checkpoint V4. Miễn phí, nhưng tốc độ thấp, rate limit chặt.

from huggingface_hub import InferenceClient

client = InferenceClient(model="deepseek-ai/DeepSeek-V4-Flash")

response = client.chat_completion(
    messages=[{"role": "user", "content": "Summarize the V4 technical report in 5 bullets."}],
    max_tokens=512,
)

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

Miễn phí token HF, vượt quota thì upgrade lên HF Pro (giá vẫn rẻ hơn API chính thức).

Phương pháp 5: Tín dụng thử Colab, Kaggle, RunPod, Lambda

Các provider GPU lớn đều cho tín dụng thử miễn phí. Sử dụng hợp lý có thể đủ chạy vài lần V4-Flash.

Google Colab: Tầng T4 miễn phí quá nhỏ. Colab Pro+ có 500 compute units/tháng, chạy thử V4-Flash trên A100.
Kaggle: Giờ GPU miễn phí T4/P100, chỉ đủ cho V4-Flash lượng tử hóa.
RunPod: $10 tín dụng thử, chạy H100 vài giờ (benchmark, test).
Lambda: Thỉnh thoảng có giờ miễn phí H100/H200 (theo dõi đăng ký).

Không dài hạn. Chỉ phù hợp một vài lần thử nghiệm.

Xây dựng bộ sưu tập Apidog không phụ thuộc provider

Bạn có thể kiểm thử cùng prompt trên mọi backend miễn phí/trả phí mà không cần lặp lại request.

Quy trình:

Tải Apidog.
Tạo collection với 4 môi trường: chat (placeholder), deepseek (https://api.deepseek.com/v1), openrouter (https://openrouter.ai/api/v1), self-hosted (http://localhost:8000/v1).
Lưu một request POST đến {{BASE_URL}}/chat/completions.
Lưu API key từng provider bằng biến secret, phần body giữ nguyên.
Chuyển môi trường để A/B prompt trên mọi backend.

Mẫu tương tự bộ sưu tập tầng miễn phí GPT-5.5: một công cụ, nhiều provider, không lặp lại thao tác.

Nên chọn phương pháp miễn phí nào?

Muốn thử nhanh 5 phút: Dùng chat.deepseek.com.
Muốn tạo mẫu sản phẩm: Dùng tầng miễn phí OpenRouter tới khi hết quota, sau đó nạp tiền DeepSeek.
Có GPU, cần compliance: Tự lưu trữ V4-Flash với vLLM.
Cần xài miễn phí dài hạn: Không có. Tất cả tầng miễn phí đều giới hạn. Kết hợp chat.deepseek.com cho tác vụ tương tác + nạp tiền nhỏ cho automation.

Khi nào nên ngừng dùng miễn phí?

Ba dấu hiệu bạn nên chuyển sang trả phí:

Bị rate limit nhiều lần/ngày → Khối lượng đủ lớn để lên kế hoạch ngân sách.
Cần SLA → Miễn phí không có SLA, API chính thức thì có.
Cần logging/audit/compliance → API trả phí có hóa đơn, bản ghi rõ ràng; tầng miễn phí thường không.

Khi gặp bất kỳ dấu hiệu nào, hãy chuyển sang API chính thức. Nạp tiền tối thiểu $2, giá/token thấp nhất trong các pioneer tier.

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

chat.deepseek.com có thực sự miễn phí không?

Có. Không cần thẻ tín dụng, không có trial. Có thể giảm tốc độ, nhưng không bị paywall.

Cần tài khoản Hugging Face để tải trọng số không?

Về kỹ thuật là không (repo public), thực tế nên có tài khoản để tăng giới hạn tải xuống.

Phương pháp miễn phí nào chạy full V4-Pro?

chat.deepseek.com chạy V4-Pro đầy đủ. OpenRouter miễn phí thường chỉ V4-Flash. Muốn đầu ra V4-Pro miễn phí, chỉ nên dùng webchat.

Có thể đặt tầng miễn phí phía sau sản phẩm không?

Không nên. Tầng miễn phí bị rate limit, thay đổi điều khoản hoặc biến mất. Nếu build cho khách hàng, hãy dùng API trả phí hoặc tự host.

Tự lưu trữ có thực sự miễn phí không?

Giấy phép miễn phí, phần cứng thì không. Nếu đã có GPU trống, chỉ tốn điện. Thuê GPU thường không kinh tế bằng API trả phí.

Apidog có tầng miễn phí thử nghiệm không?

Apidog miễn phí cho thiết kế, test API; chỉ mất phí khi gọi API trả phí qua nó. Bạn có thể dùng workspace Apidog miễn phí kết hợp chat.deepseek.com hoặc OpenRouter để có workflow hoàn toàn miễn phí.

Hướng Dẫn Chạy DeepSeek V4 Tại Nhà

Sebastian Petrus — Fri, 24 Apr 2026 04:37:28 +0000

DeepSeek V4 ra mắt ngày 23/4/2026 với trọng số (weights) MIT trên Hugging Face. Giấy phép mở này giúp mọi đội nhóm có thể triển khai AI mạnh mẽ trên hạ tầng riêng. V4-Flash (284B, 13B hoạt động) chạy trên 2 × H100 FP8; V4-Pro (1.6T, 49B hoạt động) cần cụm và cạnh tranh với GPT-5.5/Claude Opus 4.6 về code/suy luận. Bài này hướng dẫn từng bước triển khai cục bộ: chuẩn bị phần cứng, lượng tử hóa, thiết lập vLLM/SGLang, cấu hình sử dụng công cụ, và kiểm thử qua Apidog trước khi đưa vào sản xuất. Xem tổng quan sản phẩm tại DeepSeek V4 là gì, API hosted tại cách sử dụng API DeepSeek V4, so sánh giá tại giá API DeepSeek V4.

Hãy thử Apidog ngay hôm nay

TL;DR (Tóm tắt)

V4-Flash chạy trên 2 × H100 80GB (FP8), hoặc 1 × H100 (INT4). Trọng số ~500GB FP8.
V4-Pro cần 16+ H100 FP8 để đạt thông lượng sản xuất; không dành cho laptop.
vLLM là lựa chọn nhanh nhất cho server tương thích OpenAI. vllm>=0.9.0 hỗ trợ V4.
SGLang phù hợp nếu cần sử dụng công cụ, đầu ra cấu trúc tốt.
Lượng tử hóa AWQ INT4 hoặc GPTQ INT4 giúp V4-Flash chạy trên 1 card 80GB, giảm ~5% chất lượng.
Dùng Apidog trỏ vào http://localhost:8000/v1 để kiểm thử, dùng lại collection với API hosted.

Ai nên tự lưu trữ

Đội nhóm ràng buộc quy định: Y tế, tài chính, pháp lý, quốc phòng – dữ liệu không được rời mạng. MIT license, không thỏa thuận sử dụng, không có luồng dữ liệu qua biên giới.
Workload lớn, ổn định: API V4-Pro giá 1.74$/triệu token vào, 3.48$/triệu token ra. Nếu >200B token/tháng, tự mua phần cứng sẽ rẻ hơn.
Tinh chỉnh & nghiên cứu: Có checkpoint Base cho pretraining, SFT, MIT license cho phép phân phối lại bản tinh chỉnh thương mại.

Không nên tự lưu trữ: Prototyper, đội thiếu kinh nghiệm vận hành GPU, workload < 200$/tháng với API hosted. Chi phí vận hành sẽ vượt lợi ích ở quy mô nhỏ.

Yêu cầu phần cứng

DeepSeek V4: FP4 + FP8 mixed precision. Cần đủ VRAM cho tổng số experts (MoE), không chỉ active params.

Biến thể	Tổng tham số	Tham số hoạt động	VRAM FP8	VRAM INT4	Card tối thiểu
V4-Flash	284B	13B	~500GB	~140GB	2 × H100 80GB (FP8) hoặc 1 × H100 (INT4)
V4-Pro	1.6T	49B	~2.4TB	~700GB	16 × H100 80GB (FP8) hoặc 8 × H100 (INT4)

VRAM cần cho toàn bộ MoE, không chỉ active.
H200, MI300X thay thế tốt. Card 141GB/192GB giảm số card cần.
GPU consumer không chạy nổi. 24GB RTX không đủ, kể cả INT4.
Apple Silicon: M3/M4 Max 128GB unified memory chỉ phù hợp dev/test, tốc độ chậm.

Bước 1: Tải xuống trọng số (weights)

deepseek-ai/DeepSeek-V4-Flash
deepseek-ai/DeepSeek-V4-Pro
Dùng deepseek-ai/DeepSeek-V4-Flash-Base / DeepSeek-V4-Pro-Base để tinh chỉnh.

pip install -U "huggingface_hub[cli]"
huggingface-cli login

huggingface-cli download deepseek-ai/DeepSeek-V4-Flash \
  --local-dir ./models/deepseek-v4-flash \
  --local-dir-use-symlinks False

Cần ~500GB ổ cho V4-Flash, vài TB cho V4-Pro. Nếu ở TQ, có thể dùng modelscope.cn để tải nhanh hơn.

Bước 2: Chọn serving engine

vLLM: Thông lượng cao, tương thích OpenAI, cộng đồng lớn. Nên dùng mặc định.
SGLang: Phù hợp workload dùng tool-calling, đầu ra JSON/primitives tốt hơn.

Cả hai đều hỗ trợ DeepSeek V4 (tuần phát hành V4).

Bước 3: Phục vụ V4-Flash với vLLM

pip install "vllm>=0.9.0"

vllm serve deepseek-ai/DeepSeek-V4-Flash \
  --tensor-parallel-size 2 \
  --max-model-len 1048576 \
  --dtype auto \
  --enable-prefix-caching \
  --port 8000

Chú thích:

--tensor-parallel-size 2: Chạy trên 2 H100. Tăng lên nếu nhiều card.
--max-model-len 1048576: Cửa sổ ngữ cảnh 1M-token. Giảm xuống nếu cần tiết kiệm VRAM.
--enable-prefix-caching: Tối ưu cache-hit, tăng throughput.
--dtype auto: Tự động FP8.

Sau khi chạy, client kiểu OpenAI trỏ http://localhost:8000/v1 là hoạt động.

Bước 4: Phục vụ V4-Pro với vLLM

vllm serve deepseek-ai/DeepSeek-V4-Pro \
  --tensor-parallel-size 8 \
  --pipeline-parallel-size 2 \
  --max-model-len 524288 \
  --enable-prefix-caching \
  --port 8000

Chạy cụm 16 × H100 (8 tensor × 2 pipeline). Có thể tăng context nếu còn VRAM. Hình thức này phù hợp cluster đa node.

Bước 5: Phục vụ với SGLang (tool-calling)

pip install "sglang[all]>=0.4.0"

python -m sglang.launch_server \
  --model-path deepseek-ai/DeepSeek-V4-Flash \
  --tp 2 \
  --context-length 1048576 \
  --port 30000

SGLang cho API OpenAI tại http://localhost:30000/v1. Có DSL lang cho tool-calling, đầu ra JSON tốt hơn vLLM.

Bước 6: Lượng tử hóa cho GPU đơn

INT4 giúp V4-Flash chạy 1 × 80GB, giảm chất lượng nhẹ. Hai lựa chọn:

AWQ (khuyến nghị)

pip install autoawq

python -c "
from awq import AutoAWQForCausalLM
from transformers import AutoTokenizer

model_path = './models/deepseek-v4-flash'
out_path = './models/deepseek-v4-flash-awq'
model = AutoAWQForCausalLM.from_pretrained(model_path)
tokenizer = AutoTokenizer.from_pretrained(model_path)
model.quantize(tokenizer, quant_config={'w_bit': 4, 'q_group_size': 128})
model.save_quantized(out_path)
tokenizer.save_pretrained(out_path)
"

GPTQ

pip install auto-gptq
# Làm theo mẫu lượng tử hóa GPTQ, tương tự AWQ.

Phục vụ checkpoint lượng tử hóa bằng --quantization awq hoặc --quantization gptq khi chạy vLLM.

Bước 7: Kiểm thử với Apidog

Không đưa vào production ngay, cần kiểm thử qua Apidog:

Tải và cài đặt Apidog.
Tạo collection trỏ http://localhost:8000/v1/chat/completions.
Dán prompt test đã dùng với API hosted. So sánh phản hồi.
Test endpoint với context 500K-token để kiểm tra KV cache.
Chạy quy trình tool-calling end-to-end trước khi kết nối agent.

Collection bạn dùng với API hosted dùng lại được cho server cục bộ, chỉ cần đổi URL base.

Khả năng quan sát & giám sát

Token/s: Cả prompt và generate. vLLM: /metrics Prometheus.
GPU utilization: nvidia-smi hoặc DCGM. Dưới 70% nghĩa là batch chưa tối ưu.
KV cache-hit rate: --enable-prefix-caching giúp đo. Tỉ lệ hit giảm thì prompt đa dạng quá mức.
Request latency p50/p95/p99: Nếu p99 tăng, p50 ổn định => queue nghẽn do request shape.

Đẩy 4 metric này lên Grafana hoặc hệ thống monitoring của bạn.

Tinh chỉnh checkpoint V4 Base

Dùng checkpoint Base cho pretraining/SFT. Ví dụ SFT với LoRA:

pip install "torch>=2.6" transformers accelerate peft trl

python -m trl sft \
  --model_name_or_path deepseek-ai/DeepSeek-V4-Flash-Base \
  --dataset_name your-org/your-sft-set \
  --output_dir ./models/v4-flash-custom \
  --per_device_train_batch_size 1 \
  --gradient_accumulation_steps 16 \
  --learning_rate 2e-5 \
  --bf16 true \
  --use_peft true \
  --lora_r 64 \
  --lora_alpha 128

Tinh chỉnh toàn bộ tham số V4-Pro là bài toán lớn. Với đội nhỏ, chỉ nên dùng LoRA trên V4-Flash-Base.

Lỗi thường gặp

OOM khi khởi động: --max-model-len cao quá, hoặc --tensor-parallel-size thấp. Giảm context/batch hoặc tăng song song.
Request đầu chậm: vLLM compile kernel lần đầu. Gửi request dummy để khởi động.
Lỗi tool-calling: DeepSeek encoding hơi khác OpenAI. Dùng SDK support V4 rõ ràng.
Lỗi FP8 trên card cũ: A100 không hỗ trợ FP8. Chạy BF16 (tốn gấp đôi VRAM).

Khi nào nên tự lưu trữ?

V4-Flash, 200B token vào/tháng + 20B ra: ~33.6K$ API hosted vs ~20K$/tháng thuê 8 × H100. Tự lưu trữ rẻ hơn ~40%.
V4-Pro, 500B in + 50B out/tháng: ~1.04M$ API hosted vs ~35K$/tháng thuê 16 × H100. Tiết kiệm >95%.

Break-even V4-Flash khoảng 100B token/tháng. Dưới mức này nên dùng API hosted.

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

Chạy V4-Flash trên A100 đơn được không? Có, nếu lượng tử hóa nặng + context ngắn. INT4 trên A100 80GB chạy 5-15 token/s. Tốt nhất vẫn là H100.

Hỗ trợ LoRA? Có. Dùng checkpoint Base + pipeline TRL/Axolotl.

Server cục bộ tương thích OpenAI không? Có. vLLM, SGLang đều có /v1/chat/completions, /v1/completions. Hướng dẫn API hosted dùng được cho local.

Bật thinking mode thế nào? Truyền thinking_mode: "thinking" hoặc "thinking_max" vào request body. vLLM/SGLang đều hỗ trợ.

Stream từ server cục bộ được không? Được. Đặt stream: true như API OpenAI/DeepSeek hosted.

Cách thử nhanh/hợp lý trước khi mua phần cứng? Thuê H100 trên RunPod/Lambda vài giờ, chạy V4-Flash INT4, đo throughput với prompt thực tế. Test 10-30$ giúp quyết định nhanh hơn lên kế hoạch 1 tuần.

Hướng Dẫn Sử Dụng API DeepSeek V4 Chi Tiết

Sebastian Petrus — Fri, 24 Apr 2026 04:17:40 +0000

DeepSeek V4 đã ra mắt với API có thể sử dụng ngay từ ngày đầu. Bạn có thể chọn các model deepseek-v4-pro và deepseek-v4-flash, sử dụng endpoint tương thích với OpenAI tại https://api.deepseek.com. Bất kỳ client nào đang dùng GPT-5.5 hoặc API dạng OpenAI đều có thể chuyển sang V4 chỉ bằng việc đổi URL cơ sở.

Dùng thử Apidog ngay hôm nay

Bài viết này hướng dẫn từng bước xác thực, các tham số quan trọng, ví dụ Python & Node, cách dùng thinking mode, gọi hàm, truyền phát (streaming), và quy trình workflow với Apidog để kiểm soát chi phí khi phát triển, thử nghiệm API.

Xem tổng quan sản phẩm tại DeepSeek V4 là gì, hoặc hướng dẫn dùng miễn phí ở cách sử dụng DeepSeek V4 miễn phí.

Tóm tắt

DeepSeek V4 có endpoint tương thích OpenAI: https://api.deepseek.com/v1/chat/completions và endpoint tương thích Anthropic: https://api.deepseek.com/anthropic
Model: deepseek-v4-pro (1.6T, 49B active) và deepseek-v4-flash (284B, 13B active)
Hỗ trợ ngữ cảnh 1M token và 3 chế độ thinking: non-thinking, thinking, thinking_max
Nên dùng temperature=1.0, top_p=1.0 theo khuyến nghị của DeepSeek; không dùng mặc định GPT-5.5/Claude
Các model cũ deepseek-chat, deepseek-reasoner sẽ dừng vào 24/07/2026; hãy chuyển đổi sớm
Tải Apidog để phát lại request, so sánh thinking mode và bảo vệ API key

Điều kiện tiên quyết

Trước khi bắt đầu, chuẩn bị:

Tài khoản developer DeepSeek tại platform.deepseek.com với số dư ≥ $2 (nếu không sẽ gặp lỗi 402 Insufficient Balance)
API key giới hạn theo project (không dùng key toàn account cho sản xuất)
SDK truy cập URL dạng OpenAI: Python openai>=1.30.0, Node openai@4.x
API client để phát lại request mà không làm đầy terminal. Dùng Apidog cho workflow thực tế.

Xuất khóa API một lần như sau:

export DEEPSEEK_API_KEY="sk-..."

Điểm cuối và xác thực

Có hai định dạng endpoint:

POST https://api.deepseek.com/v1/chat/completions    # OpenAI format
POST https://api.deepseek.com/anthropic/v1/messages  # Anthropic format

Hầu hết trường hợp nên chọn dạng OpenAI. Xác thực qua Bearer Token trong header Authorization:

curl https://api.deepseek.com/v1/chat/completions \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-pro",
    "messages": [
      {"role": "user", "content": "Giải thích định tuyến MoE trong hai câu."}
    ]
  }'

Phản hồi thành công trả về JSON có choices, usage (đếm token đầu vào/ra và reasoning_tokens nếu bật thinking), cùng id để theo dõi. Lỗi trả về theo chuẩn OpenAI với error.code và error.message.

Tham số yêu cầu

Mỗi trường đều ảnh hưởng đến chi phí/hành vi. Dưới đây là bảng tham số chính cho deepseek-v4-pro/deepseek-v4-flash:

Tham số	Loại	Giá trị	Lưu ý
`model`	string	`deepseek-v4-pro`, `deepseek-v4-flash`	Bắt buộc.
`messages`	array	cặp vai trò/nội dung	Bắt buộc. Cùng schema với OpenAI.
`thinking_mode`	string	`non-thinking`, `thinking`, `thinking_max`	Mặc định là `non-thinking`.
`temperature`	float	0 đến 2	DeepSeek khuyến nghị 1.0.
`top_p`	float	0 đến 1	DeepSeek khuyến nghị 1.0.
`max_tokens`	int	1 đến 131.072	Giới hạn độ dài đầu ra.
`stream`	bool	true hoặc false	Bật truyền phát SSE.
`tools`	array	đặc tả công cụ OpenAI	Để gọi hàm.
`tool_choice`	string hoặc object	`auto`, `required`, `none`, hoặc công cụ cụ thể	Kiểm soát việc sử dụng công cụ.
`response_format`	object	`{"type": "json_object"}`	Đầu ra chế độ JSON.
`seed`	int	bất kỳ số nguyên nào	Để tái tạo kết quả.
`presence_penalty`	float	-2 đến 2	Phạt các chủ đề lặp lại.
`frequency_penalty`	float	-2 đến 2	Phạt các token lặp lại.

thinking_mode quyết định chi phí nhiều nhất:

non-thinking: không suy luận, trả về rất nhanh như V3.2
thinking: bật block suy luận, tốn thêm token, tăng chính xác ở code/toán
thinking_max: max quality, tốn nhiều token nhất, chỉ dùng khi thực sự cần và với context ≥384K

Client Python

SDK openai dùng được bằng cách chỉ định base_url. Wrapper như LangChain, LlamaIndex, DSPy đều tương thích.

import os
from openai import OpenAI

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

response = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[
        {"role": "system", "content": "Trả lời chỉ bằng mã."},
        {"role": "user", "content": "Viết một hàm Rust để làm mượt các sự kiện."},
    ],
    extra_body={"thinking_mode": "thinking"},
    temperature=1.0,
    top_p=1.0,
    max_tokens=2048,
)

choice = response.choices[0]
print("Nội dung:", choice.message.content)
print("Token suy luận:", response.usage.reasoning_tokens)
print("Tổng số token:", response.usage.total_tokens)

Dùng extra_body để truyền tham số đặc biệt như thinking_mode qua SDK OpenAI.

Client Node

Cách gọi với NodeJS:

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.DEEPSEEK_API_KEY,
  baseURL: "https://api.deepseek.com/v1",
});

const response = await client.chat.completions.create({
  model: "deepseek-v4-flash",
  messages: [
    { role: "user", content: "Giải thích trình tối ưu hóa Muon bằng tiếng Anh đơn giản." },
  ],
  thinking_mode: "thinking",
  temperature: 1.0,
  top_p: 1.0,
});

console.log(response.choices[0].message.content);
console.log("Cách sử dụng:", response.usage);

SDK Node nhận các trường lạ như thinking_mode trực tiếp.

Phản hồi truyền phát (Streaming)

Để nhận phản hồi dạng stream, truyền stream=True và lặp qua từng chunk SSE:

stream = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[{"role": "user", "content": "Truyền phát một bài luận 300 từ về MoE."}],
    stream=True,
    extra_body={"thinking_mode": "non-thinking"},
)

for chunk in stream:
    delta = chunk.choices[0].delta.content or ""
    print(delta, end="", flush=True)

Nếu bật thinking mode, delta.reasoning_content sẽ chứa trace suy luận. Bạn có thể hiển thị trace này hoặc bỏ qua.

Gọi công cụ

DeepSeek V4 hỗ trợ schema gọi hàm chuẩn của OpenAI:

tools = [{
    "type": "function",
    "function": {
        "name": "get_weather",
        "description": "Trả về thời tiết hiện tại cho một thành phố.",
        "parameters": {
            "type": "object",
            "properties": {
                "city": {"type": "string"},
                "unit": {"type": "string", "enum": ["c", "f"]},
            },
            "required": ["city"],
        },
    },
}]

response = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[{"role": "user", "content": "Thời tiết ở Lagos theo độ C?"}],
    tools=tools,
    tool_choice="auto",
    extra_body={"thinking_mode": "thinking"},
)

tool_call = response.choices[0].message.tool_calls[0]
print(tool_call.function.name, tool_call.function.arguments)

Sau đó, bạn gọi hàm thật, trả kết quả về role: "tool" rồi tiếp tục gọi API. Cách này giống hệt với loop sử dụng function calling của OpenAI.

Chế độ JSON

Để nhận output JSON chuẩn, truyền response_format:

response = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[
        {"role": "system", "content": "Trả lời bằng một đối tượng JSON duy nhất."},
        {"role": "user", "content": "Tóm tắt ghi chú phát hành này dưới dạng {tiêu đề, ngày, gạch đầu dòng}: ..."},
    ],
    response_format={"type": "json_object"},
    extra_body={"thinking_mode": "non-thinking"},
)

Chế độ JSON buộc output hợp lệ JSON nhưng không enforce schema. Để xác thực schema, dùng Pydantic hoặc Zod ở phía client.

Xây dựng bộ sưu tập trong Apidog

Việc phát lại request trực tiếp từ terminal dễ lãng phí credit & khó so sánh. Quy trình hiệu quả:

Tải Apidog và tạo project mới
Khai báo môi trường với biến bí mật {{DEEPSEEK_API_KEY}}
Lưu request POST đến {{BASE_URL}}/chat/completions, header Authorization: Bearer {{DEEPSEEK_API_KEY}}
Tham số hóa model và thinking_mode để test A/B giữa các biến thể
Dùng viewer để kiểm tra usage.reasoning_tokens và xác định chi phí thực tế từng lần chạy

Nếu bạn đã có bộ sưu tập API GPT-5.5 trong Apidog, chỉ cần đổi base URL thành https://api.deepseek.com/v1 và model ID để so sánh giữa hai provider.

Xử lý lỗi

DeepSeek trả lỗi theo chuẩn OpenAI. Một số mã lỗi thường gặp:

Mã	Ý nghĩa	Khắc phục
400	Yêu cầu không hợp lệ	Kiểm tra schema JSON, đặc biệt `messages` và `tools`.
401	Khóa không hợp lệ	Tạo lại tại platform.deepseek.com.
402	Số dư không đủ	Nạp tiền vào tài khoản.
403	Mô hình không được phép	Kiểm tra phạm vi key và chính tả model ID.
422	Tham số ngoài phạm vi	`max_tokens` hoặc `thinking_mode` có thể sai.
429	Giới hạn tốc độ	Tạm dừng, thử lại với exponential backoff.
500	Lỗi máy chủ	Thử lại 1 lần. Nếu lặp lại, kiểm tra trang trạng thái.
503	Quá tải	Dùng V4-Flash hoặc thử lại sau 30s.

Nên wrap mọi API call trong hàm retry, xử lý lỗi 429, 5xx với backoff lũy thừa. Không tự động retry lỗi 4xx.

Các mẫu kiểm soát chi phí

Áp dụng 4 mẫu sau để tối ưu chi phí:

Mặc định dùng V4-Flash. Chỉ dùng V4-Pro khi đã đo được improvement.
Giới hạn thinking_max bằng flag. Chỉ bật khi cần chất lượng cao, vì đây là mode đắt nhất.
Giới hạn max_tokens. Hầu hết câu trả lời nằm trong 2000 token output. 1M context dành cho input.
Ghi log usage mỗi lần gọi. Theo dõi input, output, reasoning token để phát hiện bất thường.

Di chuyển từ các mô hình DeepSeek cũ hơn

Các model ID cũ deepseek-chat, deepseek-reasoner sẽ dừng vào 24/07/2026. Di chuyển chỉ cần đổi giá trị model:

-  model="deepseek-chat"
+  model="deepseek-v4-pro"

Nên so sánh A/B trong Apidog trước khi triển khai production để đảm bảo chất lượng cải thiện, đồng thời chuẩn bị cho việc ngừng hỗ trợ model cũ.

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

API DeepSeek V4 đã sẵn sàng cho production chưa?

Có. API vận hành từ 23/04/2026, nền tảng ổn định.

V4 có hỗ trợ format Anthropic không?

Có. Chỉ cần trỏ sang https://api.deepseek.com/anthropic/v1/messages, gửi payload dạng Anthropic.

Context window bao nhiêu?

1 triệu token trên cả V4-Pro và V4-Flash. thinking_max nên dùng context tối thiểu 384K.

Đếm token đầu vào thế nào?

Dùng tokenizer OpenAI để ước lượng trước khi gửi. Số chính xác trả về trong trường usage của response.

Có hỗ trợ fine-tuning qua API không?

Chưa. Hiện chỉ fine-tune qua checkpoint base trên Hugging Face.

API có miễn phí dùng thử không?

Không có free tier, nhưng tài khoản mới đôi khi nhận được credit dùng thử.

Hướng Dẫn Sử Dụng DeepSeek V4: Web Chat, API và Tự Lưu Trữ

Sebastian Petrus — Fri, 24 Apr 2026 04:16:46 +0000

DeepSeek V4 được phát hành ngày 23/4/2026 với 4 checkpoint, API trực tiếp và trọng số MIT trên Hugging Face. Bạn có thể dùng ngay qua web, gọi API sản xuất hoặc tự triển khai tại chỗ. Bài này hướng dẫn chi tiết từng cách, các bước thực hiện, ưu nhược điểm và quy trình sẵn sàng cho sản xuất.

Dùng thử Apidog ngay hôm nay

Nếu bạn cần tổng quan sản phẩm, xem DeepSeek V4 là gì. Cần hướng dẫn API, xem hướng dẫn API DeepSeek V4. Muốn dùng miễn phí, đọc cách sử dụng DeepSeek V4 miễn phí. Khi sẵn sàng test thực tế, tải Apidog để chuẩn bị bộ sưu tập.

TL;DR (Tóm tắt)

Truy cập nhanh nhất: chat.deepseek.com. Chat web miễn phí, mặc định V4-Pro, ba chế độ suy luận.
API sản xuất: https://api.deepseek.com/v1/chat/completions, model deepseek-v4-pro hoặc deepseek-v4-flash.
Tự host: tải trọng số từ Hugging Face, chạy script /inference trong repo.
Chọn **Non-Think** cho định tuyến/phân loại, **Think High** cho code/phân tích, **Think Max** khi cần độ chính xác tối đa.
Sampling khuyến nghị: temperature=1.0, top_p=1.0.
Dùng Apidog làm client API; format OpenAI nên có thể dùng lại request với DeepSeek, OpenAI, Anthropic.

Chọn đường dẫn phù hợp cho khối lượng công việc của bạn

Bốn đường dẫn thực tế, mỗi loại phù hợp từng use case:

Đường dẫn	Chi phí	Thời gian thiết lập	Tốt nhất cho
chat.deepseek.com	Miễn phí	30 giây	Kiểm tra nhanh, công việc tạm thời
API DeepSeek	Thanh toán theo token	5 phút	Sản xuất, tác nhân, công việc hàng loạt
V4-Flash tự host	Chỉ chi phí phần cứng	Vài giờ	Tuân thủ tại chỗ, suy luận offline
V4-Pro tự host	Chỉ chi phí cụm	Một ngày	Nghiên cứu, tinh chỉnh tùy chỉnh
OpenRouter / aggregator	Thanh toán theo token	2 phút	Dự phòng đa nhà cung cấp

Đường dẫn 1: Sử dụng V4 qua giao diện chat web

Truy cập chat.deepseek.com.
Đăng nhập bằng email, Google hoặc WeChat.
Chọn model ở đầu editor: V4-Pro mặc định, chuyển Non-Think / Think High / Think Max tùy tác vụ.
Bắt đầu chat, upload file nếu cần.

Chat web hỗ trợ upload file, tìm kiếm web, ngữ cảnh 1 triệu token. Tốt cho: debug, tóm tắt file PDF lớn, so sánh với GPT-5.5/Claude. Không phù hợp cho tự động hóa hoặc phát lại lặp đi lặp lại.

Đường dẫn 2: Sử dụng API DeepSeek

API DeepSeek tương thích OpenAI, giữ ID model deepseek-v4-pro và deepseek-v4-flash sau 24/7/2026.

Lấy khóa API

Đăng ký tại platform.deepseek.com.
Thêm phương thức thanh toán (tối thiểu $2).
Tạo API Key tại mục API Keys, copy ngay vì chỉ hiển thị một lần.

Xuất khóa cho client:

export DEEPSEEK_API_KEY="sk-..."

Yêu cầu tối thiểu khả thi

curl https://api.deepseek.com/v1/chat/completions \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-pro",
    "messages": [
      {"role": "user", "content": "Refactor this Python function to async. Reply with code only."}
    ],
    "thinking_mode": "thinking"
  }'

Thay deepseek-v4-pro bằng deepseek-v4-flash nếu muốn tiết kiệm chi phí. Đổi thinking thành non-thinking nếu cần tốc độ.

Client Python

import os
from openai import OpenAI

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

response = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[
        {"role": "system", "content": "You are a concise senior engineer."},
        {"role": "user", "content": "Explain the CSA+HCA hybrid attention stack."},
    ],
    extra_body={"thinking_mode": "thinking_max"},
    temperature=1.0,
    top_p=1.0,
)

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

Client Node

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.DEEPSEEK_API_KEY,
  baseURL: "https://api.deepseek.com/v1",
});

const response = await client.chat.completions.create({
  model: "deepseek-v4-flash",
  messages: [{ role: "user", content: "Write a fizzbuzz in Rust." }],
  temperature: 1.0,
  top_p: 1.0,
});

console.log(response.choices[0].message.content);

Xem chi tiết tham số, xử lý lỗi trong hướng dẫn API DeepSeek V4.

Đường dẫn 3: Lặp lại với Apidog

Curl tốt cho một lần test, nhưng chạy lại nhiều lần sẽ lãng phí và khó kiểm soát. Apidog giúp bạn lưu, phát lại, so sánh kết quả dễ dàng.

Tải Apidog cho Mac/Win/Linux từ apidog.com.
Tạo project API mới, thêm request POST tới https://api.deepseek.com/v1/chat/completions.
Thêm header Authorization: Bearer {{DEEPSEEK_API_KEY}}, lưu biến môi trường.
Dán body JSON, lưu lại. Từ đây chỉ cần nhấp để chạy lại, đổi prompt, đổi mode nhanh chóng.
Dùng viewer tích hợp để so sánh trace giữa Non-Think vs Think Max trên cùng prompt.

Cùng bộ sưu tập có thể chứa request GPT-5.5, Claude, DeepSeek V4 – tiện cho A/B testing, theo dõi chi phí, logs token. Nếu đã dùng Apidog cho API AI khác, chỉ cần đổi base URL là xong.

Đường dẫn 4: Tự host V4-Flash

Yêu cầu compliance, airgap hoặc chi phí khiến bạn phải tự host? MIT license cho phép bạn làm chủ giải pháp này.

Phần cứng

V4-Flash (13B, tổng 284B): 2-4 card H100/H200/MI300X FP8. INT4 có thể chạy trên 1 card 80GB.
V4-Pro (49B, tổng 1.6T): Cần cụm 16-32 H100 cho inference sản xuất.

Lấy trọng số

pip install -U "huggingface_hub[cli]"
huggingface-cli login
huggingface-cli download deepseek-ai/DeepSeek-V4-Flash \
  --local-dir ./models/deepseek-v4-flash \
  --local-dir-use-symlinks False

Tải V4-Flash nặng khoảng 500GB (FP8), V4-Pro vài TB.

Chạy suy luận

pip install "vllm>=0.9.0"

vllm serve deepseek-ai/DeepSeek-V4-Flash \
  --tensor-parallel-size 4 \
  --max-model-len 1048576 \
  --dtype auto

Khi vLLM đã chạy, trỏ client OpenAI đến http://localhost:8000/v1. Có thể dùng lại collection Apidog, chỉ thay base URL.

Thúc đẩy V4 hiệu quả

Luôn chỉ định thinking_mode (non-thinking/thinking/thinking_max) rõ ràng.
Lời nhắc hệ thống dùng để định hình tính cách, không nhồi task logic vào system prompt – đặt logic vào user message.
Bài mã nên kèm test case rõ ràng. Paste đầu ra kiểm thử fail, model sẽ sửa code cho pass dễ hơn.

Với context dài, đặt tài liệu quan trọng ở đầu/cuối input. V4 vẫn có bias về tính gần đây và ưu tiên context đầu/cuối.

Kiểm soát chi phí

Mặc định dùng V4-Flash. Chỉ chuyển V4-Pro khi thật sự cần.
Mặc định Non-Think. Chỉ tăng lên Think High/Max khi cần độ chính xác cao.
Giới hạn max_tokens. Output thực tế thường 2.000 tokens, không cần context 1M trong mọi case.

Trong Apidog, dùng biến môi trường cho DEEPSEEK_API_KEY để tách tài khoản test và production. Apidog tự động log số token mỗi response – giúp phát hiện prompt quá dài.

Di chuyển từ DeepSeek V3 hoặc model khác

Từ deepseek-chat/deepseek-reasoner: Đổi model thành deepseek-v4-pro hoặc deepseek-v4-flash trước 24/7/2026.
Từ OpenAI GPT-5.x: Đổi base URL thành https://api.deepseek.com/v1, giữ format request. Xem hướng dẫn API GPT-5.5 để song song.
Từ Anthropic Claude: Đổi endpoint https://api.deepseek.com/anthropic hoặc chuyển sang format OpenAI.

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

Cần tài khoản trả phí không? Chat web miễn phí. API cần nạp tối thiểu $2. Xem cách dùng miễn phí nếu muốn.
Nên mặc định dùng model nào? Bắt đầu với V4-Flash Non-Think, đo chất lượng và chỉ đổi khi cần.
Có thể chạy V4 trên MacBook không? V4-Flash chạy trên M3 Max/M4 Max 128GB RAM (INT4) nhưng chậm. V4-Pro không chạy được. Nên dùng API hoặc chat web cho laptop.
V4 hỗ trợ tool/function call không? Có. Endpoint OpenAI chấp nhận array tools và trả về tool_calls chuẩn. Endpoint Anthropic dùng schema tool gốc.
Làm sao truyền tải phản hồi? Đặt stream: true trong body. SSE stream chuẩn OpenAI. Dùng lại lib OpenAI là đủ.
Có rate limit không? API host công bố tại api-docs.deepseek.com. Tự host chỉ giới hạn bởi phần cứng.

DeepSeek V4 Là Gì?

Sebastian Petrus — Fri, 24 Apr 2026 04:14:15 +0000

DeepSeek đã phát hành V4 vào ngày 23 tháng 4 năm 2026, và đây là một bản nâng cấp lớn. Phòng thí nghiệm Hàng Châu công bố đồng thời bốn checkpoint, dẫn đầu là DeepSeek-V4-Pro với 1,6 nghìn tỷ tham số, giấy phép MIT, và cửa sổ ngữ cảnh 1 triệu token. Phiên bản nhỏ hơn, DeepSeek-V4-Flash, có 284 tỷ tham số và ngữ cảnh tương tự. Các điểm chuẩn cho thấy Pro vượt Claude Opus 4.6 trên LiveCodeBench/Codeforces, xấp xỉ GPT-5.4 xHigh trên MMLU-Pro.

Dùng thử Apidog ngay hôm nay

Nếu bạn đang cân nhắc chuyển từ Claude, GPT-5.5 hoặc Qwen sang DeepSeek V4, bài viết này sẽ cung cấp tổng quan về mô hình, so sánh với V3.2, chi tiết kiến trúc, các điểm benchmark quan trọng và hướng dẫn thực tiễn triển khai.

Xem thêm hướng dẫn API DeepSeek V4, hướng dẫn truy cập miễn phí và hướng dẫn sử dụng DeepSeek V4. Định dạng request tương thích OpenAI, bạn có thể tạo collection trước trong Apidog mà không cần API key.

Tóm tắt

DeepSeek V4 là họ mô hình Mixture-of-Experts phát hành 23/4/2026, giấy phép MIT.
Ra mắt 4 checkpoint: V4-Pro, V4-Pro-Base, V4-Flash, V4-Flash-Base.
V4-Pro: 1,6T tham số, 49B hoạt động. V4-Flash: 284B, 13B hoạt động.
Cửa sổ ngữ cảnh 1M token, 3 chế độ suy luận: Non-Think, Think High, Think Max.
Benchmark nổi bật: LiveCodeBench 93.5, Codeforces 3206, MMLU-Pro 87.5 (Pro).
API tại api.deepseek.com, model ID: deepseek-v4-pro và deepseek-v4-flash; trọng số trên Hugging Face, ModelScope.

DeepSeek V4 là gì?

DeepSeek V4 kế nhiệm V3/V3.2 với kiến trúc Mixture-of-Experts (MoE) nâng cấp. V4-Pro chỉ kích hoạt 49B/1,6T tham số mỗi token, nên chi phí tính toán tương đương mô hình dense 50B. Tham khảo DeepSeek V4 trên Hugging Face.

Bốn checkpoint:

DeepSeek-V4-Pro: 1.6T, 49B hoạt động, ngữ cảnh 1M. Gọi qua API.
DeepSeek-V4-Pro-Base: Pretrain, chưa finetune. Dành cho nghiên cứu/tinh chỉnh.
DeepSeek-V4-Flash: 284B, 13B hoạt động, ngữ cảnh 1M. Tối ưu độ trễ, chạy được trên 2-3 H100.
DeepSeek-V4-Flash-Base: Pretrain cho Flash.

Tất cả đều MIT license. Khác biệt lớn: V4-Pro trọng số mở, bạn có thể tải về, tùy biến, triển khai không phí bản quyền.

Những thay đổi so với V3.2

V4 cải tiến vượt trội về kiến trúc attention và pipeline huấn luyện.

Khả năng	V3.2	V4-Pro
Tổng tham số	685B	1.6T
Tham số hoạt động	37B	49B
Cửa sổ ngữ cảnh	128K	1M
FLOPs suy luận (1M)	Cơ sở	27% của V3.2
KV-cache (1M)	Cơ sở	10% của V3.2
Độ chính xác	FP8	FP4 + FP8 hỗn hợp
Giấy phép	DeepSeek	MIT
Chế độ suy luận	Đơn lẻ	Ba

Ba cải tiến chính:

Attention lai: Kết hợp Compressed Sparse Attention & Heavily Compressed Attention giúp giảm KV-cache chỉ còn 10%.
Manifold-Constrained Hyper-Connections: Ổn định gradient khi tăng chiều sâu mô hình.
Tối ưu hóa Muon: Tăng tốc hội tụ so với AdamW.

Tập dữ liệu huấn luyện vượt 32 nghìn tỷ token, huấn luyện sau chia 2 giai đoạn: pretrain chuyên gia, rồi policy distillation.

Điểm chuẩn quan trọng

V4-Pro dẫn đầu về code và kiến thức, còn hạn chế ở truy xuất ngữ cảnh dài.

V4-Flash: MMLU-Pro 86.2, GPQA Diamond 88.1, LiveCodeBench 91.6, Codeforces 3052, SWE Verified 79.0.
V4-Pro mạnh nhất cho lập trình tự động, suy luận phức tạp.
Claude vẫn nhỉnh hơn ở truy xuất 1M token.

Ba chế độ suy luận

Chọn mode phù hợp giúp tối ưu chi phí và chất lượng:

Non-Think: Phản hồi nhanh, không sinh chuỗi suy nghĩ. Dùng cho phân loại, định tuyến, tóm tắt ngắn.
Think High: Mặc định cho task khó, sinh token suy luận trước khi trả lời, lập kế hoạch tool-call, kiểm tra output.
Think Max: Dấu vết suy luận dài, tự phê bình mạnh, khuyến nghị ngữ cảnh ≥ 384K token. Đạt điểm LiveCodeBench cao nhất nhưng tốn token.

Chuyển đổi qua tham số API thinking_mode. Đề xuất sampling: temperature=1.0, top_p=1.0.

Kiến trúc đơn giản hoá

Ba yếu tố then chốt:

Attention lai: Hầu hết layer dùng Compressed Sparse Attention, một số ít layer dùng Heavily Compressed Attention để tối ưu chi phí ở 1M token.
Manifold-Constrained Hyper-Connections: Kiểm soát residual để tránh hỗn loạn gradient khi stack nhiều layer.
Muon optimizer: Thay AdamW, hội tụ nhanh hơn cho MoE.

Khả năng triển khai thực tế

Ảnh chụp nhanh (24/4/2026):

Nền tảng	Truy cập
chat.deepseek.com	Chat web miễn phí, V4-Pro mặc định, cần đăng nhập
API DeepSeek	`api.deepseek.com` với model ID `deepseek-v4-pro` và `deepseek-v4-flash`
Trọng số Hugging Face	V4-Pro, V4-Flash
ModelScope	Bản sao trọng số cho người dùng tại Trung Quốc
OpenRouter & aggregator	Sắp có
`deepseek-chat`/`reasoner`	Ngừng hỗ trợ từ 24/7/2026

Lưu ý: Nếu còn dùng deepseek-chat, cần chuyển sang deepseek-v4-pro hoặc deepseek-v4-flash trong vòng 3 tháng.

So sánh với GPT-5.5 & Claude

Chi phí: V4-Pro/V4-Flash trọng số mở, tự host tiết kiệm hơn GPT-5.5/Claude (đều đóng).
Lập trình: V4-Pro 93.5 LiveCodeBench, 3206 Codeforces, vượt GPT-5.5/Claude.
Kiến thức: Gemini 3.1 Pro dẫn đầu MMLU-Pro. V4-Pro ngang GPT-5.5, hơn Claude trên SimpleQA-Verified.
Truy xuất dài: Claude Opus vẫn mạnh nhất.
Giấy phép: MIT cho phép tích hợp sản phẩm thương mại dễ dàng.

Ứng dụng thực tiễn

Nên dùng V4 cho:

Agentic coding loops: Gỡ lỗi đa tệp, refactor, sửa lỗi tự động. Kết hợp với Apidog để kiểm thử API request/response khi tinh chỉnh prompt.
Suy luận tài liệu dài: 1M token phù hợp monorepo, hợp đồng lớn, dataset nghiên cứu. Chọn Think High.
Sản phẩm AI tự lưu trữ: V4-Flash là mô hình mở đầu tiên cạnh tranh chất lượng với API đóng.
Nghiên cứu & tinh chỉnh: Dùng các checkpoint Base + dữ liệu riêng để tạo model chuyên biệt.

Không phù hợp: Phân loại số lượng lớn, truy xuất embedding, chat prompt ngắn (V4-Flash vẫn quá mạnh, dùng V3.2 hiệu quả hơn).

Giá cả

Chưa có giá API chính thức. V3.2: ~$0.28/triệu token input, ~$0.42/triệu token output. Dự kiến V4-Flash ngang giá, V4-Pro cao hơn nhẹ. Đối thủ đóng: $5–15/triệu token input. Theo dõi cập nhật tại trang giá DeepSeek.

Cách thử nghiệm V4 ngay

Ba cách, ưu tiên tốc độ nhận token đầu tiên:

Chat web: Truy cập chat.deepseek.com, đăng nhập, mặc định V4-Pro, chuyển Think High trong UI. Miễn phí, không cần thẻ.
API: Lấy API key, trỏ client tới https://api.deepseek.com, set "model": "deepseek-v4-pro". Request format tương thích OpenAI. Xem hướng dẫn API DeepSeek V4.
Trọng số local: Tải từ Hugging Face hoặc ModelScope. V4-Flash chạy 2–4 H100; V4-Pro cần cluster lớn. Code inference trong /inference của repo model.

Để có hướng dẫn chi tiết về prompt engineering với Apidog, xem cách sử dụng DeepSeek V4. Muốn dùng miễn phí, xem hướng dẫn DeepSeek V4 miễn phí. Tải Apidog và tạo trước collection; định dạng OpenAI giúp một request chạy được trên DeepSeek, OpenAI, v.v.

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

DeepSeek V4 có thực sự mã nguồn mở không?

Có. Bốn checkpoint MIT, dùng thương mại/tùy biến/phân phối lại không cần xin phép.

Chạy V4-Flash cần cụm GPU mạnh không?

Cần 2–4 H100/H200 cho V4-Flash full precision, ít hơn nếu lượng tử hóa. V4-Pro cần cluster lớn. Nếu không có GPU, hãy dùng API hoặc chat.deepseek.com.

API DeepSeek đã hỗ trợ V4 chưa?

Đã hoạt động từ 23/4/2026. Model ID: deepseek-v4-pro, deepseek-v4-flash. deepseek-chat và deepseek-reasoner ngừng từ 24/7/2026.

V4 so với Kimi, Qwen thế nào?

V4-Pro điểm LiveCodeBench/Codeforces cao hơn Kimi K2, Qwen 3 Max. Cả ba đều MoE, trọng số mở, triển khai tương tự. Chọn theo benchmark phù hợp workload.

Có thể tinh chỉnh V4 không?

Có. Dùng checkpoint Base + dữ liệu bạn, pipeline SFT tiêu chuẩn. MIT license cho phép phân phối thương mại.

V4 dùng được với công cụ OpenAI cũ không?

Có. API nhận định dạng OpenAI, Anthropic tại https://api.deepseek.com và https://api.deepseek.com/anthropic. Hầu hết client OpenAI chỉ cần đổi base URL. Xem hướng dẫn API GPT-5.5 để biết mẫu code.

Bảng Giá GPT-5.5: Chi Tiết API, Codex và Chi Phí ChatGPT (Tháng 4/2026)

Sebastian Petrus — Fri, 24 Apr 2026 02:30:25 +0000

OpenAI đã tăng gấp đôi giá mỗi token trên dòng GPT-5 với việc phát hành GPT-5.5 vào ngày 23/4/2026. Giá đầu vào tăng từ 2,50 USD lên 5,00 USD cho mỗi triệu token, đầu ra tăng từ 15,00 USD lên 30,00 USD mỗi triệu. Giá Pro vẫn giữ nguyên ở mức 30/180 USD. Đó là tiêu đề chính; các chi tiết là nơi ẩn chứa chi phí thực tế.

Dùng thử Apidog ngay hôm nay

Bài viết này hướng dẫn chi tiết cách tính chi phí và các phương án triển khai thực tế: từ giá API chuẩn, Batch, Flex, Priority, đến giá Pro, giới hạn Codex và cách dự toán chi phí cho khối lượng công việc thực tế trước khi chuyển đổi mô hình.

Tham khảo tổng quan mô hình tại GPT-5.5 là gì. Hướng dẫn dành cho developer: Cách sử dụng API GPT-5.5.

Tóm tắt

Dịch vụ	Đầu vào / Triệu	Đầu ra / Triệu
API tiêu chuẩn GPT-5.5	$5.00	$30.00
API GPT-5.5 Pro	$30.00	$180.00
GPT-5.5 Batch (giảm 50%)	$2.50	$15.00
GPT-5.5 Flex (giảm 50%)	$2.50	$15.00
GPT-5.5 Priority (gấp 2,5 lần)	$12.50	$75.00
API tiêu chuẩn GPT-5.4	$2.50	$15.00
API GPT-5.4-mini	$0.25	$2.00

GPT-5.5 có giá gấp đôi GPT-5.4 ở cấp token, nhưng OpenAI tuyên bố hiệu quả tăng ~20% khi tính đến hiệu quả sử dụng token.

Các con số chính

GPT-5.5: $5.00/m triệu token đầu vào, $30.00/m triệu token đầu ra.
GPT-5.5 Pro: $30.00/m triệu đầu vào, $180.00/m triệu đầu ra.
Cửa sổ ngữ cảnh: 1 triệu token trên cả hai biến thể. Token suy luận tính vào hóa đơn đầu ra.

Batch, Flex và Priority

OpenAI cung cấp 3 cấp độ giá ngoài chuẩn giúp bạn chủ động kiểm soát chi phí và tốc độ.

API Batch

Gửi request qua endpoint Batch, bạn được giảm 50% giá tiêu chuẩn, hoàn thành dưới 24h. Batch rất phù hợp cho:

Chạy batch đánh giá trên toàn bộ dataset
Bổ sung hoặc xử lý lại dữ liệu lịch sử
Quy trình off-line, độ trễ hàng giờ không ảnh hưởng

Với giá này, GPT-5.5 ngang giá GPT-5.4. Hãy cân nhắc batch cho mọi tác vụ không cần realtime.

Xử lý Flex

Flex cũng giảm 50% chi phí, thời gian phản hồi thay đổi từ vài giây đến vài phút tùy tải. Dùng Flex khi chấp nhận được biến động latency và muốn giá rẻ gần như Batch cho trải nghiệm gần realtime.

Xử lý ưu tiên

Priority giá gấp 2,5 lần chuẩn (12,50 USD / 75,00 USD mỗi triệu token trên GPT-5.5), mang lại thông lượng và rate limit cao, độ trễ gần bằng 0. Dùng cho các tính năng user-facing realtime đòi hỏi tốc độ phản hồi cao.

Tính toán chi phí chế độ suy nghĩ (Thinking mode)

Chế độ suy nghĩ (GPT-5.5 Thinking, dùng reasoning.effort cao hơn) không tăng giá mỗi token, nhưng tăng số token sử dụng trên mỗi request. Hệ số nhân tùy nỗ lực:

Nỗ lực	Hệ số token đầu ra	Khi nào nên dùng
`thấp` (mặc định)	1×	Đa số use case thông thường
`trung bình`	1.3–2×	Mã hóa multi-step, content có cấu trúc
`cao`	2–4×	Nghiên cứu chuyên sâu, yêu cầu độ chính xác
`rất cao`	3–8×	Agent loop, chuỗi tool, lập kế hoạch chi tiết

Ví dụ: 1 call xhigh với prompt dài có thể dùng 20k token suy luận. Với giá $30/m triệu token, chỉ riêng phần này đã tốn $0.60, chưa kể token đầu ra.

Lập ngân sách theo workload, không theo từng request lẻ.

Giá Codex

Codex gắn với các gói ChatGPT, không tính phí từng token. Ngày 23/4/2026, cấu trúc như sau:

Gói	Truy cập Codex	GPT-5.5	Ghi chú
Miễn phí	Có (giới hạn thời gian)	Có	Giới hạn weekly
Go	Có (giới hạn thời gian)	Có	Gấp đôi Free
Plus ($20/tháng)	Có	Có	Giới hạn tiêu chuẩn
Pro ($200/tháng)	Có	Có + Thinking + Pro (trong ChatGPT)	Giới hạn cao nhất/user
Business	Có	Có	Tính theo seat
Doanh nghiệp/Giáo dục	Có	Có	Hợp đồng riêng

Nếu bạn làm việc nhiều trên terminal với Codex, Plus/Pro là cách rẻ nhất để chạy GPT-5.5 - đặc biệt khi vượt vài trăm nghìn token/ngày. Xem hướng dẫn về con đường miễn phí để tận dụng tối đa.

So sánh: GPT-5.5 và các phiên bản còn lại

Khi nào nên trả tiền cho GPT-5.5, khi nào nên giữ GPT-5.4 hoặc GPT-5.4-mini? Tính toán chi phí dựa vào mức độ phức tạp và khối lượng đầu ra.

Mô hình	Đầu vào / Triệu	Đầu ra / Triệu	Chi phí cho 1k token đầu ra
GPT-5.4-mini	$0.25	$2.00	$0.0020
GPT-5.4	$2.50	$15.00	$0.0150
GPT-5.5	$5.00	$30.00	$0.0300
GPT-5.5 Pro	$30.00	$180.00	$0.1800

Đầu ra lớn, rủi ro thấp (phân loại, tóm tắt, chat đơn giản): GPT-5.4-mini.
Khối lượng sản xuất, 5.4 đáp ứng chất lượng: GPT-5.4.
Mã hóa phức tạp, agent multi-step, nghiên cứu sâu: GPT-5.5.
Yêu cầu cực cao về độ chính xác: GPT-5.5 Pro.

Ví dụ thực tế: chi phí agent mã hóa mỗi tác vụ

Một phiên agent thông qua API GPT-5.5 với reasoning.effort: "medium":

Token đầu vào/tác vụ (context + prompt): ~15,000
Token đầu ra/tác vụ (code + giải thích): ~3,000
Token suy luận/tác vụ (medium): ~6,000

Chi phí/tác vụ với giá chuẩn:

Đầu vào: 15k × $5.00/m = $0.075
Đầu ra: (3k+6k) × $30.00/m = $0.27
Tổng: $0.345/tác vụ mã hóa hoàn thành

Chạy cùng workload trên GPT-5.4:

Đầu vào: 15k × $2.50/m = $0.0375
Đầu ra: 9k × $15.00/m = $0.135
Tổng: $0.1725/tác vụ

GPT-5.5 đắt gấp 2 lần/tác vụ với cùng mức effort. Việc nâng cấp chỉ hợp lý khi hiệu năng (SWE-bench 88,7% vs ~74%) giúp hoàn thành nhiều tác vụ hơn mà không phải làm lại thủ công.

Các biện pháp kiểm soát chi phí nên áp dụng từ đầu

5 đòn bẩy giúp kiểm soát bill GPT-5.5:

Giới hạn cứng max_output_tokens cho mọi call. Mặc định 2.000, tăng nếu thật sự cần đầu ra dài.
JSON schema nghiêm ngặt. Output lỗi phải retry, retry là 1 call tính phí đầy đủ.
Routing theo độ khó. Request dễ giao cho GPT-5.4-mini, khó mới giao GPT-5.5. 10 dòng code routing tiết kiệm hơn tối ưu prompt.
Batch cho mọi tác vụ offline. Đánh giá, dữ liệu, report ban đêm đều giảm 50% giá.
Theo dõi usage.reasoning_tokens. Bill bất ngờ thường do token suy luận ở effort cao. Nên đặt cảnh báo usage bất thường.

Ước tính chi phí hàng tháng theo gói

Gói	Giá hàng tháng	Phù hợp nhất
Miễn phí	$0	Dùng thử GPT-5.5 với Codex trước khi commit
Go	$4/tháng	Học sinh, sinh viên, người dùng ít
Plus	$20/tháng	Dev cá nhân dùng Codex + ChatGPT hàng ngày
Pro	$200/tháng	Power user cần Thinking & Pro trên ChatGPT
Business	$25/seat/tháng	Nhóm cần workspace chung
Doanh nghiệp/Giáo dục	Tùy chỉnh	Hợp đồng riêng, có SLA

Nếu chạy >4 triệu token đầu ra/tháng qua API, gói Pro + Codex CLI sẽ rẻ hơn trả phí từng token, miễn là workload nằm trong context window 400k token của CLI.

Tín hiệu thay đổi giá cần theo dõi

GA (General Availability) API GPT-5.5: Giá có thể giảm khi cạnh tranh với Anthropic, Gemini, các mô hình open source trên bảng xếp hạng Vellum.
Dân chủ hóa Pro: OpenAI thường hạ giá gói Pro sau 3–6 tháng. Không nên mặc định giá 30/180 USD là cố định mãi mãi.

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

Lưu cache có giảm chi phí đầu vào không? Có. Token đầu vào cache trên GPT-5.5 tính phí thấp hơn nhiều so với chuẩn; trang giá OpenAI có hệ số cụ thể. Cache mọi thứ tái sử dụng được (prompt system, schema tool, context repo).

Có chiết khấu số lượng lớn không? Chưa công bố. Doanh nghiệp lớn ký hợp đồng riêng, OpenAI điều chỉnh giá nếu usage lớn. Liên hệ sales nếu annual spending >1 triệu USD.

Chế độ suy nghĩ có tốn thêm chi phí ngoài giá token? Không. Tốn vì dùng nhiều token hơn, không phải do giá token khác.

Sử dụng Codex CLI có tính phí riêng với API không? Chỉ khi đăng nhập bằng API key. Đăng nhập ChatGPT tính vào gói, còn API key tính usage riêng.

Cách rẻ nhất để dùng thử GPT-5.5? Gói Free/Go + Codex CLI. Xem hướng dẫn con đường miễn phí để biết các lựa chọn không tốn phí.

Cách sử dụng GPT-5.5 miễn phí với Codex

Sebastian Petrus — Fri, 24 Apr 2026 02:28:56 +0000

OpenAI đã phát hành GPT-5.5 vào ngày 23 tháng 4 năm 2026 và, trong đợt ra mắt này, Codex đã được triển khai cho mọi gói ChatGPT, bao gồm cả gói Miễn phí và Go trong thời gian giới hạn. Đây là cách nhanh và miễn phí nhất để trải nghiệm mô hình mới: cài đặt Codex CLI, đăng nhập bằng tài khoản ChatGPT và dùng GPT-5.5 ngay trên terminal mà không cần khóa API hay thẻ tín dụng.

Dùng thử Apidog ngay hôm nay

Hướng dẫn dưới đây tập trung vào các bước cài đặt, xác thực, chuyển đổi mô hình, quản lý hạn mức, và tích hợp Codex vào quy trình dev thực tế. Để nắm tổng quan về mô hình, xem GPT-5.5 là gì. Các phương án miễn phí khác (tín dụng thử, công cụ tổng hợp) được liệt kê trong hướng dẫn sử dụng GPT-5.5 miễn phí.

Tóm tắt

Codex CLI chạy GPT-5.5 trực tiếp trên repository cục bộ, với cửa sổ ngữ cảnh 400K.
Tất cả các gói ChatGPT Miễn phí, Go, Plus, Pro, Business, Enterprise, Edu đều truy cập Codex; Miễn phí và Go chỉ có trong thời gian giới hạn.
Cài đặt qua npm install -g @openai/codex hoặc brew install codex.
Đăng nhập với ChatGPT OAuth (trình duyệt) hoặc mã thiết bị (máy chủ không giao diện đồ họa).
Chuyển đổi mô hình qua /model gpt-5.5; kiểm tra hạn ngạch bằng /status.
Kết hợp CLI với Apidog để chuẩn hóa, kiểm thử và triển khai các lệnh gọi API.

Tại sao Codex là cách tiếp cận miễn phí dễ dàng nhất

OpenAI API mặc định chỉ dành cho người dùng trả phí; GPT-5.5 trên endpoint Responses có giá $5/triệu token đầu vào và $30/triệu token đầu ra khi public. Codex đóng gói mô hình này vào CLI xác thực bằng tài khoản ChatGPT thay vì khóa API. Gói dịch vụ sẽ quyết định hạn mức—mô hình bên dưới vẫn là GPT-5.5 thực.

Cài đặt Codex CLI

Có 2 cách cài đặt chính:

# npm (cross-platform)
npm install -g @openai/codex

# hoặc Homebrew (macOS / Linux)
brew install codex

Kiểm tra cài đặt:

codex --version

Phiên bản phải >= 0.28.0 để hỗ trợ GPT-5.5.

Xác thực bằng tài khoản ChatGPT

Chạy CLI lần đầu sẽ yêu cầu đăng nhập.

OAuth trình duyệt (máy cục bộ)

codex

Một tab trình duyệt mở ra, đăng nhập với email ChatGPT. CLI lưu phiên làm việc, các lần sau không cần lặp lại.

Mã thiết bị (máy chủ không giao diện đồ họa)

codex login --device-auth

Copy mã hiển thị, mở URL trên thiết bị khác, dán mã và xác nhận.

Sử dụng khóa API (tùy chọn)

Nếu có khóa API trả phí:

printenv OPENAI_API_KEY | codex login --with-api-key

Cách này phí sử dụng sẽ tính vào tài khoản API, không phải ChatGPT.

Chọn GPT-5.5 làm mô hình

Codex mặc định dùng mô hình "recommended" cho gói; với gói miễn phí/Go có thể cần chuyển thủ công.

Trong phiên làm việc

/model gpt-5.5

Khởi chạy với flag

codex --model gpt-5.5

Kiểm tra hạn ngạch

/status

Xem ngân sách tin nhắn, cửa sổ ngữ cảnh, thời gian hết hạn dùng thử.

Phiên đầu tiên: ví dụ thực tế

Ví dụ sử dụng thực tế:

cd ~/Projects/my-app
codex --model gpt-5.5

Trong CLI, thử:

> Read README.md, then open scripts/deploy.sh and summarize what it does in five bullets.

Codex sẽ mở file, tóm tắt nội dung. Tiếp theo:

> Refactor deploy.sh so it exits on any failed step, and add a dry-run flag. Keep backwards compatibility.

Sau khi model đề xuất diff, bạn phê duyệt. Có thể chạy kiểm thử ngay:

> Run the deploy test suite and show me the failing case.

CLI trả về output kiểm thử; tiếp tục fix với GPT-5.5 cho đến khi pass.

OpenAI báo cáo điểm SWE-bench của GPT-5.5 đạt 88,7% (so với 74% của GPT-5.4), cải thiện rõ ở các tác vụ đa tệp và automation.

Điểm mạnh của Codex so với gọi API thô

CLI Codex mang lại:

Ngữ cảnh repo: Đọc cây tệp, index các file liên quan, truyền vào model mà không cần copy-paste.
Thực thi lệnh có phê duyệt: Model đề xuất, bạn duyệt trước khi chạy, tránh rủi ro shell.
Xem trước diff: Mọi edit file đều hiển thị diff để chấp nhận/từ chối/sửa.
Lưu lịch sử phiên: Quay lại CLI sau vẫn giữ ngữ cảnh cũ.

Nếu dùng API thuần, bạn phải tự xây lại từng tính năng trên. Hướng dẫn API GPT-5.5 có ví dụ, nhưng để dev hàng ngày, CLI hiệu quả hơn.

Giới hạn tốc độ và hạn mức theo gói

Bảng hạn mức tính đến 23/4/2026:

Gói	Truy cập GPT-5.5 trong Codex	Hạn mức hàng tuần
Miễn phí	Có (thời gian giới hạn)	Chặt chẽ; kích thước nguyên mẫu
Go	Có (thời gian giới hạn), gấp 2 lần giới hạn gói Miễn phí	Nhỏ
Plus	Có	Trung bình
Pro	Có, hạn mức cao nhất cho người dùng cá nhân	Cao
Business	Có, dựa trên số chỗ	Cao cho mỗi chỗ
Doanh nghiệp / Giáo dục	Có, dựa trên hợp đồng	Tùy chỉnh

Khi chạm hạn mức, Codex sẽ báo lỗi cụ thể. Sử dụng /status để kiểm tra số lượng còn lại.

Tích hợp với Editor và IDE

Tên đăng nhập Codex dùng chung cho extension VS Code, plugin JetBrains, app Cloud Codex. Sau khi login CLI, extension IDE sẽ tự nhận session, không cần đăng nhập lại.

Workflow kết hợp với Apidog:

Tạo prototype request trong Codex CLI (prompt GPT-5.5 trên file).
Xuất prompt & output có cấu trúc sang collection Apidog để chia sẻ với team.
Khi hợp đồng ổn định, chuyển sang gọi API trực tiếp.

Xem Apidog trong VS Code để kết nối collection vào editor.

Bảo vệ quy trình trên gói Miễn phí và Go

Hai cấu hình nên áp dụng ngay:

Luôn phê duyệt thao tác ghi file: Trong ~/.codex/config.json, đặt "autoApproveWrites": false. Mặc định an toàn trên gói Miễn phí, nhưng Go có thể auto-apply diff nhỏ.
Giới hạn workspace: Chạy codex trong thư mục dự án. Nếu mở từ ~, CLI sẽ đọc toàn bộ thư mục gốc.

OpenAI đã kiểm thử an toàn cho GPT-5.5, nhưng CLI vẫn chạy local—hãy luôn xem xét diff trước khi apply.

Khi nào nên chuyển khỏi gói miễn phí

"Thời gian giới hạn" nghĩa là Codex Free/Go sẽ cần nâng cấp trong tương lai. Lên kế hoạch sớm nếu:

Vượt hạn mức weekly: Đã dùng thực tế, nên lên Plus/Pro.
Cần API trực tiếp: Khối lượng lớn, nên xem hướng dẫn API GPT-5.5.
Team cần thanh toán theo vị trí: Dùng Business/Enterprise, phân tích giá tại đây.

Chuyển gói chỉ thay đổi phương thức thanh toán và UI—mô hình vẫn giữ nguyên.

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

Codex có chạy GPT-5.5 Pro không?

Không. CLI chỉ dùng model GPT-5.5 chuẩn trên mọi gói; Pro chỉ cho ChatGPT web và API sau này.

Có thể dùng Codex mà không có tài khoản ChatGPT?

Không. Bắt buộc đăng nhập ChatGPT hoặc dùng API key OpenAI.

Truy cập Free/Go kéo dài bao lâu?

"Thời gian giới hạn"—dự kiến vài tuần đến vài tháng; nên chuẩn bị nâng cấp khi cần.

Codex chạy offline được không?

Không. Mọi request GPT-5.5 đều gửi tới server OpenAI.

Khác biệt so với ChatGPT web?

Codex chạy trong terminal, truy cập hệ thống file local, shell, ngữ cảnh repo—web app không có các tính năng này.

Cách Sử Dụng API GPT-5.5 Miễn Phí

Sebastian Petrus — Fri, 24 Apr 2026 02:16:03 +0000

GPT-5.5 đã ra mắt ngày 23/4/2026 với hệ thống trả phí cho hầu hết các dịch vụ: gói Plus, Pro, Business, Enterprise trong ChatGPT, và token API trả phí cho các lệnh gọi lập trình. Tuy nhiên, bên trong đợt phát hành này vẫn có ba cách sử dụng miễn phí còn hoạt động tới hiện tại. Nếu chấp nhận giới hạn tốc độ và một số hạn chế thời gian, bạn vẫn có thể thực hiện các lệnh gọi GPT-5.5 thực tế mà không cần phương thức thanh toán.

Dùng thử Apidog ngay hôm nay

Bài này hướng dẫn từng cách miễn phí đã được kiểm tra, cách chọn phương pháp phù hợp với từng tình huống, và cách chuẩn hóa bộ sưu tập API sẵn sàng sản xuất trong Apidog để chuyển đổi mượt mà từ free sang trả phí khi nhu cầu tăng.

TL;DR

Codex CLI trên ChatGPT Free hoặc Go — truy cập tạm thời GPT-5.5 qua CLI Codex, không cần thẻ tín dụng.
Tín dụng dùng thử OpenAI cho tài khoản API mới — số dư nhỏ trên khóa API đầu tiên, mở các lệnh gọi GPT-5.5 khi Responses API được unlock.
Các gói miễn phí của OpenRouter và aggregator — cổng bên thứ ba thỉnh thoảng cấp quota free cho các model mới ngay vài ngày đầu phát hành.
Mỗi phương pháp đều có giới hạn. Khi sản xuất, hãy chuyển sang thanh toán trước khi hết hạn dùng thử.

Cách 1: Codex CLI (phương pháp miễn phí thực tế nhất)

OpenAI tích hợp Codex vào mọi gói ChatGPT khi ra mắt, kể cả Free/Go, trong một khoảng thời gian giới hạn. Điểm quan trọng là Codex cho phép truy cập GPT-5.5 qua đăng nhập ChatGPT thay vì API key. Đăng nhập bằng tài khoản free, chạy CLI, model phản hồi trong 400K token context.

Cài đặt

npm install -g @openai/codex
# hoặc
brew install codex

Kiểm tra:

codex --version

Xác thực

Chạy codex lần đầu, trình duyệt sẽ mở để xác thực ChatGPT OAuth. Nếu trên server headless:

codex login --device-auth

Quy trình device code sẽ cấp 1 URL ngắn + mã để dán vào máy khác. Không cần API key.

Chọn model

Trong phiên Codex:

/model gpt-5.5

Hoặc khởi động CLI với:

codex --model gpt-5.5

Kiểm tra quota còn lại với /status. Gói Free/Go bị giới hạn chặt hơn trả phí nhưng đủ để tạo mẫu công cụ nhỏ.

Bạn nhận được gì / không nhận được gì

Được: Model GPT-5.5 thực, context 400K, đọc file, thực thi terminal, edit repo trong CLI.
Không được: Không có API trực tiếp, chỉ truy cập qua Codex khi đã login.

Xem hướng dẫn chi tiết tại hướng dẫn sử dụng GPT-5.5 miễn phí với Codex.

OpenAI ghi rõ truy cập Codex Free/Go chỉ "có thời hạn". Lập trình nên dùng biến cấu hình cho model ID để chuyển đổi dễ dàng khi hết quota free.

Cách 2: Tín dụng dùng thử OpenAI cho tài khoản API mới

Tài khoản dev OpenAI mới thường được cấp một ít tín dụng dùng thử. Số tiền thay đổi từng đợt phát hành; thường là $5 trong 90 ngày đầu, có thể cao hơn cho email .edu. Khi API GPT-5.5 unlock rộng rãi, số dư này cho phép gọi thực tế tới gpt-5.5.

Cách nhận

Đăng ký tài khoản developer mới tại platform.openai.com. Dùng email chưa từng đăng ký trước.
Xác minh số điện thoại. Bắt buộc để nhận trial credit.
Tạo API key thuộc tổ chức thử nghiệm.
Kiểm tra dashboard usage để biết số tiền và ngày hết hạn.

Có thể làm gì với GPT-5.5

Với $5 credit và giá hiện tại $5/triệu token input, $30/triệu token output, bạn chạy được khoảng 1 triệu token input hoặc ~160K token output với gpt-5.5. Đủ để thử nghiệm mẫu nhỏ, kiểm tra workflow, hoặc prototyping agent loop — không đủ cho traffic production.

Tips tiết kiệm:

Dùng chế độ Batch: Batch API chạy với 50% tốc độ tiêu chuẩn, tốt cho workflow không cần phản hồi realtime (tham khảo pricing tại OpenAI).
Giữ reasoning.effort ở low: Mode này tiết kiệm token, phù hợp với hành vi GPT-5.4.

Điểm hạn chế

Trial credit không tự refill. Hết quota, API trả về lỗi 402. Không có lần dùng thử thứ hai cho cùng 1 tài khoản/thiết bị/số điện thoại.

Cách 3: Các gói miễn phí của trình tổng hợp (Aggregator)

Các cổng model bên thứ ba như OpenRouter, Together, Groq thỉnh thoảng cấp quota miễn phí cho model mới. Các ưu đãi này có thể biến mất bất kỳ lúc nào, nên hãy kiểm tra tình trạng thực tế trước khi sử dụng.

Quy trình chung:

Tạo tài khoản, xác minh email.
Lấy API key aggregator.
Đổi base URL trong SDK sang URL aggregator.
Đổi model string sang alias của aggregator, ví dụ: openai/gpt-5.5.

Ví dụ với Python SDK:

from openai import OpenAI

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key="sk-or-v1-...",
)

response = client.chat.completions.create(
    model="openai/gpt-5.5",
    messages=[{"role": "user", "content": "Explain the Responses API in two paragraphs."}],
)

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

Lưu ý: aggregator có rate limit và quota riêng, hạn mức free chia sẻ. Khi nhà cung cấp rút GPT-5.5 khỏi free tier, yêu cầu trả về lỗi 402/429. Đây chỉ là giải pháp tạo mẫu, không dùng cho sản xuất.

Bạn nên chọn cách nào trong các cách miễn phí này?

Trường hợp sử dụng	Cách miễn phí tốt nhất
Trợ lý mã hóa dựa trên Terminal	Codex CLI (Cách 1)
Thử nghiệm Python hoặc Node nhanh	Tín dụng dùng thử (Cách 2)
Kiểm tra từ một ứng dụng lưu trữ	Trình tổng hợp (Cách 3)
So sánh GPT-5.5 với GPT-5.4 trên các lời nhắc thực tế	Tín dụng dùng thử + Bộ sưu tập Apidog
Nghiên cứu một lần "cái này có thể trả lời câu hỏi của tôi không"	ChatGPT Plus (không miễn phí, nhưng rẻ nhất mỗi giờ)

Với mọi tác vụ lớn hơn bản mẫu, cả ba hình thức này sẽ hết hạn mức rất nhanh. Hãy tập trung tối ưu cấu trúc request và prompt trước khi chi trả token thực sự.

Chuẩn hóa cấu trúc request trong Apidog

Cách chuyển từ "dùng thử free" sang "khóa production" mà không phải rewrite code là xây dựng request một lần, kiểm soát qua versioned collection.

Trong Apidog:

Tạo collection mới, thêm request POST https://api.openai.com/v1/responses.
Đặt header xác thực từ biến môi trường, giúp đổi key dễ dàng mà không sửa body.
Lưu response mẫu để dev sau làm việc với mock khi chưa có key thật.
Nhân bản collection cho aggregator bằng cách trỏ baseUrl sang OpenRouter, đổi chuỗi model.

Khi hết trial hoặc chuyển gói, chỉ cần đổi biến môi trường, collection vẫn chạy. Xem thêm hướng dẫn sử dụng Apidog trong VS Code nếu muốn tích hợp ngay trong Cursor hoặc Claude Code.

Hạn chế của các phương pháp miễn phí cần lưu ý

Giới hạn tốc độ phụ thuộc tải: Codex Free/Go sẽ chậm lại vào giờ cao điểm.
Tín dụng không cộng dồn: Tài khoản OpenAI thứ hai không có trial nếu trùng thẻ/điện thoại/IP.
GPT-5.5 Pro không có trên bất kỳ bề mặt free nào: Chỉ dành cho trả phí.
Chế độ tư duy (Thinking mode) tốn quota: Dùng reasoning.effort ở mức low nếu không cần benchmark chính xác.
Gói miễn phí chỉ là tạm thời: Quyền truy cập Codex Free/Go là "trong thời hạn" theo thông báo ra mắt của OpenAI.

Mẫu thử nghiệm thực tế với gói miễn phí

Quy trình tối ưu tận dụng quota free:

Chọn tác vụ thật sự nhóm bạn thực hiện (báo cáo, review code, tóm tắt nghiên cứu).
Chạy 10 ví dụ thực tế với GPT-5.4 trên công cụ hiện tại, ghi lại chất lượng.
Chạy 10 ví dụ tương tự qua GPT-5.5 trên Codex CLI hoặc trial credit.
So sánh chất lượng output token và tỷ lệ lỗi.
Đánh giá liệu việc nâng cấp lên GPT-5.5 có xứng đáng với chi phí tăng gấp đôi cho workload của bạn không.

Chỉ mất một buổi chiều để thực thi — tiết kiệm chi phí ngay từ tháng đầu khi chuyển sang production.

FAQ

Codex Free và Go có vĩnh viễn không?

Không. Thông báo của OpenAI ghi rõ chỉ "có thời hạn", dự kiến hết sau vài tháng từ ngày phát hành.

ChatGPT Free có GPT-5.5 trong trình duyệt không?

Không. ChatGPT Free vẫn là GPT-5.3 mặc định. GPT-5.5 yêu cầu ChatGPT Plus trở lên.

Có thể chạy GPT-5.5 trên Hugging Face/Ollama free không?

Không được. GPT-5.5 là closed-weight, chỉ chạy trên hạ tầng OpenAI hoặc qua login Codex.

OpenAI còn giảm giá cho sinh viên không?

Từng có chương trình giảm giá cho email .edu và trial credit cao hơn các đợt trước. Xem trang giáo dục của OpenAI để kiểm tra ưu đãi hiện tại.

Chuyển từ free sang trả phí mà không rewrite code thế nào?

Dùng biến môi trường cho key và base URL (OPENAI_API_KEY, OPENAI_BASE_URL). Khi hết trial, chỉ cần đổi biến. Xem hướng dẫn API GPT-5.5 để thực hiện theo best practice.