Base URL은 어떻게 입력하나요

Base URL은 클라이언트 또는 SDK가 API를 요청할 때 사용하는 기본 주소입니다.

쉽게 말해 “요청을 어디로 보낼지”를 지정하는 주소라고 이해하면 됩니다. 이 주소를 잘못 입력하면 API Key가 올바르더라도 요청은 실패합니다.

MoleAPI에서 가장 일반적으로 사용하는 입력 방식

대부분의 OpenAI 호환 인터페이스를 지원하는 도구 및 SDK에서는 다음 값을 직접 입력하는 것을 권장합니다.

https://api.moleapi.com/v1

초보자라면 가장 먼저 기억해야 할 설정입니다.

왜 많은 경우 /v1을 포함해야 하나요

많은 SDK나 클라이언트는 사용자가 입력한 Base URL 뒤에 아래와 같은 경로를 자동으로 이어 붙입니다.

• /chat/completions
• /responses
• /embeddings
• /images/generations

따라서 다음과 같이 입력하면:

https://api.moleapi.com/v1

최종적으로 조합되는 전체 주소는 보통 다음과 같습니다.

https://api.moleapi.com/v1/chat/completions

이 경우가 일반적으로 올바른 설정입니다.

언제 /v1 없이 입력할 수 있나요

일부 도구는 “사이트 루트 주소”를 입력받고, 내부적으로 /v1을 따로 붙이도록 되어 있습니다.

이 경우에는 다음 값을 시도할 수 있습니다.

https://api.moleapi.com

하지만 확실하지 않다면 우선 https://api.moleapi.com/v1부터 시도하세요.

가장 흔한 잘못된 입력 방식

오류 1: OpenAI 공식 주소를 입력한 경우

예:

https://api.openai.com/v1

이렇게 하면 요청이 MoleAPI를 거치지 않고 OpenAI 공식 서버로 직접 전송됩니다.

오류 2: /v1을 빠뜨린 경우

일부 애플리케이션은 /v1까지 포함해서 입력해야 합니다. 만약 다음처럼만 입력하면:

https://api.moleapi.com

다음과 같은 문제가 발생할 수 있습니다.

• 404
• Invalid URL
• 인터페이스가 존재하지 않음
• 요청 경로 조합 오류

오류 3: 전체 API 경로를 Base URL로 입력한 경우

예를 들어 다음처럼 입력하는 경우입니다.

https://api.moleapi.com/v1/chat/completions

이 설정은 일반적으로 올바르지 않습니다. 많은 SDK가 뒤에 경로를 추가로 이어 붙이기 때문에 최종 URL이 잘못 조합될 수 있습니다.

특정 도구에서 전체 API 주소 입력을 명시적으로 요구하지 않는 한, Base URL은 일반적으로 다음까지만 입력해야 합니다.

https://api.moleapi.com/v1

오류 4: 복사 과정에서 공백, 중국어 문장부호 또는 잘못된 프로토콜이 포함된 경우

예:

• https//api.moleapi.com/v1
• http://api.moleapi.com/v1
• 주소 앞뒤에 공백이 포함됨
• 전각 문자가 함께 복사됨

이런 문제는 매우 흔하며, 눈으로 봐도 바로 알아차리지 못할 수 있습니다.

올바르게 입력했는지 빠르게 확인하는 방법

다음 순서대로 확인해 보세요.

1. Base URL이 https://api.moleapi.com/v1인지
2. API Key가 MoleAPI 콘솔에서 생성한 sk-...인지
3. 모델명이 현재 Group에서 사용 가능한 모델인지
4. 클라이언트가 OpenAI 호환 인터페이스를 지원하는지

이 항목들이 모두 문제없는데도 계속 실패한다면, 그다음에는 더 자세한 로그와 오류 코드를 확인하세요.

일반적인 사용 시나리오별 권장 사항

시나리오 1: 서드파티 클라이언트 연동

Chatbox, NextChat, 沉浸式翻译, Cherry Studio 같은 도구의 경우:

• 우선 https://api.moleapi.com/v1을 입력하세요
• API Key에는 본인의 sk-...를 입력하세요

시나리오 2: OpenAI SDK 연동

Node.js, Python 또는 기타 OpenAI 호환 SDK를 사용하는 경우에도 일반적으로 다음 값을 우선 사용합니다.

https://api.moleapi.com/v1

시나리오 3: 오류 메시지에 api.openai.com이 표시되는 경우

이 경우는 보통 요청이 MoleAPI로 전달되지 않고 여전히 OpenAI 공식 주소로 전송되고 있음을 의미합니다. 먼저 Base URL이 올바르게 변경되었는지 확인하세요.

다음으로 읽어볼 내용

• API Key란 무엇인가요
• API Key를 생성하는 방법
• Group이란 무엇인가요