> ## 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.

# CometAPI 시작하기: API 키를 만들고 첫 호출 보내기

> API 키를 생성하고, base URL을 설정하고, 첫 번째 curl, Python 또는 Node.js API 요청을 보내며 CometAPI를 시작해 보세요.

## 계정 및 API 키 만들기

API를 호출하기 전에 CometAPI 계정과 API 키를 만드세요.

<Steps>
  <Step title="로그인하거나 계정 만들기">
    [CometAPI 로그인 페이지](https://www.cometapi.com/console/login)를 여세요. Google로 계속, GitHub로 계속, 또는 이메일이나 사용자 이름을 입력하세요. 계정이 없다면 이 페이지에서 계정 생성을 완료하세요.

    <Frame>
      <img src="https://mintcdn.com/cometapi/BtE3Lagaukxd3efj/images/overview/cometapi-console-login.png?fit=max&auto=format&n=BtE3Lagaukxd3efj&q=85&s=988bee0055bf1ce2552a8d877a48a97d" alt="Google, GitHub 및 이메일 로그인 옵션이 있는 CometAPI 로그인 페이지" width="1280" height="720" data-path="images/overview/cometapi-console-login.png" />
    </Frame>
  </Step>

  <Step title="API 키 열기">
    로그인한 후 [API 키 페이지](https://www.cometapi.com/console/token)를 여세요. 대시보드 사이드바에서 **API Keys**를 선택해도 됩니다.
  </Step>

  <Step title="API 키 만들기">
    **Create API Key**를 클릭하고, `local-test`와 같이 알아보기 쉬운 이름을 입력한 다음, 지출 한도를 설정하려는 경우가 아니라면 첫 번째 테스트를 위해 **Unlimited Quota**를 활성화된 상태로 유지하세요. **Create**를 클릭하세요.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/overview/810968_364191.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=aef81a83f29f8eb16655ed4060425f50" alt="Create API Key 버튼과 생성 대화상자가 강조 표시된 CometAPI API 키 페이지" width="3824" height="1892" data-path="images/overview/810968_364191.png" />
    </Frame>
  </Step>

  <Step title="API 키 복사하기">
    **Key** 열에서 복사 버튼을 클릭하세요. 복사한 키는 서버 측 환경 변수 또는 로컬 `.env` 파일에 저장하세요. 실제 API 키를 공개 저장소, 프런트엔드 코드, 스크린샷 또는 지원 티켓에 붙여넣지 마세요.

    <Frame>
      <img src="https://mintcdn.com/cometapi/HhtmQffktazbxUvS/images/overview/810968_364193.png?fit=max&auto=format&n=HhtmQffktazbxUvS&q=85&s=d893f659267150d0faf45f99eb5dffc1" alt="마스킹된 API 키에 대해 복사 버튼이 강조 표시된 CometAPI API 키 테이블" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>
</Steps>

요청 예시는 환경에서 `COMETAPI_KEY`를 읽습니다.

## API 키를 로컬에 저장하기

로컬 테스트를 위해 API 키를 환경 변수로 내보내세요:

```bash theme={null}
read -rsp "CometAPI API key: " COMETAPI_KEY
printf '\n'
export COMETAPI_KEY
```

## Base URL

OpenAI 호환 SDK 및 API 호출에는 이 base URL을 사용하세요:

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

## OpenAI에서 30초 만에 전환하기

CometAPI API 키를 준비했다면, OpenAI SDK 클라이언트를 CometAPI로 전환할 때 이 두 가지 설정 차이만 적용하면 됩니다:

```diff theme={null}
- base_url="https://api.openai.com/v1"
- api_key=os.environ["OPENAI_API_KEY"]
+ base_url="https://api.cometapi.com/v1"
+ api_key=os.environ["COMETAPI_KEY"]
```

CometAPI는 일반적인 텍스트, 이미지, 오디오, 비디오 워크플로를 위해 OpenAI 호환 요청 형식을 사용합니다. 앱이 이미 OpenAI SDK를 사용하고 있다면, 먼저 base URL과 API 키를 변경하는 것부터 시작하세요.

## 첫 호출 만들기

환경에 `COMETAPI_KEY`를 설정한 후, `your-model-id`를 [Models page](/ko/overview/models)에서 현재 사용 가능한 model ID로 바꾸세요.

<CodeGroup>
  ```bash cURL 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": "Write a one-sentence bedtime story."
        }
      ]
    }'
  ```

  ```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",
  )

  completion = client.chat.completions.create(
      model="your-model-id",
      messages=[
          {
              "role": "user",
              "content": "Write a one-sentence bedtime story.",
          }
      ],
  )

  print(completion.choices[0].message.content)
  ```

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

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

  const completion = await client.chat.completions.create({
    model: "your-model-id",
    messages: [
      {
        role: "user",
        content: "Write a one-sentence bedtime story.",
      },
    ],
  });

  console.log(completion.choices[0].message.content);
  ```
</CodeGroup>

## 모델 선택하기

[Models page](/ko/overview/models)에서 model ID를 선택한 다음, 그 값을 `model` 필드에 전달하세요.

| 목표           | 시작할 위치                                                                                        |
| ------------ | --------------------------------------------------------------------------------------------- |
| 채팅 또는 일반 텍스트 | [채팅 완성](/api/text/chat)과 함께 GPT, Claude, Gemini, DeepSeek 또는 다른 채팅 모델을 사용하세요.                 |
| 코딩 및 추론      | 모델에 Responses API가 필요한 경우 [응답](/api/text/responses)과 함께 코딩 또는 추론 모델을 사용하세요.                   |
| 이미지 생성       | [Create image](/api/image/openai/images) 또는 provider별 이미지 가이드와 함께 이미지 모델을 사용하세요.              |
| 비디오 생성       | [Create video](/api/video/sora-2/create)와 같이 provider 워크플로에 맞는 비디오 API 페이지와 함께 비디오 모델을 사용하세요. |

## 다음 단계

* 요청 실패에 대해서는 [Error Codes & Handling](/ko/errors/error-codes-handling)을 참조하세요.
* 재시도 가이드는 [속도 제한 처리 방법](/api/text/chat#how-to-handle-rate-limits)을 참조하세요.
* 모델별 사용법은 [채팅 완성](/api/text/chat), [응답](/api/text/responses), [Create image](/api/image/openai/images), 또는 [Create video](/api/video/sora-2/create)에서 시작하세요.
* 과금 세부 정보는 [About Pricing](/ko/pricing/about-pricing)을 참조하세요.
* 팀 구성원을 초대하고 공유 Credits를 관리하려면 [Workspace로 팀 관리](/ko/workspace/overview)를 참조하세요.
* 도움이 필요하면 [Help Center](/ko/support/help-center)를 보거나 [CometAPI support](https://www.cometapi.com/support/)에 문의하세요.

## FAQ

<AccordionGroup>
  <Accordion title="CometAPI 계정은 어떻게 만들 수 있나요?">
    [CometAPI 로그인 페이지](https://www.cometapi.com/console/login)를 연 다음, Google로 계속, GitHub로 계속, 또는 이메일이나 사용자 이름을 입력하세요. 계정이 없다면 같은 페이지에서 계정 생성을 완료하면 됩니다.
  </Accordion>

  <Accordion title="CometAPI API 키는 어떻게 받나요?">
    CometAPI 대시보드의 [API 키 페이지](https://www.cometapi.com/console/token)를 열고, **Create API Key**를 클릭한 뒤, 이름을 입력하고, **Create**를 클릭한 다음, 생성된 API 키를 복사하세요. 예제에서는 실제 API 키 대신 `$COMETAPI_KEY`를 사용하세요.
  </Accordion>

  <Accordion title="API 키는 어디에 저장해야 하나요?">
    API 키는 서버 측 환경 변수 또는 로컬 `.env` 파일에 저장하세요. 공개 저장소에 커밋하거나, 프론트엔드 코드에 붙여넣거나, 스크린샷에 포함하거나, 지원 티켓으로 보내지 마세요.
  </Accordion>

  <Accordion title="API 호출에 사용하는 CometAPI base URL은 무엇인가요?">
    OpenAI 호환 SDK 및 `/v1/chat/completions`와 같은 엔드포인트에는 `https://api.cometapi.com/v1`를 사용하세요.
  </Accordion>

  <Accordion title="CometAPI는 OpenAI Python SDK와 함께 작동하나요?">
    네. `OpenAI` 클라이언트를 생성하고, `api_key`를 CometAPI API 키로 설정하고, `base_url`을 `https://api.cometapi.com/v1`로 설정하세요.
  </Accordion>

  <Accordion title="OpenAI에서 CometAPI로 어떻게 전환하나요?">
    base URL을 `https://api.cometapi.com/v1`로 변경하고, API 키를 CometAPI API 키로 교체한 다음, [모델 페이지](/ko/overview/models)에서 CometAPI model ID를 사용하세요.
  </Accordion>

  <Accordion title="처음에는 어떤 model ID를 사용해야 하나요?">
    사용 사례에 따라 model ID를 선택하세요. [모델 페이지](/ko/overview/models)에서 시작한 다음, 호출하려는 API 페이지에 맞는 채팅, 코딩, 이미지 또는 비디오 모델을 선택하세요.
  </Accordion>

  <Accordion title="CometAPI는 어떤 프로그래밍 언어를 지원하나요?">
    CometAPI는 HTTPS 요청을 보낼 수 있는 모든 프로그래밍 언어에서 작동합니다. 이 페이지의 curl, Python, Node.js 예제부터 시작하거나, base URL을 재정의할 수 있는 OpenAI 호환 SDK를 사용하세요.
  </Accordion>

  <Accordion title="CometAPI는 무료 체험이나 무료 API 키를 제공하나요?">
    대시보드에서 CometAPI API 키를 생성할 수 있습니다. 무료 체험 제공 여부, 무료 체험 크레딧, 청구 세부 정보를 확인하려면 [CometAPI 가격 페이지](https://www.cometapi.com/pricing/)와 [가격 정보](/ko/pricing/about-pricing)를 참고하세요.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "name": "CometAPI 빠른 시작: API 키를 만들고 첫 호출 수행하기",
        "description": "처음 사용하는 사용자를 위한 CometAPI 빠른 시작 가이드: 로그인하고, API 키를 만들고, 키를 복사하고, base URL을 설정한 다음, 첫 curl, Python 또는 Node.js API 호출을 수행합니다.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/overview/quick-start#sign-in-or-create-an-account",
            "name": "로그인하거나 계정 만들기",
            "text": "https://www.cometapi.com/console/login 을 열고 Google, GitHub 또는 이메일로 계속 진행하세요."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/overview/quick-start#open-api-keys",
            "name": "API 키 열기",
            "text": "로그인한 후 https://www.cometapi.com/console/token 을 열거나 대시보드 사이드바에서 API Keys를 선택하세요."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/overview/quick-start#create-an-api-key",
            "name": "API 키 만들기",
            "text": "Create API Key를 클릭하고, 이름을 입력하고, 할당량 설정을 선택한 다음, Create를 클릭하세요."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/overview/quick-start#copy-the-api-key",
            "name": "API 키 복사하기",
            "text": "Key 열에서 복사 버튼을 클릭하고 키를 서버 측 환경 변수 또는 로컬 .env 파일에 저장하세요."
          },
          {
            "@type": "HowToStep",
            "name": "base URL 설정하기",
            "text": "OpenAI 호환 SDK 및 API 호출의 base URL로 https://api.cometapi.com/v1 을 사용하세요."
          },
          {
            "@type": "HowToStep",
            "name": "첫 호출 수행하기",
            "text": "curl, Python 또는 Node.js로 /v1/chat/completions 를 호출하고, your-model-id를 CometAPI 모델 페이지의 현재 model ID로 교체하세요."
          }
        ]
      },
      {
        "@type": "FAQPage",
        "mainEntity": [
          {
            "@type": "Question",
            "name": "CometAPI 계정은 어떻게 만들 수 있나요?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "CometAPI 로그인 페이지를 열고 Google, GitHub 또는 이메일로 계속 진행하세요. 계정이 없다면 같은 페이지에서 계정 생성을 완료하면 됩니다."
            }
          },
          {
            "@type": "Question",
            "name": "CometAPI API 키는 어떻게 받나요?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "CometAPI 대시보드의 API 키 페이지를 열고, Create API Key를 클릭하고, 이름을 입력하고, Create를 클릭한 다음, 생성된 API 키를 복사하세요."
            }
          },
          {
            "@type": "Question",
            "name": "API 키는 어디에 저장해야 하나요?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "API 키는 서버 측 환경 변수 또는 로컬 .env 파일에 저장하세요. 공개 저장소에 커밋하거나, 프론트엔드 코드에 붙여넣거나, 스크린샷에 포함하거나, 지원 티켓으로 보내지 마세요."
            }
          },
          {
            "@type": "Question",
            "name": "API 호출에 사용하는 CometAPI base URL은 무엇인가요?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "OpenAI 호환 SDK와 엔드포인트에는 https://api.cometapi.com/v1 를 사용하세요."
            }
          },
          {
            "@type": "Question",
            "name": "CometAPI는 OpenAI Python SDK와 함께 작동하나요?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "네. OpenAI 클라이언트를 생성하고, api_key를 CometAPI API 키로 설정하고, base_url을 https://api.cometapi.com/v1 로 설정하세요."
            }
          },
          {
            "@type": "Question",
            "name": "OpenAI에서 CometAPI로 어떻게 전환하나요?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "base URL을 https://api.cometapi.com/v1 로 변경하고, API 키를 CometAPI API 키로 교체한 다음, 모델 페이지에서 CometAPI model ID를 사용하세요."
            }
          },
          {
            "@type": "Question",
            "name": "처음에는 어떤 model ID를 사용해야 하나요?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "사용 사례에 따라 model ID를 선택하세요. 모델 페이지에서 시작한 다음, 호출하려는 API 페이지에 맞는 채팅, 코딩, 이미지 또는 비디오 모델을 선택하세요."
            }
          },
          {
            "@type": "Question",
            "name": "CometAPI는 어떤 프로그래밍 언어를 지원하나요?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "CometAPI는 HTTPS 요청을 보낼 수 있는 모든 프로그래밍 언어에서 작동합니다. curl, Python, Node.js 예제부터 시작하거나, base URL을 재정의할 수 있는 OpenAI 호환 SDK를 사용하세요."
            }
          },
          {
            "@type": "Question",
            "name": "CometAPI는 무료 체험이나 무료 API 키를 제공하나요?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "대시보드에서 CometAPI API 키를 생성할 수 있습니다. 무료 체험 제공 여부, 무료 체험 크레딧, 청구 세부 정보를 확인하려면 CometAPI 가격 페이지와 가격 정보 페이지를 참고하세요."
            }
          }
        ]
      }
    ]
    }
    `}
</script>