Messages API căn bản

Mục tiêu: Hiểu cấu trúc request/response; Xử lý stop_reason; Retry đúng cách.

Một endpoint cho mọi thứ

Mọi thứ đi qua POST /v1/messages: model, max_tokens, system (top-level), messages (lượt user/assistant), tools. API stateless — bạn tự gửi lại lịch sử mỗi lượt.

stop_reason

- end_turn — xong tự nhiên. - max_tokens — bị cắt, đầu ra có thể dang dở. - tool_use — Claude muốn gọi tool. - pause_turn — server tool tạm dừng lượt dài, gửi lại để tiếp tục. - refusal — bị từ chối. Luôn kiểm tra stop_reason trước khi dùng nội dung.

Lỗi và retry

429 (rate limit), 5xx, lỗi mạng → retry với exponential backoff, tôn trọng retry-after. 400/401/404 → sửa request, không retry. SDK chính thức đã tự retry mặc định 2 lần. Dùng streaming cho UI chat và cho request có max_tokens lớn.