Những gì bạn sẽ xây dựng
Bạn sẽ gửi một yêu cầu đếnPOST /v1/messages, in ra văn bản phản hồi từ Claude, và giữ cho đoạn mã sẵn sàng để dùng với Anthropic SDK hoặc HTTP trực tiếp.
Điều kiện tiên quyết
- Một API key CometAPI được lưu trong
COMETAPI_KEY - Một model ID Claude từ trang Models
curl, Python 3.10+, hoặc Node.js 18+
API key, base URL, xác thực
Sử dụng endpoint Messages tương thích với Anthropic thông qua CometAPI:x-api-key và header phiên bản API của Anthropic:
Ví dụ mã
Sử dụng các tab bên dưới để xem các ví dụ có thể sao chép cho cURL, Python và Node.js.Giải thích luồng
Các yêu cầu Claude Messages mặc định là đồng bộ. API trả về một đối tượng message trong một phản hồi HTTP duy nhất, và ứng dụng của bạn đọc khối nội dung văn bản đầu tiên. Sử dụng route này khi bạn cần các dạng yêu cầu dành riêng cho Claude như mảng message của Anthropic, extended thinking, prompt caching hoặc tool use. Nếu ứng dụng của bạn đã sử dụng Anthropic SDK chính thức, hãy đặt base URL của SDK thànhhttps://api.cometapi.com và giữ nguyên dạng yêu cầu của Messages API.
Các tham số phổ biến
Khắc phục sự cố / FAQ
Yêu cầu trả về 401
Yêu cầu trả về 401
Xác nhận rằng
COMETAPI_KEY được đặt trong cùng shell hoặc runtime gửi yêu cầu. Không dán key thật vào các tệp mã nguồn.SDK vẫn gọi trực tiếp đến Anthropic
SDK vẫn gọi trực tiếp đến Anthropic
Xác nhận rằng SDK client đặt
base_url trong Python hoặc baseURL trong Node.js thành https://api.cometapi.com.Tôi nên dùng model nào
Tôi nên dùng model nào
Sử dụng một model ID Claude khả dụng cho tài khoản của bạn. Hướng dẫn nhanh này không hardcode một model Claude vì mức độ khả dụng thay đổi theo tài khoản và họ model.
Các bước tiếp theo
- Sử dụng tài liệu tham khảo Anthropic Messages API để xem đầy đủ các trường yêu cầu và phản hồi.
- Kiểm tra mức độ khả dụng của model trong Models.
- Cấu hình các phiên coding cục bộ với hướng dẫn tích hợp Claude Code.
- Xem lại hành vi retry trong Mã lỗi và chiến lược retry.