Changelog

Trang này ghi các thay đổi có thể ảnh hưởng đến integration. Developer API v1 hiện ở giai đoạn Preview.

2026-10-04

Breaking

POST /v1/files nhận PNG, JPEG, GIF, WebP, PDF, DOCX, XLSX, CSV và TXT. Các loại ảnh khác (kể cả SVG và HEIC) giờ trả UNSUPPORTED_FILE_TYPE.
Nội dung file phải khớp với loại file: file có các byte đầu không khớp với phần mở rộng sẽ trả UNSUPPORTED_FILE_TYPE.

Behavioral

Loại file được xác định theo phần mở rộng trong tên file, không theo Content-Type khai báo. File .csv gửi với application/vnd.ms-excel vẫn được nhận là CSV. File không có phần mở rộng vẫn dùng Content-Type.

Breaking

API key giờ kết thúc bằng checksum (ac_<public-id>_<secret><checksum>). Các key tạo trước ngày này đã bị thu hồi; hãy tạo key thay thế trong Admin Panel.
Replay một request idempotent đã hoàn tất trả 200 kèm Idempotent-Replayed: true thay vì 202.
Trang tin nhắn trả object, first_id và last_id; đã bỏ next_after. Truyền last_id vào after.
RateLimit-Reset giờ là số giây đến khi window reset, không còn là Unix timestamp.

Behavioral

Rate limit áp dụng theo trợ lý, dùng chung cho mọi key, với sliding window một phút. Plan Enterprise có giới hạn cao hơn.
Mọi lỗi /v1, kể cả lỗi xác thực và validation, trả đúng cấu trúc đã công bố với code trong registry và retryable. Event error của SSE dùng cùng bộ mã.
Idempotency-Key tối đa 255 ký tự.

Additive

GET /v1/responses/{response_id} lấy lại response đã hoàn tất.
DELETE /v1/users/{external_user_id} với scope mới users:delete xóa dữ liệu của end user.
Rotate có thể giữ key cũ hoạt động thêm 1 giờ, 24 giờ hoặc 7 ngày.
Mã lỗi mới: IP_NOT_ALLOWED, FILE_UPLOAD_DISABLED, VOICE_DISABLED, ACTOR_CONFLICT, MESSAGE_NOT_FOUND, FILE_NOT_FOUND, RESPONSE_NOT_FOUND, INVALID_CURSOR, VALIDATION_ERROR, UNSUPPORTED_FILE_TYPE, FILE_TOO_LARGE, CONTEXT_TOO_LARGE, RATE_LIMIT_UNAVAILABLE, INTERNAL_SERVER_ERROR.

Breaking: thay đổi khiến client đang đúng contract phải sửa code.
Behavioral: contract không đổi nhưng timing, ordering, limits hoặc retry behavior thay đổi đáng kể.
Additive: thêm optional field, event hoặc operation tương thích ngược.
Documentation: chỉ làm rõ nội dung, không đổi contract runtime.