URL cơ sở
Thiết lập khiến mọi người đều vướng mắc: URL mà từng ứng dụng khách yêu cầu, có và không có hậu tố /v1.
Hầu hết các trường hợp tích hợp thất bại đều do lỗi URL cơ sở. Trang này là tài liệu tham khảo giúp bạn biết chính xác cần thiết lập gì.
Quy tắc
| Ứng dụng khách | Đặt URL cơ sở thành | Sau đó ứng dụng gọi |
|---|---|---|
| Anthropic SDK (Python / TS) | https://aiprimetech.io | https://aiprimetech.io/v1/messages |
| Claude Code | https://aiprimetech.io | https://aiprimetech.io/v1/messages |
| OpenAI SDK (Python / TS) | https://aiprimetech.io/v1 | https://aiprimetech.io/v1/chat/completions |
| LangChain / LiteLLM / Cursor | https://aiprimetech.io/v1 | https://aiprimetech.io/v1/chat/completions |
Ứng dụng khách Anthropic: không có
/v1. Ứng dụng khách OpenAI: có /v1. Anthropic SDK nối thêm /v1/messages vào bất kỳ URL cơ sở nào bạn cung cấp; OpenAI SDK chỉ nối thêm /chat/completions. Thêm /v1 vào URL cơ sở Anthropic sẽ tạo ra các yêu cầu tới /v1/v1/messages, dẫn đến lỗi 404.Cách xác định bạn đã mắc lỗi nào
| Bạn thấy | Ý nghĩa |
|---|---|
404 và đường dẫn chứa /v1/v1/ | Bạn đã thêm /v1 vào URL cơ sở theo kiểu Anthropic. Hãy bỏ phần đó. |
404 trên /chat/completions mà không có /v1 | Bạn đã bỏ sót /v1 trong URL cơ sở theo kiểu OpenAI. Hãy thêm phần đó. |
404 trên /v1/chat/completions từ một công cụ Anthropic | Công cụ sử dụng Messages, không phải Chat Completions. Hãy dùng URL cơ sở và điểm cuối Anthropic. |
| Kết nối hoạt động nhưng mọi lệnh gọi đều trả về lỗi 401 | URL đúng nhưng tiêu đề xác thực không phù hợp với định dạng đó. Xem Xác thực. |
Xác minh mà không dùng SDK
Đây là cách nhanh nhất để xác nhận URL và khóa đều đúng trước khi cho rằng lỗi nằm ở framework của bạn:
"c"># should return JSON with a "data" array of model ids
curl -s -o /dev/null -w "%{http_code}\n" https://aiprimetech.io/v1/models \
-H "Authorization: Bearer $CLAUDEAPIKEY"A 200 có nghĩa là cả URL và khóa đều đúng, và mọi vấn đề còn lại đều nằm ở cấu hình ứng dụng khách của bạn.