DEV Community: Sebastian Petrus

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.

Cách Sử Dụng Hy3 Preview API Miễn Phí

Sebastian Petrus — Thu, 23 Apr 2026 10:45:50 +0000

Tencent đã công bố mã nguồn mở Hy3 Preview vào ngày 22 tháng 4 năm 2026, và chỉ sau 1 ngày, OpenRouter đã thêm nó như một điểm cuối miễn phí hoàn toàn. Không cần thẻ tín dụng, không phí token, không giới hạn dùng thử. Bạn có thể gọi mô hình Mixture-of-Experts 295B-tham số mà Tencent sử dụng cho Yuanbao và CodeBuddy, trực tiếp từ mã nguồn của bạn, hoàn toàn miễn phí.

Dùng thử Apidog ngay hôm nay

Bài viết này hướng dẫn cách sử dụng API Hy3 Preview miễn phí qua OpenRouter, Hugging Face Space và repo Hy3 gốc. Bạn sẽ biết các chế độ suy luận đặc biệt của Hy3 và cách kiểm thử API trong Apidog mà không cần viết script một lần.

Nếu bạn muốn nhận kết quả nhanh nhất, hãy chuyển ngay tới mục “Hướng dẫn từng bước: gọi Hy3 Preview miễn phí trên OpenRouter.”

TL;DR

Hy3 Preview miễn phí trên OpenRouter với model ID tencent/hy3-preview:free, giá $0 cho cả input và output.
Mô hình Mixture-of-Experts: 295B tham số tổng, 21B tham số hoạt động, 192 chuyên gia, định tuyến top-8, cửa sổ ngữ cảnh 256K-token.
Ba chế độ suy luận tích hợp: no_think cho trả lời nhanh; low và high cho chuỗi suy nghĩ sâu cho tác vụ agent/lập trình.
Điểm chuẩn mạnh cho mô hình mã nguồn mở: SWE-bench Verified 74.4, Terminal-Bench 2.0 54.4, GPQA Diamond 87.2, MMLU 87.42.
Có thể sử dụng miễn phí qua: gói free của OpenRouter, Hy3-preview Space của Hugging Face, hoặc chạy cục bộ với vLLM và trọng số mở.
Apidog tích hợp tốt với endpoint OpenRouter vì Hy3 dùng schema OpenAI Chat Completions; chỉ cần trỏ request tới OpenRouter là chạy.

Hy3 Preview là gì?

Hy3 Preview là bản phát hành nền tảng lớn đầu tiên từ nhóm Hunyuan Platform Models đã tái cấu trúc của Tencent, do Yao Shunyu (cựu OpenAI) dẫn dắt. Đây là mô hình mạnh nhất của Tencent, cạnh tranh trực tiếp với các mô hình mã nguồn mở hàng đầu Trung Quốc như DeepSeek, Alibaba, Zhipu.

Thông số kỹ thuật từ thẻ mô hình chính thức:

Kiến trúc: Mixture-of-Experts, 80 lớp + 1 lớp MTP, 64 head attention, attention nhóm truy vấn.
Tham số: 295B tổng, 21B hoạt động mỗi lượt forward.
Chuyên gia: 192 chuyên gia, định tuyến top-8/token.
Ngữ cảnh: 256K token (OpenRouter hiển thị 262.144).
Tokenizer: 120.832 mục, BF16.
Giấy phép: Tencent Hy Community License, cho phép thương mại trong điều khoản.

Điểm khác biệt là huấn luyện theo hướng agent: Tencent xây lại hạ tầng RL cho multi-turn tool use, đạt điểm benchmark SWE-bench, Terminal-Bench, WildClawBench tiệm cận mô hình đóng cho tác vụ code/shell.

Ba cách miễn phí để sử dụng Hy3 Preview

Bạn có 3 lựa chọn tùy nhu cầu: giao diện chat, API, hay tự lưu trữ trọng số.

Đường dẫn	Nó là gì	Miễn phí?	Thích hợp cho
OpenRouter `tencent/hy3-preview:free`	API OpenAI-compatible hosted	Có, $0 input/output	Xây agent, script, backend
Hugging Face Space	Chat demo trên browser	Có	Nhắc lệnh nhanh, test sơ bộ
Tự lưu trữ (vLLM/SGLang)	Chạy trọng số mở trên GPU của bạn	Phần mềm free, tốn phần cứng	Công việc cần bảo mật, khối lượng lớn

Đa số dev sẽ chọn OpenRouter – nhanh nhất từ đăng ký tới gọi API, rate limit free đủ cho prototype.

Hướng dẫn từng bước: gọi Hy3 Preview miễn phí trên OpenRouter

Đây là quy trình đơn giản nhất để gọi Hy3 Preview qua API:

Đăng ký tài khoản OpenRouter tại openrouter.ai. Chỉ cần email, không yêu cầu thanh toán cho model free.
Tạo API key. Vào "Keys" → tạo mới, copy vào biến môi trường, vd: export OPENROUTER_API_KEY=sk-or-...
Mở trang mô hình. Vào danh sách miễn phí Hy3 Preview và xác nhận trạng thái "Free". Xem usage và trạng thái.

Gửi request đầu tiên. Schema OpenAI Chat Completions; mọi OpenAI SDK đều dùng được:

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tencent/hy3-preview:free",
    "messages": [
      {"role": "user", "content": "Explain the MoE routing decision inside a top-8 of 192 setup in 3 sentences."}
    ],
    "temperature": 0.9,
    "top_p": 1.0
  }'

Bật suy luận khi cần. Thêm tham số reasoning với effort là low hoặc high. OpenRouter trả về dấu vết suy nghĩ trong mảng reasoning_details:

{
  "model": "tencent/hy3-preview:free",
  "messages": [
    {"role": "user", "content": "Plan, then write a Bash script that rotates daily log files older than 30 days into a dated archive folder."}
  ],
  "reasoning": {"effort": "high"}
}

Lặp lại. Giữ nguyên thread để tận dụng cửa sổ 256K token, phù hợp với codebase lớn hoặc context dài.

Mô hình này giống bản trên Hugging Face; chất lượng trên OpenRouter free = các bản trả phí khác.

