VI ▾

Cách kiểm tra khóa API AI với curl và Python

Một khóa đang xoay trong ổ khóa với ba đèn báo xanh, đại diện cho việc kiểm tra khóa API thành công

Đây là cách bạn kiểm tra quyền truy cập khóa API AI mà không cần xây dựng gì: ba lệnh gọi, khoảng hai phút, và bạn sẽ biết khóa có hợp lệ, có tiền và được phép tạo văn bản hay không.

Cập nhật

Điểm chính

  • Gọi GET /v1/models trước: nó chứng minh khóa được chấp nhận mà không tiêu tốn tín dụng.
  • Gửi một yêu cầu chat ngắn đến mô hình uncensored để xác nhận việc tạo văn bản hoạt động.
  • Đọc tiêu đề X-Balance-USD hoặc GET /v1/balance để xem số dư còn lại.
  • 401 chỉ vào khóa, 402 chỉ vào số dư, 429 chỉ vào tốc độ yêu cầu của bạn.

Bài kiểm tra ba lệnh gọi

Để kiểm tra khóa API AI đúng cách, bạn cần chứng minh ba điều riêng biệt: máy chủ chấp nhận khóa, khóa có tín dụng đi kèm và một phản hồi hoàn thành thực sự được trả về. Một lệnh gọi cho mỗi câu hỏi giúp việc xác định lỗi đơn giản. Nếu có lỗi, bạn biết lớp nào gây ra lỗi.

  1. Danh sách mô hình. Xác thực khóa và miễn phí.
  2. Hoàn thành trò chuyện. Xác nhận mô hình trả lời và định dạng yêu cầu của bạn là đúng.
  3. Số dư. Xác nhận số dư còn lại sau khi kiểm tra.

Tất cả những nội dung dưới đây sử dụng base URL https://api.aiapisource.com/v1 và model ID uncensored. Đặt khóa của bạn trong biến môi trường để nó không bao giờ xuất hiện trong lịch sử shell hoặc kho lưu trữ của bạn.

export AIAPI_KEY="paste-your-key-here"

Nếu bạn chưa có khóa, trang khóa API sẽ hướng dẫn cách tạo một khóa. Tài khoản mới có thể nhận tín dụng dùng thử $0,50 ở đó chỉ với một cú nhấp chuột, đủ cho mọi thử nghiệm trong bài viết này.

Bước 1: liệt kê mô hình bằng curl

Kiểm tra rẻ nhất là một yêu cầu chỉ đọc. GET /v1/models trả về danh sách mô hình và yêu cầu khóa hợp lệ, vì vậy một câu trả lời thành công chứng minh xác thực.

curl -s https://api.aiapisource.com/v1/models \
  -H "Authorization: Bearer $AIAPI_KEY"

Một phản hồi tốt là JSON có mảng data chứa uncensored. Nếu bạn thấy trang HTML, lỗi kết nối hoặc phản hồi trống, vấn đề nằm ở URL chứ không phải khóa. Hãy kiểm tra xem bạn đã giữ hậu tố /v1 và không có khoảng trắng thừa sau khóa trong biến của bạn.

Thêm -i vào lệnh curl để xem tiêu đề phản hồi. API gửi X-Request-Id trên mọi lệnh gọi. Hãy giữ giá trị đó nếu bạn liên hệ hỗ trợ, vì nó xác định chính xác yêu cầu.

Bước 2: gửi một yêu cầu chat

Bây giờ hãy kiểm tra khả năng sinh. Hãy giữ prompt nhỏ và giới hạn đầu ra để thử nghiệm chỉ tốn một phần nhỏ của một xu.

curl -s https://api.aiapisource.com/v1/chat/completions \
  -H "Authorization: Bearer $AIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Reply with the single word: ready"}],
    "max_tokens": 10
  }'

Hãy tìm choices[0].message.content và một đối tượng usage với prompt_tokens và completion_tokens. Một yêu cầu với khoảng 20 token đầu vào và 5 token đầu ra tốn 20 / 1.000.000 x $0.15 cộng 5 / 1.000.000 x $0.50, tức là khoảng $0.0000055. Bạn có thể chạy hàng trăm yêu cầu như vậy với chi phí dưới một xu.

Endpoint tương tự cũng hoạt động cho streaming: thêm "stream": true và token đến dưới dạng sự kiện do máy chủ gửi. Hãy kiểm tra riêng biệt một lần khi lệnh gọi cơ bản hoạt động.

Bước 3: cùng thử nghiệm bằng Python

Nếu mã nguồn thực tế của bạn sử dụng OpenAI SDK, hãy kiểm tra thông qua SDK. Nó bắt lỗi mà curl không bắt được, chẳng hạn như base URL được truyền vào đối số sai.

import os
from openai import OpenAI

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

print([m.id for m in client.models.list().data])

r = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Reply with the single word: ready"}],
    max_tokens=10,
)
print(r.choices[0].message.content)
print(r.usage)

Lệnh in đầu tiên sẽ hiển thị danh sách chứa uncensored. Lệnh in thứ hai hiển thị phản hồi của mô hình. Để xem hướng dẫn chi tiết hơn về cách thiết lập SDK, hãy xem hướng dẫn Python API OpenAI trên trang web này.

Chạy phiên bản Python từ cùng một shell nơi bạn đã xuất khóa. Nếu nó gây ra KeyError trên AIAPI_KEY, biến chưa được đặt trong phiên đó, đây là lý do phổ biến nhất khiến thử nghiệm thất bại trước khi nó chạm đến mạng.

Node hoạt động theo cách tương tự: truyền baseURL: "https://api.aiapisource.com/v1" và khóa vào hàm tạo máy khách OpenAI.

