Opus 5.5: HTTP 200 chưa bảo đảm đầu ra JSON dùng được ngay
Anthropic nêu các ngoại lệ của đầu ra có cấu trúc, từ từ chối an toàn đến hết ngân sách token và khác chữ hoa. Ứng dụng cần đọc lý do dừng và kiểm tra giá trị trước khi xử lý tiếp.
Nhận mã HTTP 200 từ Opus 5.5 chưa đủ để ứng dụng coi một bản trả lời có cấu trúc là hoàn chỉnh. Tài liệu Anthropic nêu trường hợp mô hình từ chối vì an toàn: phản hồi vẫn có mã 200, token đã sinh vẫn bị tính phí và nội dung có thể không theo lược đồ.
Ứng dụng cần đọc stop_reason, không chỉ kiểm tra kết nối thành công. Giá trị refusal cho biết từ chối; max_tokens cho biết đầu ra đã chạm giới hạn và có thể bị cắt. Hướng dẫn đề xuất tăng giới hạn khi cần lấy đầy đủ đầu ra bị cắt.
Một ngoại lệ khác là chữ hoa, chữ thường trong các giá trị enum và const dạng chuỗi. Tài liệu nói kết quả có thể khác cách viết hoa mà không phát sinh lỗi hay lý do dừng đặc biệt. Điều này áp dụng cho cả đầu ra JSON lẫn công cụ ở chế độ strict.
Với phần mềm phân loại văn bản tiếng Việt, nên tránh nhãn chỉ khác nhau ở chữ hoa và chuẩn hóa cách so sánh theo hướng dẫn. Kiểm tra trạng thái dừng và kiểm tra giá trị là hai bước. Bài viết mô tả hợp đồng API, không khẳng định các lỗi này xuất hiện với tần suất cụ thể.
프리즘코리아 편집국 > Linh Nguyễn