Miễn phí, Plus, và tự lưu trữ: điểm khác biệt

So sánh nhanh:

Khả năng	OpenRouter Free	OpenRouter Trả phí	Tự lưu trữ (vLLM/SGLang)
Giá/token	$0	Theo provider	Điện + khấu hao GPU
Chế độ suy luận	`no_think`, `low`, `high`	Như trên	Như trên
Độ dài ngữ cảnh	256K	256K	256K (tùy RAM)
Thông lượng tải cao	Nhóm chung, ưu tiên thấp	Riêng biệt	Tùy cluster
Giới hạn rate	Theo chính sách free OpenRouter	Theo provider	Không có
Lưu trữ dữ liệu	Theo OpenRouter	Theo provider	Trên máy bạn
Hiển thị reasoning tokens	Có	Có	Có

Miễn phí phù hợp cho prototype, dự án phụ, agent traffic thấp. Trả phí hoặc tự lưu trữ khi cần độ trễ thấp, vượt giới hạn rate.

Mẹo nhắc lệnh & tham số tận dụng tối đa Hy3

Phối hợp nhiệt độ với chế độ. Dùng temperature=0.9, top_p=1.0 mặc định. Output có cấu trúc giảm xuống 0.3, sáng tạo giữ 0.9.
Dùng no_think cho chat thường. Chỉ bật low/high khi cần planning, code đa bước, toán học.
Đặt tên tool trong system prompt. Luôn mô tả tool, đừng chỉ dựa vào schema.
Paste code, không tóm tắt. Cửa sổ 256K, paste nguyên file rồi hỏi.
Sửa nhiều file cùng lúc. Đưa toàn bộ files vào 1 message, không drip từng file.
Bắt mô hình lên kế hoạch. Với agent, dùng mẫu 2 bước: "plan trước, chờ tôi xác nhận, rồi thực hiện".

Giới hạn cần biết trước khi triển khai

Rate limit thay đổi theo tải. Free group chia nhau, giờ cao điểm dễ lỗi 429. Luôn retry với exponential backoff.
Token suy luận tính vào output. reasoning_details miễn phí trên OpenRouter free, nhưng bản trả phí tính phí như output.
License không phải Apache 2.0. Đọc kỹ giấy phép trên GitHub nếu thương mại hóa.
Tool call cần parser đúng. Tự host phải dùng vLLM/SGLang kèm --tool-call-parser hy_v3.
Tiếng Anh/Trung mạnh nhất. Ngôn ngữ khác hỗ trợ nhưng chất lượng thấp hơn.
Chưa bằng flagship Mỹ trên benchmark suy luận khó. Hy3 ngang top Trung Quốc, nhưng vẫn dưới OpenAI/Google DeepMind trên một số test.

Lối tắt phát triển: Hy3 Preview + Apidog

Dùng curl để test nhanh, nhưng để lặp lại thực tế, nên dùng client API trực quan như Apidog.

Tạo dự án mới trên Apidog. Nhập OpenAPI spec của OpenAI Chat Completions.
Đặt base URL là https://openrouter.ai/api/v1, thêm biến môi trường cho OPENROUTER_API_KEY.
Tạo request tới /chat/completions với model tencent/hy3-preview:free.
Clone request để so sánh các chế độ reasoning (no_think, low, high) song song.
Lưu prompt templates. Dùng biến của Apidog để tái sử dụng system prompt, tool schema, lượt user.

Nếu chuyển từ Postman, tham khảo hướng dẫn kiểm thử API không dùng Postman năm 2026. Làm việc trong VS Code? Xem cách dùng Apidog trong VS Code để chỉnh prompt cạnh code.

Các lựa chọn thay thế miễn phí nếu chạm giới hạn

Nếu rate limit free của OpenRouter khiến bạn chậm vào giờ cao điểm, thử:

Hugging Face Space: Hy3-preview Space cho chat demo trên browser (không script, nhưng free và nhanh).
Các model mã nguồn mở Trung Quốc khác: Qwen 3.5 Omni của Alibaba có free tier mạnh, đa phương thức; xem thông báo Qwen 3.5 Omni và hướng dẫn sử dụng. Zhipu GLM 5V Turbo cũng miễn phí rộng; hướng dẫn tại API GLM 5V Turbo.

Các model này không vượt Hy3 ở agentic coding, nhưng đáp ứng tốt chat, đa ngôn ngữ, đa phương thức. Để test thực tế, hãy thiết lập bộ sưu tập trên Apidog cho từng model và benchmark với prompt thực tế của bạn.

Tự lưu trữ Hy3 Preview với vLLM

Muốn suy luận cục bộ? Thẻ model khuyên dùng vLLM với tensor-parallel 8, bật multi-token speculative decoding:

vllm serve tencent/Hy3-preview \
  --tensor-parallel-size 8 \
  --speculative-config.method mtp \
  --speculative-config.num_speculative_tokens 1 \
  --tool-call-parser hy_v3 \
  --reasoning-parser hy_v3 \
  --enable-auto-tool-choice \
  --served-model-name hy3-preview

SGLang dùng --tool-call-parser hunyuan và --reasoning-parser hunyuan. Khi server chạy ở http://localhost:8000/v1, dùng bất kỳ SDK OpenAI nào, chỉ đổi base URL và key.

Cần tối thiểu 8 GPU H100 với BF16 để chạy model đầy đủ. Bản lượng tử hóa cộng đồng sẽ sớm ra mắt, nhưng hiện tại chỉ có bản full precision.

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

Hy3 Preview có miễn phí không?

Có. OpenRouter liệt kê tencent/hy3-preview:free với $0 cho 1M token input/output. Token reasoning cũng miễn phí trên free tier (nhưng tính vào rate limit). Kiểm tra trạng thái tại trang model OpenRouter trước khi dùng sản xuất.

Hy3 Preview so với DeepSeek V3 & Qwen 3 thế nào?

Điểm SWE-bench 74.4, Terminal-Bench 54.4 của Hy3 ngang top open models Trung Quốc, mạnh về agent/tool use. Với chat thường, Qwen 3 và DeepSeek V3 cạnh tranh; về agent/lập trình, Hy3 nổi trội nhờ RL tool use.

