Chat (contract gốc)

Endpoint public đầu tiên của ApiLux, response gọn hơn. Được giữ nguyên vĩnh viễn cho các tích hợp cũ — dự án mới nên dùng /chat/completions.

Đã triển khaiKhả dụng hay không còn phụ thuộc model bạn chọn đã được bật và có giá trong ApiLux.

Request

POST/chat

Cần header Authorization: Bearer apl_...

Field	Kiểu	Mô tả
`model`bắt buộc	string	Public model ID.
`messages`bắt buộc	Message[]	Mảng `{ role, content }`.

Response

Field	Kiểu	Mô tả
`reply`bắt buộc	string	Nội dung model sinh ra.
`tokensUsed`bắt buộc	integer	Tổng token đã dùng.
`creditCharged`bắt buộc	integer	Số credit đã trừ.
`balanceAfter`bắt buộc	integer	Số dư sau khi trừ.

Tính tiền

Giống /chat/completions.

Ví dụ

cURL

curl https://apilux.net/api/v1/chat \
  -H "Authorization: Bearer apl_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "messages": [{ "role": "user", "content": "Xin chào" }]
  }'

Lỗi

HTTP	Mã	Ý nghĩa
400	`invalid_request`	Body không hợp lệ (thiếu field, sai kiểu, giá trị ngoài phạm vi).
401	`auth_missing_or_malformed`	Thiếu header `Authorization` hoặc sai định dạng. Phải là `Bearer apl_...`.
401	`auth_invalid`	API key không tồn tại.
401	`auth_revoked`	API key đã bị thu hồi.
401	`auth_expired`	API key đã hết hạn.
400	`unknown_model`	Model không tồn tại trong ApiLux.
400	`capability_not_supported`	Model có tồn tại nhưng không dùng được ở endpoint này (ví dụ dùng model text cho endpoint ảnh).
503	`pricing_not_configured`	Model đã có route nhưng chưa được cấu hình giá trong ApiLux. Đây là trạng thái phía chúng tôi, không phải lỗi của bạn.
503	`model_disabled`	Model đang bị tắt.
503	`model_temporarily_unavailable`	Model đang bật và có giá, nhưng nhà cung cấp phía sau hiện không phục vụ nó. Đây là trạng thái tạm thời và có thể tự hết — model sẽ xuất hiện lại trong `GET /v1/models` khi nhà cung cấp có nó trở lại. Bạn không bị trừ tiền và không có lời gọi nào tới nhà cung cấp.
402	`insufficient_balance`	Số dư ví không đủ để thực hiện request.
429	`api_key_limit_exceeded`	API key này đã chạm hạn mức bạn tự cấu hình. Ví vẫn còn tiền — chỉ key này không được tiêu thêm cho tới khi chu kỳ reset. Response kèm `limit_type` (`spending` \| `requests` \| `tokens`) và `period` (`daily` \| `monthly` \| `lifetime`). Hạn mức token của endpoint text được tính theo usage thực tế nên tổng có thể vượt tối đa một request.
503	`api_key_quota_reconciliation_required`	Một request text trước đó của chính key này chưa được đối soát xong. Thường gặp nhất: nhà cung cấp trả kết quả thành công nhưng không kèm usage token, nên hạn mức token của kỳ đó không còn đáng tin và ApiLux dừng lại thay vì để hạn mức bị vượt trong im lặng. Thử lại sẽ không qua được cho tới khi việc đó xong — hãy liên hệ hỗ trợ. Bạn không bị trừ tiền cho request bị chặn, không có lời gọi nào tới nhà cung cấp, và endpoint ảnh/video không bị ảnh hưởng.
502	`upstream_error`	Nhà cung cấp mô hình lỗi. Không bị trừ tiền.
504	`upstream_timeout`	Nhà cung cấp không phản hồi kịp. Không bị trừ tiền.
429	`upstream_rate_limited`	Bị giới hạn tốc độ. Thử lại sau vài giây.

Ghi chú

Ở endpoint này, model đang bị tắt trả về unknown_model (400) thay vì model_disabled (503) — hành vi cũ được giữ nguyên có chủ đích.