KONG API AI Tài liệu Bắt đầu miễn phí

Nhà phát triển

API

Các địa chỉ API của KONG API AI, cách xác thực, các header riêng (Idempotency-Key, X-Router-Session, X-GW-Customer) và cách tra cứu một yêu cầu.

Địa chỉ gốc và xác thực

text
https://kongapiai.com/v1

Gửi khoá trong header Authorization: Bearer gw_live_…. Các công cụ dùng định dạng Anthropic có thể gửi khoá trong header x-api-key.

Các địa chỉ

Phương thứcĐịa chỉDùng để
POST/v1/chat/completionsHội thoại, định dạng OpenAI Chat Completions
POST/v1/responsesĐịnh dạng OpenAI Responses
POST/v1/messagesĐịnh dạng Anthropic Messages
GET/v1/modelsCác model mà khoá này được dùng
GET/v1/keyThông tin của chính khoá này: hạn mức, model, trạng thái
GET/v1/requests/{id}Trạng thái của một yêu cầu
DELETE/v1/requests/{id}Yêu cầu huỷ một yêu cầu đang chạy

Idempotency-Key

Gửi header Idempotency-Key với một mã duy nhất cho mỗi yêu cầu, ví dụ một UUID.

  • Gửi lại cùng mã khi yêu cầu đã được nhận: API trả về 409 với mã duplicate_request và request_id của yêu cầu ban đầu. Nhà cung cấp không bị gọi lần hai.
  • Gửi lại cùng mã với nội dung khác: API trả về 409 với mã idempotency_conflict.

Nếu bạn không gửi header này, KONG API AI tự sinh một mã, và mỗi lần gửi lại được coi là một yêu cầu mới.

X-Request-ID

Mỗi câu trả lời có header X-Request-ID. Hãy ghi lại mã này trong log của bạn. Dùng nó để tra cứu:

Terminal
curl https://kongapiai.com/v1/requests/REQUEST_ID \
  -H "Authorization: Bearer gw_live_…"

X-Router-Session

Gửi header X-Router-Session kèm một mã cố định bất kỳ, ví dụ mã cuộc hội thoại. Các yêu cầu có cùng mã sẽ dùng cùng một nguồn AI. Việc này giúp một cuộc hội thoại dài không bị đổi nguồn giữa chừng.

X-GW-Customer

Dùng khi một khoá phục vụ nhiều khách hàng của bạn. Xem Tính mức dùng theo khách hàng.

Giới hạn kích thước

Nội dung một yêu cầu tối đa 2 MB. Lớn hơn, API trả về 413 với mã body_too_large.