Các chế độ reasoning của Hy3 là gì?

Ba chế độ: no_think (mặc định, trả lời trực tiếp), low, high. Chuyển qua tham số reasoning khi gọi OpenRouter, hoặc chat_template_kwargs={"reasoning_effort": "high"} khi gọi trực tiếp. Dùng high cho planning, code đa bước, toán học; tắt khi chỉ chat.

Có thể dùng Hy3 Preview cho mục đích thương mại?

Có, theo Tencent Hy Community License. Đọc kỹ license trên GitHub nếu muốn nhúng vào sản phẩm có thu.

Free tier hỗ trợ context dài bao nhiêu?

256K token. OpenRouter hiển thị 262.144 token, đúng với thẻ model. Đủ chứa nguyên codebase trung bình, tool schema và history.

Kiểm thử Hy3 Preview mà không viết code thế nào?

Dùng Hugging Face Space để chat demo trên browser, hoặc trỏ Apidog vào endpoint OpenRouter. Apidog nhập spec OpenAI, chỉ cần base URL, API key, model name là chạy.

API Mua Bán Fiat Tốt Nhất 2026

Sebastian Petrus — Thu, 23 Apr 2026 09:53:51 +0000

Cổng chuyển đổi tiền pháp định (fiat on-ramp) và cổng rút tiền pháp định (fiat off-ramp) là giải pháp kết nối ngân hàng với tiền mã hóa. Khi xây dựng ví điện tử, ngân hàng số hoặc ứng dụng stablecoin, bạn sẽ gặp bài toán: làm sao chuyển đổi thẻ Visa ở Lagos hoặc chuyển khoản SEPA ở Berlin thành USDC, rồi sau đó rút euro về tài khoản mà không phải xây lại hệ thống PSP từ con số 0?

Hãy thử Apidog ngay hôm nay

Thông thường, các đội ngũ sẽ tích hợp API cổng chuyển đổi/rút tiền pháp định. Một lần tích hợp duy nhất để xử lý KYC, thanh toán, tuân thủ, chọn chuỗi và chuyển tiền – bạn tập trung vào sản phẩm. Các tiêu chí chọn lựa xoay quanh quốc gia, phương thức thanh toán, phí và trải nghiệm lập trình viên. Tham khảo thêm tại Stripe Crypto Onramp và MoonPay Business.

Bài viết này so sánh 6 nhà cung cấp sẵn sàng để triển khai cho năm 2026 và hướng dẫn bạn kiểm thử nhanh qua Apidog. Nếu xây dựng trên nền tảng stablecoin, hãy kết hợp hướng dẫn về cách sử dụng API Circle.

Tóm tắt

API cổng chuyển đổi tiền pháp định giúp chuyển đổi tiền ngân hàng thành crypto; cổng rút tiền pháp định làm ngược lại và chuyển tiền về tài khoản ngân hàng.
Chọn dựa trên phạm vi quốc gia, phương thức thanh toán (thẻ, ACH, SEPA, UPI, Pix), cấu trúc phí và nhu cầu widget nhúng hay API đầy đủ.
MoonPay và Transak có phạm vi quốc gia rộng nhất; Ramp Network tối ưu cho EU/UK ở trải nghiệm lập trình viên.
Coinbase Onramp và Stripe Crypto Onramp mạnh ở thị trường Mỹ, phù hợp nếu bạn cần thương hiệu lớn.
Kado dẫn đầu về phí rút tiền pháp định thấp và các luồng stablecoin.
Luôn kiểm thử toàn bộ luồng chuyển đổi và rút tiền pháp định ở môi trường sandbox trước khi triển khai; các vấn đề phí và KYC sẽ lộ diện nhanh chóng.

Những điều cần kiểm tra khi chọn API cổng chuyển đổi/rút tiền pháp định

Phạm vi quốc gia & tiền tệ: Kiểm tra danh sách quốc gia và loại tiền pháp định thực tế được hỗ trợ, tránh trường hợp ghi "hỗ trợ 150 nước" nhưng chỉ chấp nhận thanh toán thẻ ở một nửa số đó.
Phương thức thanh toán: Thẻ tín dụng/ghi nợ tiện nhưng phí cao. ACH, SEPA, UPI, Pix, iDEAL thường rẻ hơn và tăng tỷ lệ chuyển đổi. Thị trường Ấn Độ/Brazil thì UPI/Pix là bắt buộc.
Xử lý KYC: Xác định nhà cung cấp có xử lý KYC đầu-cuối hay chuyển giao lại. Full-KYC giúp tích hợp nhanh, ủy quyền lại giúp kiểm soát trải nghiệm người dùng. Xem thêm về API KYC tốt nhất.
Thời gian & phí giao dịch: Thẻ nhanh (phút), phí 3-5%. ACH/SEPA chậm hơn (1-3 ngày), phí <1%. Phí rút tiền pháp định thay đổi, có nhà cung cấp lấy 2%.
Nhúng widget vs API: Widget lưu trữ tích hợp cực nhanh (~30 phút). API đầy đủ cho phép tùy biến giao diện nhưng yêu cầu giấy phép. Đa số đội ngũ chọn widget trước, sau đó chuyển sang API.
Hỗ trợ stablecoin & rút tiền pháp định: USDC/USDT trên Ethereum, Solana, Base, Polygon là tiêu chuẩn. Xác minh kỹ phạm vi rút tiền pháp định, nhiều nhà cung cấp chỉ hỗ trợ vài quốc gia.

Bảng so sánh

Nhà cung cấp	Giá cả	Phạm vi	Trải nghiệm nhà phát triển	Phù hợp nhất cho
MoonPay	1%–4.5% thẻ, 1% ACH	160+ quốc gia, 30+ tiền pháp định	Widget + REST API, tài liệu đầy đủ	Ví cần phạm vi thẻ toàn cầu
Ramp Network	0.49%–2.9%	150+ quốc gia, mạnh ở EU/UK	SDK hiện đại, tài liệu rõ ràng	Ứng dụng ở EU/UK muốn ít rào cản
Transak	0.99%–5.5%	150+ quốc gia, 75+ tiền pháp định	Widget + API, dễ nhúng	Phạm vi rộng, mạnh Ấn Độ (UPI)
Coinbase Onramp	1%–3.99%	Mỹ + 90 quốc gia	Pay SDK, React components	App ưu tiên Mỹ, cần thương hiệu lớn
Kado	1.5% phí rút tiền pháp định cố định	170+ quốc gia	API ưu tiên stablecoin	App stablecoin, rút tiền pháp định rẻ
Stripe Crypto Onramp	1.5% + phí Stripe	Mỹ + quốc tế hạn chế	Tích hợp sâu với Stripe	App đã dùng Stripe

