Source: https://aiprimetech.io/ko/docs/getting-started/base-urls/

[홈](/ko/) / [문서](/ko/docs/) / 기본 URL 

# 기본 URL 

누구나 헷갈리는 설정 하나: 각 클라이언트가 요구하는 URL과 /v1 접미사 포함 여부. 

 페이지 복사 [ Markdown으로 보기](/ko/docs/getting-started/base-urls.md) [ ChatGPT에 질문](https://chatgpt.com/?q=Read%20https%3A//aiprimetech.io/docs/getting-started/base-urls.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) [ Claude에서 질문](https://claude.ai/new?q=Read%20https%3A//aiprimetech.io/docs/getting-started/base-urls.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.)   

연동 실패는 거의 모두 기본 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은 맞지만 해당 형식에 맞는 인증 헤더가 아닙니다. 다음을 참조하세요: [인증](/ko/docs/getting-started/authentication/). 

## SDK 없이 검증하기 

프레임워크를 의심하기 전에 URL과 키가 올바른지 확인하는 가장 빠른 방법입니다: 

```
Copy"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과 키가 모두 올바르며, 남은 문제는 클라이언트 설정에 있다는 뜻입니다. 

[인증헤더와 환경 변수](/ko/docs/getting-started/authentication/)[문제 해결증상 중심 디버깅](/ko/docs/guides/troubleshooting/)[개요엔드포인트 참조](/ko/docs/api-reference/overview/) 

[이전모델 및 키 그룹](/ko/docs/getting-started/models/)[다음첫 요청 설명](/ko/docs/getting-started/first-request/)