> ## 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와 함께 Coze 사용하기
> 이 가이드를 사용해 base URL, API key, model 또는 provider 옵션을 설정하여 Coze를 CometAPI와 구성하세요.
Coze는 AI 에이전트 및 워크플로 빌더입니다. CometAPI를 Coze에 연결하는 방법은 두 가지입니다: 네이티브 **CometAPI plugin**을 사용하는 방법(가장 간단함)과 최대한의 유연성을 위해 일반 **HTTP Request node**를 사용하는 방법입니다.
## 사전 준비 사항
* 활성 API 키가 있는 CometAPI 계정 — [여기에서 발급받기](https://www.cometapi.com/console/token)
* Coze 계정 — [여기에서 가입하기](https://www.coze.com)
[CometAPI 콘솔](https://www.cometapi.com/console/token)에 로그인합니다. **Add API Key**를 클릭하고 CometAPI API 키를 복사합니다.
1. Coze에서 **Get Started**를 클릭하고 새 워크플로를 생성합니다.
2. 워크플로 편집기에서 **Add Node → Plugins**를 클릭하고 **CometAPI**를 검색합니다.
3. 워크플로에 CometAPI 플러그인 노드를 추가합니다.
4. 플러그인 노드의 **API Key** 필드에 CometAPI API 키를 붙여넣습니다.
5. **Test**를 클릭해 연결을 확인한 다음 **Publish**를 클릭합니다.
1. Coze에서 에이전트를 생성한 다음, 에이전트의 워크플로에서 Start 노드와 End 노드 사이에 **HTTP Request** 노드를 추가합니다.
2. 다음과 같이 설정합니다:
* **Method**: `POST`
* **URL**: `https://api.cometapi.com/v1/chat/completions`
* **Authentication Token**: CometAPI API 키를 붙여넣은 다음 **Confirm**을 클릭합니다
3. 요청 본문을 설정합니다:
```json theme={null}
{
"model": "your-model-id",
"messages": [
{
"role": "user",
"content": "{{block_output_100001.input}}"
}
],
"stream": false
}
```
4. End 노드에서 출력값을 HTTP 요청의 응답 본문으로 설정합니다. `your-model-id`는 [CometAPI Models 페이지](/ko/overview/models)에서 현재 사용 가능한 model ID로 바꾸세요.
워크플로에서 테스트 메시지를 실행합니다(예: 현재 시간을 물어보기). AI가 성공적으로 응답하면 통합이 정상적으로 작동하는 것입니다. 워크플로를 게시하여 실제로 사용 가능하게 만드세요.
호출이 실패하면 API 키와 엔드포인트 URL을 확인하거나 [CometAPI 지원팀](https://www.cometapi.com)에 문의하세요.
대부분의 사용자에게는 플러그인 방식이 권장됩니다 — 인증과 응답 파싱을 자동으로 처리해 줍니다. 요청 헤더를 완전히 제어해야 하거나 채팅이 아닌 엔드포인트를 호출하려는 경우에는 HTTP Request 노드를 사용하세요.