Nhà cung cấp nổi bật

MoonPay

Hỗ trợ 160+ quốc gia, 30+ tiền pháp định.
Phương thức: thẻ, ACH, SEPA, Apple Pay, Google Pay, Pix.
Widget xử lý KYC/AML/chống gian lận; API REST cho phép tích hợp sâu nếu bạn có giấy phép.
Phí: 1–4.5% (tùy phương thức/khu vực). Hỗ trợ rút tiền pháp định về thẻ/tài khoản ngân hàng ở hầu hết thị trường lớn.
Hướng dẫn: Cách sử dụng API MoonPay.
Phù hợp nhất: Ví tiêu dùng cần độ phủ toàn cầu với 1 nhà cung cấp duy nhất.

Ramp Network

Mạnh ở EU/UK: SDK rõ ràng, phí minh bạch, KYC nhanh với SEPA.
Hỗ trợ 150+ quốc gia, tối ưu phí Open Banking (~0.49%).
Widget nhúng vào React/JS, SDK mobile có sẵn.
Rút tiền pháp định khả dụng ở EU, UK; danh sách quốc gia đang mở rộng.
Kết hợp tốt với các ví kiểu MetaMask – xem hướng dẫn API MetaMask.
Phù hợp nhất: Ứng dụng EU/UK ưu tiên SEPA, Open Banking, ít rào cản.

Transak

Hỗ trợ 150+ quốc gia, 75+ tiền pháp định.
Rộng phương thức thanh toán bản địa: UPI (Ấn Độ), Pix (Brazil).
Widget nhúng mọi web/mobile app; API cho luồng white-label.
Phí 0.99–5.5% tùy hành lang/thanh toán.
KYC đầu-cuối, hỗ trợ đổi/rút pháp định ở đa số thị trường mới nổi.
Phù hợp nhất: App nhắm tới Ấn Độ, Đông Nam Á, LATAM.

Coinbase Onramp (Pay SDK)

Pay SDK cho phép nạp tiền ví chỉ vài thao tác với tài khoản Coinbase.
Mạnh với người dùng Mỹ (nhiều người đã có tài khoản Coinbase).
Hỗ trợ ngoài Mỹ ở 90 quốc gia qua thẻ/phương thức bản địa.
SDK cung cấp React components, luồng lưu trữ, tận dụng KYC sẵn có.
Rút tiền pháp định mới triển khai, giới hạn quốc gia.
Phù hợp nhất: App ưu tiên Mỹ, tận dụng thương hiệu Coinbase để tăng chuyển đổi.

Kado

Chuyên stablecoin (USDC/USDT trên Solana, Base, Polygon, Ethereum).
Phí rút tiền pháp định rẻ nhất (~1.5% cố định).
Hỗ trợ 170+ quốc gia, phương thức chuyển khoản ngân hàng, thẻ, SEPA.
API tối ưu cho app stablecoin: nạp ví, rút về bank cùng 1 tài khoản.
Tài liệu ngắn gọn, rõ ràng.
Phù hợp nhất: App stablecoin, ngân hàng số, công cụ payroll muốn phí rút tiền thấp.

Stripe Crypto Onramp

Phù hợp nhất nếu bạn đã dùng Stripe.
Dùng lại account/anti-fraud/dashboard Stripe, phí 1.5% + phí Stripe.
Phạm vi ưu tiên Mỹ, đang mở rộng quốc tế.
Nhúng đơn giản: 1 embed, Stripe lo KYC/thanh toán.
Rút tiền pháp định không phải trọng tâm – chủ yếu là chuyển tiền vào USDC/ETH.
Phù hợp nhất: App Stripe Mỹ muốn on-ramp nhanh, không tích hợp nhà cung cấp mới.

Cách lựa chọn

Liệt kê 3 quốc gia lớn nhất & phương thức thanh toán phổ biến tại đó.
Nếu cần UPI, Pix, hoặc phạm vi thẻ rộng ở châu Phi → chọn Transak hoặc MoonPay.
Ưu tiên EU → chọn Ramp.
Thị trường Mỹ, cần thương hiệu lớn → chọn Coinbase hoặc Stripe SDK.
App gốc stablecoin, rút tiền pháp định lớn → cân nhắc Kado.
So sánh thêm về giá, hỗ trợ rút tiền pháp định, sự khác biệt widget/API.
Luôn thử nghiệm song song 2 nhà cung cấp; dữ liệu thực tế quan trọng hơn mọi bản trình bày.

Kiểm tra API cổng chuyển đổi tiền pháp định với Apidog

Trước khi chọn nhà cung cấp, hãy kiểm thử toàn bộ luồng chuyển đổi/rút tiền pháp định ở môi trường thử nghiệm (sandbox).
Dùng Apidog để import OpenAPI spec của MoonPay, Ramp, Transak... và chạy các request đã xác thực trên sandbox.
Tạo script cho endpoint báo giá, mô phỏng KYC, quan sát payload webhook về workspace.
Thiết lập 3 môi trường: sandbox, staging, production. Lưu API key từng nhà cung cấp vào biến môi trường Apidog để tránh hard-code secret.
Chuỗi các request: lấy báo giá → tạo giao dịch → kiểm tra trạng thái → xác nhận webhook → kích hoạt rút tiền pháp định.
Khi flow chạy ổn định trên Apidog, chuyển sang backend chỉ mất vài giờ.
Tải Apidog để bắt đầu kiểm thử.

Nếu bạn quan tâm đến phía ví, xem thêm tổng hợp API ví tiền mã hóa tốt nhất.

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

