> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 기본 URL을 CometAPI로 변경하기

> base URL을 https://api.cometapi.com/v1로 설정하여 OpenAI 호환 클라이언트 또는 직접 HTTP 요청을 CometAPI로 라우팅합니다.

OpenAI 호환 SDK 또는 엔드포인트를 사용할 때 base URL을 `https://api.cometapi.com/v1`로 변경하세요. API 레퍼런스의 엔드포인트 경로와 요청 본문 형식은 그대로 유지한 다음, CometAPI API 키를 사용하면 됩니다.

## 올바른 base URL 사용하기

OpenAI 호환 base URL은 다음과 같습니다:

```text theme={null}
https://api.cometapi.com/v1
```

## Python base URL

다음 Python 예제는 클라이언트 구성만 변경합니다:

```python theme={null}
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["COMETAPI_KEY"],
    base_url="https://api.cometapi.com/v1",
)
```

## Node.js base URL

다음 Node.js 예제는 CometAPI base URL을 설정합니다:

```javascript theme={null}
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.COMETAPI_KEY,
  baseURL: "https://api.cometapi.com/v1",
});
```

## 변경 사항 테스트하기

다음 요청은 base URL과 API 키가 정상적으로 작동하는지 확인합니다:

```bash theme={null}
curl https://api.cometapi.com/v1/chat/completions \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-id",
    "messages": [
      {
        "role": "user",
        "content": "Say hello in one sentence."
      }
    ]
  }'
```

성공적인 응답은 채팅 완성 객체를 반환합니다:

```json theme={null}
{
  "object": "chat.completion",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "Hello from CometAPI."
      }
    }
  ]
}
```

## 일반적인 오류

| 오류                           | 해결 방법                                                                    |
| ---------------------------- | ------------------------------------------------------------------------ |
| `404`                        | OpenAI 호환 엔드포인트용 base URL에 `/v1`을 포함하세요.                                 |
| JSON 대신 HTML                 | HTTP 클라이언트가 잘못된 경로에서 리디렉션을 따라갔는지 확인하세요.                                  |
| `401`                        | `Authorization: Bearer $COMETAPI_KEY`를 사용하세요.                            |
| Management API auth mismatch | API 키 관리 엔드포인트는 bearer model-request auth가 아니라 personal access 값을 사용합니다. |

## 관련 링크

* [CometAPI 빠른 시작](/ko/overview/quick-start)
* [중요 가이드라인](/ko/overview/important-guidelines)
* [오류 코드 및 처리](/ko/errors/error-codes-handling)
* [모델 페이지](/ko/overview/models)
* [모델 디렉터리](https://www.cometapi.com/models/)
* [요금](https://www.cometapi.com/pricing/)

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "TechArticle",
        "@id": "https://apidoc.cometapi.com/guides/change-base-url-to-cometapi",
        "headline": "CometAPI로 base URL을 어떻게 변경하나요?",
        "description": "base URL을 https://api.cometapi.com/v1로 설정하여 OpenAI 호환 클라이언트 또는 직접 HTTP 요청을 CometAPI로 변경합니다.",
        "url": "https://apidoc.cometapi.com/guides/change-base-url-to-cometapi",
        "author": {
          "@type": "Organization",
          "name": "CometAPI"
        },
        "publisher": {
          "@type": "Organization",
          "name": "CometAPI",
          "url": "https://www.cometapi.com"
        }
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI 문서",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "가이드",
            "item": "https://apidoc.cometapi.com/guides/use-cometapi-with-openai-sdk"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "CometAPI로 base URL을 어떻게 변경하나요?",
            "item": "https://apidoc.cometapi.com/guides/change-base-url-to-cometapi"
          }
        ]
      }
    ]
    }
    `}
</script>