기본 URL
누구나 헷갈리는 설정 하나: 각 클라이언트가 요구하는 URL과 /v1 접미사 포함 여부.
연동 실패는 거의 모두 기본 URL 설정 오류에서 비롯됩니다. 이 페이지에서 정확히 무엇을 설정해야 하는지 확인할 수 있습니다.
설정 규칙
| 클라이언트 | 설정할 기본 URL | 호출되는 경로 |
|---|---|---|
| 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 |
Anthropic 클라이언트: 제외
/v1. OpenAI 클라이언트: 포함 /v1. Anthropic SDK는 /v1/messages 을 지정한 기본 URL 뒤에 추가하며, OpenAI SDK는 다음만 추가합니다: /chat/completions. 다음을 추가하면: /v1 Anthropic 기본 URL에 추가한 경우 요청이 다음 경로로 전송됩니다: /v1/v1/messages, 이 경로는 404 오류를 반환합니다.어떤 설정 오류인지 확인하는 방법
| 다음이 표시되고: | 의미 |
|---|---|
404 경로에 다음이 포함된 경우: /v1/v1/ | 다음을 추가한 것입니다: /v1 Anthropic 방식의 기본 URL에 추가한 것입니다. 제거하세요. |
404 적용 대상: /chat/completions 다음이 없는 경우: /v1 | 다음을 누락한 것입니다: /v1 OpenAI 방식의 기본 URL에서 누락한 것입니다. 추가하세요. |
404 적용 대상: /v1/chat/completions Anthropic 도구에서 발생하는 경우 | 이 도구는 Chat Completions가 아닌 Messages를 사용합니다. Anthropic 기본 URL과 엔드포인트를 사용하세요. |
| 연결은 되지만 모든 호출에서 401 오류가 발생함 | URL은 맞지만 해당 형식에 맞는 인증 헤더가 아닙니다. 다음을 참조하세요: 인증. |
SDK 없이 검증하기
프레임워크를 의심하기 전에 URL과 키가 올바른지 확인하는 가장 빠른 방법입니다:
"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 은 URL과 키가 모두 올바르며, 남은 문제는 클라이언트 설정에 있다는 뜻입니다.