Khác biệt giữa cổng chuyển đổi (on-ramp) và cổng rút tiền (off-ramp) là gì? Cổng chuyển đổi đưa tiền pháp định (thẻ, chuyển khoản ngân hàng, hệ thống địa phương) thành crypto và chuyển vào ví. Cổng rút tiền làm ngược lại: nhận crypto, chuyển tiền pháp định về tài khoản/thẻ.
Có cần giấy phép chuyển tiền để dùng các API này không? Thường là không. Đa số nhà cung cấp đã có giấy phép và xử lý tuân thủ đầu-cuối, bạn chỉ là đối tác kỹ thuật. Nếu muốn giữ tiền khách hàng hoặc tùy chỉnh KYC sâu, có thể phải xin giấy phép riêng – đọc kỹ điều khoản từng nhà cung cấp.
Nhà cung cấp nào phí thấp nhất? Thẻ ở EU: Ramp Network thường thấp nhất (0.49–2.9%). Rút tiền pháp định: Kado chỉ 1.5% cố định. Stripe cũng rẻ nếu bạn đã dùng. Luôn so sánh thực tế theo hành lang thanh toán.
Có thể dùng nhiều nhà cung cấp đồng thời không? Có, nhiều app đang routing theo quốc gia, phương thức, tiền tệ để tối ưu chuyển đổi và chi phí. Xem thêm hướng dẫn chi tiết API MoonPay.
KYC mất bao lâu? Thẻ + upload tài liệu: 2–5 phút. KYC liên kết bank qua Open Banking (Ramp) có thể xong dưới 30 giây với user cũ. Nếu bị flag rủi ro cao, review thủ công 24–48 giờ.
Các nhà cung cấp này có hỗ trợ stablecoin không? Có. USDC/USDT trên Ethereum, Solana, Base, Polygon đều được hỗ trợ. Kado & Stripe Crypto Onramp tối ưu cho stablecoin; các nhà cung cấp khác coi stablecoin là 1 lựa chọn trong nhiều loại coin.

Cách Sử Dụng MetaMask API: Kết Nối dApp với Ví Ethereum

Sebastian Petrus — Thu, 23 Apr 2026 07:45:52 +0000

MetaMask là cổng truy cập Ethereum mặc định cho hàng chục triệu người dùng. Nếu bạn xây dựng dApp, MetaMask API là cầu nối giữa frontend và khóa ký của người dùng. "MetaMask API" thực chất gồm hai phần: nhà cung cấp window.ethereum (chuẩn EIP-1193) được inject vào trình duyệt, và MetaMask SDK mở rộng cho mobile, React Native, Node.js. Nắm chắc provider này, bạn đã kiểm soát được 80% tích hợp ví trên web.

Dùng thử Apidog ngay hôm nay

Bài này hướng dẫn bạn phát hiện provider, yêu cầu tài khoản, đọc chain hiện tại, ký message với personal_sign và EIP-712, gửi transaction, thêm/chuyển chain, và sử dụng MetaMask SDK ngoài browser extension. Ngoài ra, bạn sẽ thấy ethers.js v6, viem đóng vai trò wrapper như thế nào, và Apidog hỗ trợ kiểm thử JSON-RPC mà không cần viết code frontend một lần.

Nếu làm việc với ví, hãy bookmark hướng dẫn API ví tiền điện tử tốt nhất để tổng quan hơn về các provider.

TL;DR (Tóm tắt)

MetaMask API là EIP-1193 provider ở window.ethereum + MetaMask SDK cho mobile/Node.
Khởi đầu với eth_requestAccounts để kết nối, sau đó lắng nghe accountsChanged và chainChanged.
Ký message với personal_sign; ký dữ liệu cấu trúc với eth_signTypedData_v4 (EIP-712).
Chuyển network bằng wallet_switchEthereumChain (EIP-3326), thêm chain mới với wallet_addEthereumChain (EIP-3085).
ethers.js v6, viem và wagmi là wrapper cấp cao; Snaps mở rộng MetaMask.
Sử dụng Apidog để test endpoint JSON-RPC, mô phỏng transaction & debug signature trước khi production.

MetaMask API là gì?

MetaMask API cung cấp interface để web/app tương tác với Ethereum hoặc bất kỳ chuỗi EVM nào. Extension sẽ inject object window.ethereum tuân thủ EIP-1193. Mọi dApp tuân EIP-1193 sẽ chạy với MetaMask, Coinbase Wallet, Rabby, Frame v.v mà không cần thay đổi code.

Với mobile, backend, desktop, MetaMask SDK cung cấp provider tương tự cho React Native, Node.js, Electron, script server-side. SDK xử lý deep-link và quy trình QR để ví MetaMask mobile ký các request từ desktop/backend. Tất cả vẫn nói EIP-1193 nên code không đổi.

MetaMask cũng có Snaps, hệ plugin mở rộng ví với chain mới, RPC custom, loại tài khoản mới. Snaps ngoài phạm vi bài này, nhưng rất hữu ích nếu bạn cần hỗ trợ non-EVM chain hoặc custom signing flow.

Xác thực và thiết lập

Không cần API key cho provider. Xác thực dựa vào user approve từng request trên giao diện ví. Bạn cần: cách phát hiện provider và lắng nghe events.

Phát hiện provider:

Dùng helper @metamask/detect-provider hoặc kiểm tra trực tiếp.

// Phát hiện MetaMask với Vanilla JS
import detectEthereumProvider from '@metamask/detect-provider';

const provider = await detectEthereumProvider({ mustBeMetaMask: true });

if (!provider) {
  alert('Vui lòng cài đặt MetaMask');
} else {
  console.log('Đã phát hiện MetaMask');
}

Lắng nghe sự kiện:

Luôn set listener cho accountsChanged và chainChanged trước bất kỳ request nào.

window.ethereum.on('accountsChanged', (accounts) => {
  if (accounts.length === 0) {
    console.log('Người dùng đã ngắt kết nối');
  } else {
    console.log('Tài khoản đang hoạt động:', accounts[0]);
  }
});

window.ethereum.on('chainChanged', (chainId) => {
  // Best practice: reload lại app khi chain đổi
  window.location.reload();
});

Nếu dùng React, wagmi sẽ tự động nhận diện MetaMask qua injected connector.

Các điểm cuối cốt lõi