Kiểm tra số dư

Một khóa có thể hợp lệ nhưng vẫn không có gì để chi tiêu. Hai cách để đọc số dư:

curl -s https://api.aiapisource.com/v1/balance \
  -H "Authorization: Bearer $AIAPI_KEY"

# OpenAI-style alternative
curl -s https://api.aiapisource.com/v1/dashboard/billing/credit_grants \
  -H "Authorization: Bearer $AIAPI_KEY"

Mọi phản hồi cũng mang tiêu đề X-Balance-USD, vì vậy lệnh gọi chat từ bước 2 đã cho bạn biết tín dụng còn lại nếu bạn chạy nó với -i. Trong Python, OpenAI SDK hiển thị điều này thông qua client.chat.completions.with_raw_response.create(...), nơi bạn đọc response.headers["X-Balance-USD"].

Các yêu cầu thất bại hoặc bị từ chối không bị tính phí, vì vậy một thử nghiệm bị lỗi không tiêu tốn tín dụng. Tín dụng trả trước không bao giờ hết hạn, nghĩa là số dư chưa sử dụng vẫn sẽ còn vào tuần sau.

Đọc các mã lỗi

Khi một lệnh kiểm tra thất bại, trạng thái HTTP giúp thu hẹp nguyên nhân nhanh chóng.

Trạng tháiÝ nghĩa thông thườngNhững việc cần làm
401Khóa bị thiếu, gõ sai hoặc bị thu hồiKiểm tra tiêu đề Authorization: Bearer, sao chép lại khóa, tìm khoảng trắng ẩn hoặc dấu ngoặc kép
402Không còn tín dụng để trả cho yêu cầuĐọc số dư, sau đó nạp tiền trên trang giá
404Đường dẫn sai hoặc model ID saiSử dụng /v1/chat/completions và mô hình uncensored
429Giới hạn tốc độ hoặc đồng thời, hoặc quá tải ngắn hạnChờ và thử lại; xem bên dưới

Mã 429 mang một mã lỗi. rate_limited có nghĩa là quá nhiều yêu cầu mỗi phút và concurrency có nghĩa là quá nhiều cùng lúc. Khóa đầy đủ cho phép 300 yêu cầu mỗi phút và 8 yêu cầu đồng thời; khóa dùng thử cho phép 60 mỗi phút và 2 cùng lúc. Khi quá tải tạm thời, API trả về 429 với Retry-After: 5, vì vậy hãy đợi năm giây và gửi lại yêu cầu. Một yêu cầu truyền phát giữ slot đồng thời của nó cho đến khi stream kết thúc, đây là lý do phổ biến khiến khóa dùng thử chạm giới hạn trong các thử nghiệm song song.

Các mã trạng thái 401, 402 và 404 tuân theo quy ước API thông thường, vì vậy hãy xem bảng như một phỏng đoán ban đầu và đọc thân lỗi JSON để có thông điệp chính xác.

Kịch bản kiểm tra nhanh có thể tái sử dụng

Khi thử nghiệm thủ công thành công, hãy giữ một kịch bản bạn có thể chạy sau khi xoay khóa hoặc thay đổi môi trường.

import os, sys
import requests

BASE = "https://api.aiapisource.com/v1"
H = {"Authorization": "Bearer " + os.environ["AIAPI_KEY"]}

m = requests.get(BASE + "/models", headers=H, timeout=15)
print("models", m.status_code)

c = requests.post(
    BASE + "/chat/completions",
    headers=H,
    json={"model": "uncensored",
          "messages": [{"role": "user", "content": "ping"}],
          "max_tokens": 5},
    timeout=60,
)
print("chat", c.status_code, "balance", c.headers.get("X-Balance-USD"))
sys.exit(0 if m.ok and c.ok else 1)

Mã thoát giúp bạn dễ dàng đưa vào kiểm tra triển khai. Đối với các tham số vượt quá mức tối thiểu này, tài liệu API liệt kê mọi thứ mà endpoint chấp nhận.

Hỏi đáp

Việc kiểm tra khóa API có tốn tiền không?

Việc gọi danh sách các mô hình là miễn phí. Một yêu cầu trò chuyện ngắn với max_tokens thấp chỉ tốn vài phần triệu đô la với giá $0,15 cho mỗi 1 triệu token đầu vào và $0,50 cho mỗi 1 triệu token đầu ra. Các yêu cầu thất bại không bị tính phí.

Làm thế nào để tôi kiểm tra khóa mà không cần thẻ?

Yêu cầu tín dụng dùng thử $0,50 trên trang khóa API sau khi đăng ký. Việc này không cần thẻ và tín dụng có hiệu lực trong 7 ngày, mỗi người một lần.

Tại sao một khóa hợp lệ lại trả về 429 ngay lập tức?

Bạn có thể đã chạm đến giới hạn đồng thời hoặc giới hạn mỗi phút. Khóa dùng thử cho phép 2 yêu cầu đồng thời và 60 yêu cầu mỗi phút; khóa đầy đủ cho phép 8 và 300. Hãy kiểm tra mã lỗi, sau đó giảm tốc độ hoặc thử lại sau vài giây.

Tôi có thể kiểm tra khóa trong Postman hoặc một ứng dụng thay vì curl không?

Có. Bất kỳ máy khách tương thích OpenAI nào cũng hoạt động: hãy đặt base URL thành https://api.aiapisource.com/v1, dán khóa dưới dạng token Bearer và sử dụng mô hình uncensored.

Khóa của bạn chỉ còn một bước nữa là xong

Tạo tài khoản, sao chép khóa, thay đổi URL cơ sở. Đó là toàn bộ thiết lập.

Lấy khóa API