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

# OpenAI 호환 API 빠른 시작: CometAPI로 채팅 완성 요청 보내기

> curl, Python, Node.js 및 OpenAI SDK와 함께 채팅 완성 요청에 OpenAI API 호환 base URL로 CometAPI를 사용하세요.

이 페이지는 CometAPI OpenAI 호환 API 빠른 시작 가이드입니다. 채팅 완성 요청 형식, OpenAI SDK, 그리고 CometAPI base URL을 재사용할 수 있도록 도와줍니다. 이 페이지는 OpenAI 계정 설정 가이드나 OpenAI 전용 모델 페이지가 아닙니다.

## 무엇을 만들게 되나요

CometAPI의 OpenAI 호환 `POST /v1/chat/completions` 경로로 하나의 텍스트 요청을 보내고, assistant 메시지를 출력하며, 이미 OpenAI SDK를 사용하는 앱에서도 바로 사용할 수 있도록 요청 형식을 유지합니다.

## 이 페이지를 사용해야 하는 경우

다음 중 하나가 프로젝트에 해당한다면 이 빠른 시작 가이드를 사용하세요:

* 이미 OpenAI SDK 또는 채팅 완성 요청 형식을 사용하고 있습니다.
* base URL을 CometAPI로 전환하려고 합니다.
* OpenAI API 호환 경로를 통해 CometAPI model ID를 호출하려고 합니다.

## 사전 요구 사항

* `COMETAPI_KEY`에 저장된 CometAPI API 키
* [Models page](/ko/overview/models)에서 텍스트 모델 model ID
* `curl`, Python 3.10+, 또는 Node.js 18+

## API 키, base URL, 인증

OpenAI 호환 클라이언트와 함께 CometAPI base URL을 사용하세요:

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

직접 HTTP 요청은 Bearer 토큰으로 인증합니다:

```text theme={null}
Authorization: Bearer $COMETAPI_KEY
```

## 코드 예제

아래 탭을 사용해 cURL, Python, Node.js로 동일한 채팅 완성 요청을 보내세요.

<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 one sentence about CometAPI."
        }
      ]
    }'
  ```

  ```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 one sentence about CometAPI.",
          }
      ],
  )

  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 one sentence about CometAPI.",
      },
    ],
  });

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

## 흐름 설명

OpenAI 호환이라는 것은 애플리케이션이 채팅 완성 엔드포인트, 요청 본문, SDK 메서드 이름은 그대로 유지하면서 base URL과 model ID만 CometAPI 값으로 바꾸는 것을 의미합니다.

이 경로는 기본적으로 동기식입니다. API는 완성된 응답 객체를 하나의 HTTP 응답으로 반환하며, 애플리케이션은 `choices[0].message.content`를 읽습니다.

점진적인 출력을 위해서는 `stream`을 `true`로 설정하세요. 그러면 응답은 Server-Sent Events가 되며 `data: [DONE]`으로 종료됩니다. 채팅 인터페이스와 긴 응답에는 스트리밍(Streaming)을 사용하세요. 백그라운드 작업과 간단한 테스트에는 동기식 형태를 유지하세요.

## 공통 파라미터

| Parameter               | 용도                                                |
| ----------------------- | ------------------------------------------------- |
| `model`                 | 텍스트를 처리할 수 있는 모델용 CometAPI model ID입니다.           |
| `messages`              | 대화 배열입니다. 최소 요청에서는 하나의 `user` 메시지로 시작하세요.         |
| `temperature`           | 무작위성을 제어합니다. 값이 낮을수록 출력이 더 결정적입니다.                |
| `max_completion_tokens` | completion-token 예산을 사용하는 모델 계열의 생성 출력 상한을 설정합니다. |
| `stream`                | `true`로 설정하면 점진적인 응답 청크를 스트리밍합니다.                 |
| `response_format`       | 선택한 모델이 지원하는 경우 JSON 출력을 요청합니다.                   |

## 문제 해결 및 FAQ

<AccordionGroup>
  <Accordion title="이것이 OpenAI API인가요?">
    아니요. 이것은 CometAPI의 OpenAI 호환 API 경로입니다. CometAPI API 키, CometAPI base URL, 그리고 CometAPI model ID를 사용합니다.
  </Accordion>

  <Accordion title="요청이 401을 반환합니다">
    요청을 보내는 동일한 셸 또는 런타임에서 `COMETAPI_KEY`가 설정되어 있는지 확인하세요. 실제 키를 소스 파일에 붙여넣지 마세요.
  </Accordion>

  <Accordion title="model을 찾을 수 없습니다">
    텍스트 또는 채팅 요청을 지원하는 CometAPI model ID를 사용하세요. 다시 시도하기 전에 Models 페이지를 확인하세요.
  </Accordion>

  <Accordion title="SDK가 여전히 OpenAI를 호출합니다">
    클라이언트가 Python에서는 `base_url`을, Node.js에서는 `baseURL`을 `https://api.cometapi.com/v1`로 설정하는지 확인하세요.
  </Accordion>
</AccordionGroup>

## 다음 단계

* [채팅 완성 API 레퍼런스](/api/text/chat)를 읽어보세요.
* [OpenAI SDK와 함께 CometAPI 사용하기](/ko/guides/use-cometapi-with-openai-sdk)에서 SDK 클라이언트를 구성하세요.
* [사용 가능한 CometAPI 모델 나열하기](/ko/guides/how-to-list-available-models)로 사용 가능한 모델을 확인하세요.
* [오류 코드 및 재시도 전략](/ko/guides/error-codes-and-retry-strategy)으로 재시도 및 rate-limit 처리를 추가하세요.