Toàn bộ lệnh gọi qua window.ethereum.request({ method, params }). Dưới đây là các call phổ biến nhất.

Yêu cầu tài khoản và đọc chuỗi

// Nhắc user connect ví
const accounts = await window.ethereum.request({
  method: 'eth_requestAccounts',
});
const account = accounts[0];

// Đọc chain hiện tại
const chainId = await window.ethereum.request({
  method: 'eth_chainId',
});

console.log(account, chainId); // '0x...' '0x1'

Ví dụ gọi thô qua curl:

curl https://mainnet.infura.io/v3/YOUR_KEY \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}'

Lưu ý: call chỉ-read có thể dùng node provider như Alchemy/Infura, không cần MetaMask. Xem hướng dẫn Alchemy API để biết thêm.

Ký message đơn giản

personal_sign là dạng ký phổ biến, an toàn hơn so với eth_sign.

const message = 'Đăng nhập vào Apidog vào lúc ' + new Date().toISOString();
const signature = await window.ethereum.request({
  method: 'personal_sign',
  params: [message, account],
});

Ký dữ liệu cấu trúc (EIP-712)

Sử dụng eth_signTypedData_v4 để ký structured data.

const typedData = {
  domain: { name: 'Apidog Demo', version: '1', chainId: 1 },
  types: {
    EIP712Domain: [
      { name: 'name', type: 'string' },
      { name: 'version', type: 'string' },
      { name: 'chainId', type: 'uint256' },
    ],
    Login: [
      { name: 'wallet', type: 'address' },
      { name: 'nonce', type: 'uint256' },
    ],
  },
  primaryType: 'Login',
  message: { wallet: account, nonce: 42 },
};

const sig = await window.ethereum.request({
  method: 'eth_signTypedData_v4',
  params: [account, JSON.stringify(typedData)],
});

Gửi transaction

MetaMask tự estimate gas và nonce.

const txHash = await window.ethereum.request({
  method: 'eth_sendTransaction',
  params: [{
    from: account,
    to: '0xRecipientAddressHere',
    value: '0x38d7ea4c68000', // 0.001 ETH (wei, hex)
  }],
});

Chuyển đổi/Thêm chain

EIP-3326/EIP-3085 cho phép chuyển chain hoặc thêm chain mới.

// Chuyển sang Polygon (chainId 137 = 0x89)
try {
  await window.ethereum.request({
    method: 'wallet_switchEthereumChain',
    params: [{ chainId: '0x89' }],
  });
} catch (err) {
  if (err.code === 4902) {
    // Chain chưa được thêm
    await window.ethereum.request({
      method: 'wallet_addEthereumChain',
      params: [{
        chainId: '0x89',
        chainName: 'Polygon',
        rpcUrls: ['https://polygon-rpc.com'],
        nativeCurrency: { name: 'MATIC', symbol: 'MATIC', decimals: 18 },
      }],
    });
  }
}

Tích hợp React với MetaMask SDK

SDK hoạt động tốt trên React khi bạn muốn support extension, deep link mobile, hoặc in-app browser.

import { MetaMaskProvider, useSDK } from '@metamask/sdk-react';

function Connect() {
  const { sdk, connected, account } = useSDK();
  return (
    <button onClick={() => sdk?.connect()}>
      {connected ? account : 'Kết nối MetaMask'}
    </button>
  );
}

export default function App() {
  return (
    <MetaMaskProvider sdkOptions={{ dappMetadata: { name: 'dApp của tôi' } }}>
      <Connect />
    </MetaMaskProvider>
  );
}

Sản xuất nên wrap provider với ethers.js v6 hoặc viem để có contract type, decode ABI, thông báo lỗi tốt hơn. Nếu cần đăng nhập email/social fallback, có thể kết hợp MetaMask với embedded wallet, xem hướng dẫn Privy API.

Lỗi phổ biến & giới hạn tỷ lệ

MetaMask trả về mã lỗi JSON-RPC tiêu chuẩn:

4001: User từ chối request. Không tự động retry.
4100: Chưa ủy quyền. Gọi eth_requestAccounts trước.
4200: Method không hỗ trợ. Xác nhận đúng ví MetaMask.
4902: Chain chưa được thêm. Gọi wallet_addEthereumChain.
-32002: Request đang chờ xử lý. Debounce phía frontend.

Provider không giới hạn rate, nhưng RPC (Infura/Alchemy) có hạn mức tùy gói. Đổi sang fiat như ETH-USD, hãy xem API on/off ramp fiat.

Giá của MetaMask API

MetaMask Extension + SDK đều miễn phí, không tính phí kết nối, ký hay transaction. MetaMask thu phí qua swap và thẻ MetaMask Card, không thu từ developer.

Bạn chỉ cần trả phí cho node RPC (Infura/Alchemy). Gói free đủ cho app nhỏ; production dApp thường tốn 49–299 USD/tháng tùy thông lượng.

Kiểm tra MetaMask API với Apidog

Ký trình duyệt rất khó debug do request đi qua extension, web, và có thể cả deep-link mobile. Apidog giúp bạn test endpoint JSON-RPC thô, xác nhận eth_chainId hoặc eth_getBalance trả đúng, và lưu trữ toàn bộ flow thành test collection.

Chỉ cần import đặc tả Ethereum JSON-RPC, set URL node thành biến môi trường là bạn có collection dùng lại cho mọi EVM chain. Apidog mô phỏng response, cho phép frontend dev build trên eth_sendTransaction giả trong khi smart contract đang audit. CI có thể chạy bộ test từ CLI và fail nếu response shape đổi. Nếu bạn từng struggle với Postman collection sync, đọc hướng dẫn kiểm thử API không cần Postman 2026 để hiểu vì sao Apidog phù hợp test dApp đa giao thức.

Tải xuống Apidog để bắt đầu.

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

MetaMask API có dùng trên mobile được không?

Có. Dùng MetaMask SDK để deep link sang app mobile. Provider interface y hệt extension nên code không thay đổi. Đọc thêm so sánh SDK ví mobile tại API ví tiền điện tử tốt nhất.

Phân biệt eth_sign, personal_sign và eth_signTypedData_v4?

eth_sign ký byte thô, nguy hiểm – MetaMask cảnh báo mạnh. personal_sign ký message có tiền tố dễ đọc. eth_signTypedData_v4 ký structured data EIP-712, hiển thị field rõ ràng cho user trên UI. Dùng hai cái sau, tránh eth_sign.

Có cần API key riêng của MetaMask không?

Không. Provider miễn phí, không cần key. Đọc dữ liệu ngoài ví thì cần RPC provider như Infura/Alchemy (có key riêng).

ethers.js hoặc viem dùng với MetaMask được không?

Được, cả hai đều wrap window.ethereum. Ethers v6 dùng BrowserProvider(window.ethereum), viem dùng createWalletClient({ transport: custom(window.ethereum) }). Production dApp nên dùng.

Nếu user cài nhiều ví thì sao?

MetaMask hỗ trợ EIP-6963 giúp dApp phát hiện toàn bộ ví đã cài thay vì tranh chấp window.ethereum. Wagmi, RainbowKit xử lý tự động.

MetaMask Snaps đã production ready chưa?

Có, đã phát hành rộng 2024. Phần lớn dùng cho non-EVM chain, custom transaction info, tích hợp ví phần cứng.

Hướng Dẫn Sử Dụng Plaid API (Phiên Bản 2026 Dành Cho Nhà Phát Triển)

Sebastian Petrus — Thu, 23 Apr 2026 07:43:27 +0000

Các ứng dụng Fintech hiện đại thường tích hợp với tài khoản ngân hàng của người dùng ngay từ đầu. Plaid đóng vai trò trung gian, chuyển đổi thông tin đăng nhập ngân hàng thành dữ liệu JSON sạch mà backend của bạn có thể thao tác. API Plaid hỗ trợ liên kết tài khoản, kiểm tra số dư, truy xuất lịch sử giao dịch và xác minh danh tính cho hàng nghìn ứng dụng như Venmo, Robinhood, Chime.

Dùng thử Apidog ngay hôm nay

Bài viết này hướng dẫn bạn sử dụng API Plaid dưới góc độ kỹ thuật: lấy khóa, thực hiện quy trình Link token từ đầu đến cuối, các sản phẩm cốt lõi, ý nghĩa các lỗi thường gặp, và cách kiểm thử từng bước với Apidog. Để tra cứu chi tiết, hãy mở tài liệu chính thức của Plaid song song khi đọc.

Nếu bạn còn phân vân giữa các nền tảng ngân hàng mở, hãy tham khảo bài tổng hợp các API ngân hàng mở tốt nhất. Ở đây, ta giả định bạn đã chọn Plaid và bắt đầu triển khai.

Tóm tắt

Plaid kết nối ứng dụng với hơn 12.000 ngân hàng tại Mỹ, Canada, Châu Âu.
Ba môi trường: sandbox (miễn phí, dữ liệu giả), development (100 Item thực miễn phí), production (tính phí).
Quy trình liên kết: tạo link_token (server) → mở Plaid Link (client) → đổi public_token lấy access_token (server) → gọi các endpoint sản phẩm.
Các sản phẩm chính: Auth, Balance, Transactions, Identity, Investments, Liabilities, Income. Kích hoạt từng Item.
Lỗi phổ biến: ITEM_LOGIN_REQUIRED, INVALID_CREDENTIALS. Webhook cảnh báo khi Item gặp vấn đề.
Giới hạn tần suất theo Item và client. Ưu tiên đọc hàng loạt và lắng nghe webhook thay vì polling.

Plaid là gì?

Plaid là nền tảng hạ tầng fintech đặt giữa app của bạn và ngân hàng của người dùng. Người dùng nhập thông tin vào Plaid Link; Plaid sẽ kết nối với ngân hàng (qua API chính thức hoặc reverse engineering web), chuẩn hóa dữ liệu và trả về phản hồi JSON đồng nhất — bạn không cần xử lý sự khác biệt từng ngân hàng.

Bạn không lưu trữ thông tin đăng nhập ngân hàng. Plaid giữ kết nối (gọi là Item), cung cấp access_token để truy vấn. Một Item là một thông tin đăng nhập tại một tổ chức tài chính, có thể chứa nhiều loại tài khoản.

Plaid hỗ trợ tài khoản tiền gửi, tiết kiệm, thẻ tín dụng, khoản vay, đầu tư và bảng lương. Plaid không xử lý chuyển tiền trực tiếp; muốn chuyển khoản ACH, hãy kết hợp Plaid Auth với một payment processor. Tham khảo thêm ở danh sách API thanh toán ACH tốt nhất.

Xác thực và thiết lập

Bước 1: Đăng ký tài khoản Plaid Developer

Truy cập plaid.com, đăng ký, xác minh email. Dashboard cấp sẵn 3 môi trường:

Sandbox: tổ chức/người dùng giả, miễn phí. Đăng nhập dùng user_good / pass_good.
Development: kết nối ngân hàng thực, tối đa 100 Item thực, miễn phí.
Production: không giới hạn, tính phí theo usage.

Bước 2: Lấy khóa API

Vào Team Settings > Keys trên Dashboard.

client_id: dùng cho mọi môi trường
secret: riêng mỗi môi trường (sandbox, development, production)

Lưu vào biến môi trường, không commit lên git.

Bước 3: Cài đặt SDK

SDK Node.js: github.com/plaid/plaid-node

npm install plaid

Bước 4: Khởi tạo client Plaid

import { Configuration, PlaidApi, PlaidEnvironments } from 'plaid';

const config = new Configuration({
  basePath: PlaidEnvironments.sandbox,
  baseOptions: {
    headers: {
      'PLAID-CLIENT-ID': process.env.PLAID_CLIENT_ID,
      'PLAID-SECRET': process.env.PLAID_SECRET,
    },
  },
});

const client = new PlaidApi(config);

Chuyển PlaidEnvironments.sandbox thành .development hoặc .production khi deploy lên môi trường tương ứng.

Các endpoint cốt lõi

Quy trình Link token

Tích hợp Plaid luôn tuân theo 4 bước:

Tạo link_token (server-side)

