Quay lại blog

Bắt đầuHướng dẫn

Request đầu tiên tới API tương thích OpenAI trong Postman

Gửi request chat/completions từ Postman với key Bearer giữ trong biến, và đọc câu trả lời cùng trường usage.

Bởi CheapTokens TeamĐã xuất bản 5 phút đọc

Request body trong Postman với model id và một message cho API CheapTokens
Trên trang này
  1. Thiết lập trong bốn bước
  2. Nhấn Send và đọc response
  3. Request đầu tiên tốn bao nhiêu
  4. Nếu không chạy được

Bạn có một API key và muốn xem thực sự có gì được truyền đi trước khi viết một dòng code nào. Postman rất phù hợp cho đúng việc đó: bạn điền URL, key và một JSON body, nhấn Send, và câu trả lời hiện ra ngay bên dưới. Với CheapTokens, request là POST https://api.cheaptokens.dev/v1/chat/completions với key Authorization: Bearer và một JSON body nêu tên model.

Các bước dưới đây theo tài liệu của chính Postman (v12, phiên bản mới nhất trên trang docs, kiểm tra ngày 31 tháng 10 năm 2026). Nếu bạn thích dùng terminal, request tương tự có trong Your first API request with CheapTokens.

The request body in Postman: model id, one user message, max_tokens
The raw JSON body of the first request

Thiết lập trong bốn bước#

Bạn chỉ cần vài thứ: base URL, key của bạn, một model id và một message. Postman lưu hai thứ đầu trong biến, nên key không bao giờ bị dán trực tiếp vào request.

Sắp xếp thứ tự

Put the Postman setup in order

  1. Define the variables base_url and api_key
  2. Create an HTTP request: POST to {{base_url}}/chat/completions
  3. On the Authorization tab choose Bearer Token and enter {{api_key}}
  4. On the Body tab choose raw > JSON, paste the body, press Send

Một vài chi tiết cho từng bước.

Tạo request. Nhấn biểu tượng Add ở thanh bên trái và chọn HTTP. Dropdown method mặc định là GET, nên chuyển sang POST và nhập URL. Biến của Postman được viết là {{variable_name}}; tài liệu dùng {{base_url}} làm ví dụ. Định nghĩa base_url là https://api.cheaptokens.dev/v1 và trường URL trở thành {{base_url}}/chat/completions. Postman lưu biến dưới dạng chuỗi, điều này ổn ở đây.

Thêm key. Mở tab Authorization, chọn Bearer Token trong dropdown Auth Type và đặt {{api_key}} vào trường Token. Postman gửi nó dưới dạng header Authorization theo định dạng Bearer. Tài liệu khuyến nghị đúng điều này: giữ token trong một biến và tham chiếu đến nó theo tên. Lý do thói quen này quan trọng có trong Store an API key safely.

Viết body. Trên tab Body chọn raw, rồi JSON trong dropdown. Với raw body, Postman tự đặt Content-Type tương ứng, nên bạn không cần thêm header đó. Dán đoạn này:

json
{
  "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
  "messages": [
    { "role": "user", "content": "Explain in one sentence what a token is." }
  ],
  "max_tokens": 200
}

Model id là gateway_id đầy đủ từ tài liệu CheapTokens; một tên ngắn như deepseek-flash sẽ không được chấp nhận. max_tokens giới hạn độ dài câu trả lời, nên lần thử đầu không thể chạy quá dài. Một chi tiết nữa của Postman: các comment // và /* */ trong JSON body sẽ bị loại bỏ trước khi gửi, nên bạn có thể chú thích body cho đồng nghiệp.

Nhấn Send và đọc response#

Nếu mọi thứ đúng, khung response hiển thị một JSON object theo định dạng OpenAI Chat Completions. Hai chỗ quan trọng:

  • choices[0].message.content là văn bản câu trả lời.
  • usage chứa prompt_tokens (những gì bạn gửi) và completion_tokens (những gì model viết). Đây là thứ bạn bị tính phí, nên hãy xem nó ngay ở request đầu tiên.

Cũng hãy kiểm tra choices[0].finish_reason. stop nghĩa là model tự kết thúc; length nghĩa là câu trả lời chạm max_tokens và bị cắt. Nếu thấy điều đó, hãy tăng giới hạn hoặc đọc AI answer cut off? Fix finish_reason "length".

Thử trước khi mở đáp án:

Tự mình thử xemTry it: you set max_tokens to 5 and press Send. What do you expect in finish_reason?Hiện đáp án

Bạn nhận được length: năm token không đủ cho một câu đầy đủ, nên câu trả lời bị cắt. Đặt lại 200 thì nó thành stop.

Request đầu tiên tốn bao nhiêu#

Giả sử request trên dùng khoảng 30 input token và câu trả lời mất khoảng 100 output token (đây là ví dụ, không phải đo lường; trường usage của bạn hiển thị con số thực). Trên DeepSeek-V4-Flash, đó là $0.00001 theo giá hiện tại, và giá như nhau ở mọi giờ. Giá trên 1M token có trong bảng trực tiếp trên the pricing page.

Cùng request Postman đó có thể thử model khác. Chỉ thay dòng model, ví dụ bằng zai-org/GLM-5.3-Flash (context 390K, tối đa 8.192 output token), và nhấn Send lần nữa. Một số dư dùng chung cho mọi model, nên không có gì khác thay đổi: cùng URL, cùng key.

Nếu không chạy được#

Postman hiển thị mã trạng thái bên cạnh response. Đây là những nghi phạm thường gặp:

Ghép cặp

Match the symptom to its cause

  • 401 UnauthorizedThe key is missing, mistyped, or {{api_key}} is empty because the variable isn't defined
  • 404 Not FoundThe URL is wrong: check that base_url ends with /v1 and the path is /chat/completions
  • An error that mentions the modelThe model id is shortened; use the full id such as deepseek-ai/DeepSeek-V4-Flash-0731

Có hai điều đặc thù của Postman đáng kiểm tra. Nếu bạn nhận 401 hoặc URL trông sai, hãy kiểm tra rằng base_url và api_key được định nghĩa trong environment bạn đã chọn. Và nếu key trông đúng mà vẫn nhận 401, hãy mở lại tab Authorization: Auth Type phải là Bearer Token, không phải No Auth. Thêm về các mã này: API 401 or 404 error. Chưa chắc dùng id nào? List models with GET /v1/models trả về tất cả.

Khi đã hài lòng, nhấn Save, đặt tên cho request và chọn một collection. Lần sau bạn chỉ cần sửa trường content, hoặc dòng model để so sánh câu trả lời. Tài liệu tham chiếu API đầy đủ có trong the CheapTokens docs.

Thẻ: