Lấy API key và gọi thử bằng cURL trong 3 phút

Hướng dẫn đăng ký TaiKhoanGiaRe, lấy secret key, cấu hình OpenAI base URL, gọi /v1/chat/completions bằng cURL và kiểm tra Usage.

Nếu bạn đang viết ứng dụng, thử nghiệm chatbot hoặc kiểm tra nhanh một model trước khi tích hợp SDK, cURL là cách gọn nhất để gửi request HTTP. Bài này hướng dẫn toàn bộ quy trình trên TaiKhoanGiaRe: đăng ký tài khoản, mở tab API keys, xem secret key, dùng OpenAI-compatible base URL và gọi endpoint /v1/chat/completions.

Cuối cùng, bạn sẽ biết cách kiểm tra request có chạy hay không, xem mức sử dụng trong tab Usage và xử lý các lỗi thường gặp. Ví dụ dùng model gpt-5.5, nhưng bạn có thể thay bằng model khác trong danh sách tại trang models nếu model đó hỗ trợ endpoint phù hợp.

Chuẩn bị trước khi gọi API

Bạn cần một tài khoản TaiKhoanGiaRe và một terminal có cURL. cURL thường có sẵn trên macOS, Linux và Windows hiện đại. Nếu chưa có tài khoản, hãy vào trang đăng ký hoặc đăng nhập. Tài khoản mới được cấp free trial credits theo chính sách hiện tại, không cần tự nhập số credit trong bước tạo tài khoản.

TaiKhoanGiaRe sử dụng credit trả trước. Một credit có giá 55,8đ và không có subscription. Khi cần nạp thêm, bạn mua credit trong tab Billing bằng chuyển khoản VietQR được xử lý qua PayOS. Các gói hiện có tại trang giá gồm:

• Starter: 99.000đ = 1500 credit
• Pro: 279.000đ = 5000 credit
• Business: 679.000đ = 13000 credit
• Enterprise: 1.339.000đ = 30000 credit

Để chỉ gọi thử một request văn bản, bạn có thể bắt đầu bằng free trial credits nếu tài khoản còn số dư. Nếu request không thể thực hiện do job thất bại, credit của job lỗi được hoàn lại theo chính sách của hệ thống.

Đăng ký và mở tab API keys

1. Truy cập trang đăng nhập, sau đó đăng ký tài khoản mới hoặc đăng nhập vào tài khoản hiện có.
2. Mở khu vực tài khoản tại dashboard.
3. Chọn tab API keys.
4. Dùng mục Show để hiển thị secret key của tài khoản.

Mỗi tài khoản có chính xác một secret key. Key này được tạo tự động khi đăng ký tài khoản, vì vậy bạn sẽ không thấy chức năng tạo thêm key hoặc quản lý nhiều key. Bạn chỉ có thể dùng Show để xem key hiện tại hoặc Rotate để vô hiệu hóa key hiện tại và thay bằng key mới.

Hãy xem secret key là thông tin riêng tư. Không đưa key vào mã nguồn công khai, file README, ảnh chụp màn hình, log CI hoặc đoạn chat có nhiều người. Với máy cá nhân, nên lưu key trong biến môi trường. Cách này giúp lệnh cURL đọc key mà không phải ghi trực tiếp secret vào lịch sử lệnh hoặc nội dung script.

Trong hướng dẫn này, chúng ta đặt tên biến là TAIKHOANGIARE_API_KEY. Tên biến chỉ là quy ước trên máy của bạn; secret key thật được lấy từ tab API keys.

export TAIKHOANGIARE_API_KEY='YOUR_SECRET_KEY'

Trên Windows PowerShell, có thể đặt biến môi trường cho phiên hiện tại bằng lệnh sau:

$env:TAIKHOANGIARE_API_KEY = "YOUR_SECRET_KEY"

Thay YOUR_SECRET_KEY bằng key đang hiển thị trong tài khoản. Không thêm khoảng trắng thừa, không đặt dấu ngoặc nhọn và không dùng key đã bị vô hiệu hóa sau khi Rotate.

Dùng đúng OpenAI-compatible base URL

Đối với OpenAI SDK và các client tương thích OpenAI, base URL của TaiKhoanGiaRe là:

https://taikhoangiare.vn/v1

Khi gọi endpoint chat completions, URL đầy đủ sẽ là:

https://taikhoangiare.vn/v1/chat/completions

Đây là điểm dễ nhầm khi cấu hình. Base URL đã có /v1, còn endpoint cần thêm /chat/completions. Không dùng base URL Anthropic cho request OpenAI-compatible: URL Anthropic là https://taikhoangiare.vn và dành cho endpoint /v1/messages theo giao diện tương thích Anthropic.

Request cần gửi secret key trong header:

Authorization: Bearer YOUR_SECRET_KEY

Ngoài cách xác thực bằng Authorization: Bearer, hệ thống cũng hỗ trợ x-api-key. Trong ví dụ cURL bên dưới, dùng Bearer để dễ đối chiếu với OpenAI-compatible API.

Gọi thử /v1/chat/completions bằng cURL

Đây là lệnh hoàn chỉnh cho macOS, Linux và các terminal hỗ trợ cú pháp shell. Lệnh gửi một tin nhắn văn bản đến model gpt-5.5:

curl https://taikhoangiare.vn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TAIKHOANGIARE_API_KEY" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {
        "role": "user",
        "content": "Hãy giải thích API là gì trong một đoạn ngắn."
      }
    ]
  }'

Trên Windows PowerShell, cú pháp chuỗi nhiều dòng có thể khác shell Unix. Bạn có thể dùng một dòng để tránh lỗi xuống dòng:

curl.exe https://taikhoangiare.vn/v1/chat/completions -H "Content-Type: application/json" -H "Authorization: Bearer $env:TAIKHOANGIARE_API_KEY" -d '{"model":"gpt-5.5","messages":[{"role":"user","content":"Hãy giải thích API là gì trong một đoạn ngắn."}]}'

Trong request, có ba phần chính:

• model xác định model muốn gọi. Ví dụ này dùng gpt-5.5.
• messages chứa lịch sử hội thoại. Mỗi message có role và content.
• Hai header cho biết nội dung là JSON và cung cấp thông tin xác thực.

Nếu key hợp lệ, còn số dư và request đúng định dạng, server sẽ trả về JSON của endpoint chat completions. Nội dung cụ thể phụ thuộc vào model và prompt, vì vậy không nên viết script dựa trên một câu trả lời cố định. Khi tích hợp vào ứng dụng, hãy đọc trường dữ liệu theo tài liệu API thay vì xử lý bằng cách cắt chuỗi thủ công.

Bạn có thể xem các endpoint, định dạng request và các model khả dụng trong tài liệu API. Khu vực Models & API trong dashboard cũng cung cấp danh sách model cùng bộ lọc capability như vision, tools và reasoning để bạn chọn endpoint phù hợp với nhu cầu.

Kiểm tra kết quả và xử lý lỗi thường gặp

Nếu cURL trả về lỗi xác thực, trước hết kiểm tra biến môi trường có tồn tại trong đúng cửa sổ terminal hay không. Với shell Unix, bạn có thể kiểm tra biến mà không in secret ra màn hình bằng cách xem biến có rỗng hay không:

if [ -z "$TAIKHOANGIARE_API_KEY" ]; then
  echo "TAIKHOANGIARE_API_KEY is not set"
else
  echo "TAIKHOANGIARE_API_KEY is set"
fi

Nếu vừa dùng Rotate, key cũ sẽ không còn dùng được. Khi đó, quay lại tab API keys, dùng Show để lấy key hiện tại và cập nhật lại biến môi trường.

Nếu server báo lỗi model, hãy kiểm tra chính tả của model. Model ID phải khớp với danh sách hiện có, chẳng hạn gpt-5.5, claude-sonnet-5 hoặc deepseek-v4-flash. Mỗi model có mức giá input, output và cache read riêng; không nên tự suy luận giá từ tên model. Bạn có thể xem danh sách và giá hiện tại trên trang models.

Nếu request trả về lỗi do hết số dư, mở tab Billing để xem lịch sử thanh toán và mua thêm credit bằng VietQR qua PayOS. Nếu request là job thất bại, credit của job lỗi được hoàn theo chính sách. Với vấn đề chưa rõ nguyên nhân, hãy lưu lại endpoint, model ID và thông báo lỗi, nhưng không gửi secret key khi liên hệ hỗ trợ qua Telegram @taikhoangiare hoặc email support@taikhoangiare.vn.

Kiểm tra Usage sau khi gọi

Sau khi request hoàn tất, quay lại dashboard và mở tab Usage. Tại đây bạn có thể xem usage theo các khoảng thời gian today, 7 days và 30 days, đồng thời lọc theo product.

Để kiểm tra đúng request vừa gửi, hãy đối chiếu model và product trong Usage với lệnh cURL. Nếu số liệu chưa đúng với điều bạn dự kiến, kiểm tra lại model ID, nội dung request và thời điểm gọi. Tab Overview cũng hiển thị balance, spend today, last 7 days và tokens, giúp bạn có cái nhìn nhanh về số dư và mức sử dụng.

TaiKhoanGiaRe bật prompt caching. Cache read được tính theo mức giá cache thấp hơn của từng model. Tuy nhiên, khi theo dõi chi phí, bạn vẫn nên xem dữ liệu Usage thực tế thay vì tự ước lượng từ số ký tự trong prompt, vì token input, output và cache read là các thành phần khác nhau.

Ví dụ, bảng giá hiện tại ghi gpt-5.5 ở mức 2.801đ cho một triệu token input, 2.801đ cho một triệu token output và 1.599đ cho một triệu token cache read. Với deepseek-v4-flash, các mức tương ứng là 1.226đ, 1.226đ và 700đ. Đây là giá theo model trên hệ thống; số credit thực tế của request phụ thuộc vào lượng token được sử dụng.

Từ cURL đến tích hợp ứng dụng

Khi lệnh cURL chạy thành công, bạn đã xác nhận được ba phần quan trọng: secret key hợp lệ, base URL đúng và model có thể nhận request qua endpoint tương thích. Từ đây, bạn có thể chuyển cùng cấu hình sang OpenAI SDK bằng base URL https://taikhoangiare.vn/v1, hoặc dùng hướng dẫn cho Claude Code, Cursor, Cline và các ứng dụng khác trong mục Integrations.

Nếu dùng Claude Code, cần nhớ cấu hình biến môi trường đúng tên là ANTHROPIC_BASE_URL và ANTHROPIC_AUTH_TOKEN. Nếu dùng ứng dụng khác, hãy kiểm tra client cho phép chỉnh base URL và header xác thực. Không phải mọi client đều dùng cùng tên biến môi trường, nhưng thông tin cốt lõi vẫn là endpoint, model ID và secret key.

Trong môi trường production, nên giữ key ở secret manager hoặc biến môi trường của máy chủ, phân quyền truy cập file cấu hình và tránh ghi header Authorization vào log. Khi nghi ngờ key bị lộ, dùng Rotate ngay trong tab API keys, sau đó cập nhật key mới ở các ứng dụng đang sử dụng.

Tóm lại: đăng ký hoặc đăng nhập, vào API keys để Show secret key, đặt base URL là https://taikhoangiare.vn/v1, gọi POST /v1/chat/completions bằng cURL, rồi kiểm tra balance và Usage trong dashboard. Đây là quy trình ngắn gọn để xác nhận kết nối trước khi bắt đầu tích hợp sâu hơn.

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

TaiKhoanGiaRe có hỗ trợ OpenAI-compatible base URL không?

Có. Base URL OpenAI-compatible là https://taikhoangiare.vn/v1. Khi gọi chat completions, endpoint đầy đủ là https://taikhoangiare.vn/v1/chat/completions.

Mỗi tài khoản có thể tạo nhiều API key không?

Không. Mỗi tài khoản có chính xác một secret key được tạo tự động khi đăng ký. Bạn chỉ có thể dùng Show để xem hoặc Rotate để vô hiệu hóa key hiện tại và thay bằng key mới.

Tôi dùng header nào để xác thực request cURL?

Bạn có thể dùng Authorization: Bearer YOUR_SECRET_KEY hoặc header x-api-key. Ví dụ trong bài dùng cách Authorization Bearer.

Gọi cURL xong xem chi phí ở đâu?

Mở dashboard, vào tab Usage để xem theo today, 7 days hoặc 30 days và lọc theo product. Tab Overview cũng hiển thị balance, spend today, last 7 days và tokens.

← Về trang Blog