Skip to main content

Kiểm tra chi tiêu (Spend Checking)

GET /key/info​

Lấy thông tin chi tiết về API key và mức độ sử dụng hiện tại.

Headers​

AuthorizationstringRequired

Bearer token với API key của bạn. Format: Bearer <your_api_key>

acceptstring

Loại nội dung phản hồi mong muốn. Mặc định: application/json

Cấu trúc Phản hồi (Response Body)​

API sẽ trả về một đối tượng JSON với thông tin chi tiết về API key và mức sử dụng.

Đối tượng Root​

keystring

Mã định danh duy nhất của API key.

infoobject

Đối tượng chứa thông tin chi tiết về API key.

Đối tượng info​

key_namestring

Tên hiển thị của API key (có thể được che một phần).

key_aliasstring

Tên bí danh của API key để dễ nhận diện.

spendnumber

Tổng số tiền đã chi tiêu bằng API key này (tính bằng USD).

max_budgetnumber

Ngân sách tối đa được phép cho API key này. null nếu không giới hạn.

max_parallel_requestsnumber

Số lượng yêu cầu đồng thời tối đa được phép cho API key này. Giới hạn này kiểm soát số lượng request có thể xử lý song song cùng một lúc. Trường hợp vượt quá giới hạn này, các yêu cầu bổ sung sẽ bị từ chối trả lỗi 429 (Too Many Requests).

metadataobject

Metadata tùy chỉnh được gán cho API key.

metadata.model_rpm_limitobject

Giới hạn số lượng request per minute (RPM) cho từng mô hình cụ thể. Đây là giới hạn tần suất gọi API theo phút cho mỗi model. Xem thêm Google AI Rate Limits để biết chi tiết về các giới hạn.

metadata.model_tpm_limitobject

Giới hạn số lượng token per minute (TPM) cho từng mô hình cụ thể. Đây là tổng số token (input) có thể xử lý trong một phút cho mỗi model. Xem thêm Google AI Rate Limits để biết chi tiết về quota và giới hạn token.

tpm_limitnumber

Giới hạn tokens per minute chung cho API Key. null nếu không giới hạn.

rpm_limitnumber

Giới hạn requests per minute chung cho API Key. null nếu không giới hạn.

expiresstring

Thời gian hết hạn của API key. null nếu không hết hạn.

modelsarray

Danh sách các mô hình được phép sử dụng với API key này.

user_idstring

ID của người dùng sở hữu API key.

team_idstring

ID của nhóm sở hữu API key.

blockedboolean

Trạng thái khóa của API key. true nếu bị khóa, null hoặc false nếu hoạt động.

budget_durationstring

Khoảng thời gian tính ngân sách (ví dụ: 1d, 1w, 1m). null nếu không có chu kỳ.

budget_reset_atstring

Thời điểm reset ngân sách tiếp theo (ISO 8601). null nếu không có chu kỳ.

model_spendobject

Chi tiêu chi tiết theo từng mô hình.

model_max_budgetobject

Ngân sách tối đa theo từng mô hình.

created_atstring

Thời gian tạo API key (định dạng ISO 8601).

updated_atstring

Thời gian cập nhật cuối cùng của API key (định dạng ISO 8601).

permissionsobject

Các quyền hạn được cấp cho API key.

curl -X 'GET' \
'https://api.thucchien.ai/key/info' \
-H 'accept: application/json' \
-H 'Authorization: Bearer '
Example Response
{
  "key": "b1ba143c164e66c912677762a7a0b0a2d5bd686b59999823e5fd2ccb3c71731f",
  "info": {
    "key_name": "sk-...gHQK",
    "key_alias": "official-01@key",
    "soft_budget_cooldown": false,
    "spend": 0.5,
    "expires": null,
    "models": [
      "all-team-models"
    ],
    "aliases": {},
    "config": {},
    "user_id": "f52b3ad4-986e-4c62-9bbd-79e80e221d0b",
    "team_id": "5b4c20e9-1ff9-4ac0-bec6-0b00a25a31ab",
    "permissions": {},
    "max_parallel_requests": 200,
    "metadata": {
      "model_rpm_limit": {
        "imagen-4": 20,
        "gemini-2.5-pro": 2000,
        "gemini-2.5-flash": 10000,
        "veo-2.0-generate-001": 2,
        "veo-2.0-generate-exp": 2,
        "veo-3.0-generate-001": 10,
        "gemini-2.5-flash-image": 5000,
        "veo-2.0-generate-preview": 2,
        "veo-3.1-generate-preview": 10,
        "veo-3.0-fast-generate-001": 10,
        "gemini-2.5-pro-preview-tts": 100,
        "gemini-2.5-flash-preview-tts": 1000,
        "veo-3.1-fast-generate-preview": 10,
        "gemini-2.5-flash-image-preview": 5000
      },
      "model_tpm_limit": {
        "gemini-2.5-pro": 8000000,
        "gemini-2.5-flash": 8000000,
        "gemini-2.5-flash-image": 5000000,
        "gemini-2.5-pro-preview-tts": 1000000,
        "gemini-2.5-flash-preview-tts": 1000000,
        "gemini-2.5-flash-image-preview": 5000000
      }
    },
    "blocked": null,
    "tpm_limit": 800000,
    "rpm_limit": 200,
    "max_budget": 50,
    "budget_duration": null,
    "budget_reset_at": null,
    "allowed_cache_controls": [],
    "allowed_routes": [],
    "model_spend": {},
    "model_max_budget": {},
    "budget_id": null,
    "organization_id": null,
    "object_permission_id": null,
    "created_at": "2025-10-21T07:12:36.122000+00:00",
    "created_by": "default_user_id",
    "updated_at": "2025-10-21T07:24:39.726000+00:00",
    "updated_by": "default_user_id",
    "rotation_count": 0,
    "auto_rotate": false,
    "rotation_interval": null,
    "last_rotation_at": null,
    "key_rotation_at": null,
    "litellm_budget_table": null,
    "litellm_organization_table": null,
    "object_permission": null
  }
}