const response = await client.linkTokenCreate({
  user: { client_user_id: 'user_123' },
  client_name: 'Your App',
  products: ['auth', 'transactions'],
  country_codes: ['US'],
  language: 'en',
});
const linkToken = response.data.link_token;

Hoặc bằng curl:

curl -X POST https://sandbox.plaid.com/link/token/create \
  -H 'Content-Type: application/json' \
  -d '{
    "client_id": "YOUR_CLIENT_ID",
    "secret": "YOUR_SANDBOX_SECRET",
    "user": { "client_user_id": "user_123" },
    "client_name": "Your App",
    "products": ["auth", "transactions"],
    "country_codes": ["US"],
    "language": "en"
  }'

Mở Plaid Link (client-side)

Gửi link_token lên frontend và truyền vào Plaid Link SDK. Người dùng chọn ngân hàng, đăng nhập, SDK trả về public_token trong callback onSuccess.

Đổi public_token sang access_token (server-side)

const exchange = await client.itemPublicTokenExchange({
  public_token: publicToken,
});
const accessToken = exchange.data.access_token;
const itemId = exchange.data.item_id;

Lưu accessToken (gắn với user), sử dụng cho các request sau này.

Gọi endpoint sản phẩm (server-side)

const accounts = await client.accountsGet({ access_token: accessToken });
const balance = await client.accountsBalanceGet({ access_token: accessToken });

Các endpoint sản phẩm cần biết

Auth: Lấy số tài khoản, số routing cho ACH (/auth/get).
Balance: Lấy số dư thời gian thực (/accounts/balance/get).
Transactions: Lấy lịch sử giao dịch tối đa 24 tháng (/transactions/sync).
Identity: Lấy tên, email, SĐT, địa chỉ (/identity/get). Nếu chỉ cần KYC, tham khảo danh sách API KYC tốt nhất.
Investments: Lấy danh mục tài sản, giao dịch đầu tư (/investments/holdings/get).
Liabilities: Chi tiết khoản vay, thẻ tín dụng, thế chấp (/liabilities/get).
Income: Dữ liệu bảng lương qua Plaid Income (/credit/payroll_income/get).

Kiểm thử API Plaid với Apidog

Kiểm thử tích hợp Plaid khó vì bước Link diễn ra trên trình duyệt. Để test endpoint server-side với payload hợp lệ, xem lỗi, chia sẻ request với team – Apidog là lựa chọn tối ưu.

Nhập OpenAPI spec của Plaid vào Apidog, bạn sẽ có sẵn mọi endpoint, mẫu dữ liệu, header xác thực. Tạo biến môi trường sandbox (client_id, secret, access_token), chuyển sang production chỉ bằng 1 click. Có thể tạo chuỗi request: linkTokenCreate → sandboxPublicTokenCreate → itemPublicTokenExchange → accountsGet để kiểm thử cả flow không cần browser.

Server mock của Apidog giúp frontend lấy phản hồi /accounts/get trước khi backend hoàn thiện. Nếu chuyển từ công cụ khác, xem hướng dẫn kiểm thử API không cần Postman. Tải về Apidog, trỏ vào spec Plaid và bắt đầu.

Các lỗi thường gặp & giới hạn tần suất

Plaid trả về lỗi với error_type, error_code, error_message rõ ràng. 4 lỗi production cần xử lý:

INVALID_CREDENTIALS: Người dùng nhập sai mật khẩu. Yêu cầu đăng nhập lại qua Link update mode.
ITEM_LOGIN_REQUIRED: Phiên bị ngân hàng hủy (đổi mật khẩu, MFA). Nhận biết qua webhook, kích hoạt Link update để xác thực lại.
RATE_LIMIT_EXCEEDED: Vượt quá giới hạn trên Item hoặc endpoint. Giảm tần suất, retry với backoff ngẫu nhiên.
PRODUCT_NOT_READY: Dữ liệu đang sync. Đợi webhook INITIAL_UPDATE rồi thử lại.

Webhooks

Truyền webhook URL khi tạo link_token, Plaid sẽ POST update vào đó. 3 loại quan trọng:

SYNC_UPDATES_AVAILABLE: Có giao dịch mới
ITEM: LOGIN_REQUIRED: Yêu cầu xác thực lại
ITEM: ERROR: Lỗi không phục hồi

Luôn xác minh chữ ký JWT trên webhook trước khi xử lý.

Giới hạn tần suất

Plaid áp dụng limit theo Item và endpoint. Ví dụ /accounts/balance/get: ~5 lần/phút/Item ở production. Một số endpoint còn giới hạn tổng theo client. Thực tế: poll webhook, cache balance vài phút, không gọi Plaid từ endpoint user-facing.

Giá của Plaid

Sandbox: miễn phí, không giới hạn.
Development: miễn phí đến 100 Items thực.
Production:
- Auth: ~$1.50/tài khoản liên kết (một lần)
- Balance: tính phí theo call
- Transactions: phí hàng tháng/Item (~$0.30)
- Identity: tính phí theo call
- Investments / Liabilities / Income: giá riêng/Item

Giá có thể thương lượng. Tham khảo trang sản phẩm Plaid để cập nhật mới nhất.

FAQ

access_token tồn tại bao lâu? Không hết hạn trừ khi user thu hồi hoặc ngân hàng hủy phiên. Lưu trữ mã hóa phía server.

Dùng Plaid chỉ để xác minh danh tính được không? Được, qua Plaid Identity. Nhưng nếu chỉ cần KYC, nên cân nhắc sản phẩm chuyên biệt (hướng dẫn Stripe Identity API).

Plaid hỗ trợ quốc gia nào? Mỹ, Canada, Anh, phần lớn EU. Kiểm tra country_codes khi gọi /link/token/create.

User đổi mật khẩu ngân hàng thì sao? Item chuyển sang ITEM_LOGIN_REQUIRED, nhận webhook, kích hoạt Link update để xác thực lại (không mất access_token).

Có test quy trình Link không cần browser không? Được, dùng endpoint /sandbox/public_token/create để lấy public_token test tự động.

Phát triển local thì dùng Plaid thế nào? Lưu secret sandbox vào .env, kết nối với PlaidEnvironments.sandbox. Để nhận webhook local, dùng tunneling (ngrok, Cloudflare Tunnel,...).