---
title: "Chat Completions API란? /v1 채팅 엔드포인트 | BroadRouter"
description: "Chat Completions API는 역할이 붙은 메시지 목록을 받아 모델의 응답을 반환합니다. 요청과 응답 구조, 그리고 많은 제공업체가 이 형식을 따르는 이유를 정리했습니다."
url: https://broadrouter.com/ko/glossary/chat-completions-api/
lang: ko
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

이 페이지는 영어 원문을 AI의 도움을 받아 번역했습니다. [영어 원문 읽기](https://broadrouter.com/glossary/chat-completions-api/) (2026-11-16 업데이트).

# Chat Completions API

업데이트 2026-11-16

Chat Completions API는 OpenAI의 HTTP 엔드포인트인 POST /v1/chat/completions로, 모델 이름과 역할이 붙은 메시지 목록을 받아 모델의 다음 메시지를 반환합니다. 이 요청과 응답 구조는 OpenAI 호환 제공업체와 SDK가 재사용하는 공통 형식이 되었습니다.

다른 이름: 챗 컴플리션 API, 채팅 완성 API, chat completions 엔드포인트, Chat Completions, chat completions endpoint, /v1/chat/completions, chat.completions.create

실제로 쓰이는 LLM 코드의 대부분은 한 가지 방언을 씁니다. 메시지 목록을 넣으면 메시지 하나가 나오는 방식입니다. 그 방언이 바로 Chat Completions API입니다.

## 작동 방식

`model`과 `messages` 배열을 담은 JSON을 `/v1/chat/completions`에 POST합니다. 각 메시지에는 `role`(`system`, `user`, `assistant`, `tool`)과 `content`가 있습니다. 응답에는 `choices` 배열이 있고, 각 choice에는 `message`와 생성이 끝난 이유를 알려 주는 [finish\_reason](https://broadrouter.com/ko/glossary/finish-reason/)이 들어 있으며, 토큰 수를 담은 `usage` 블록도 함께 옵니다.

```bash
curl https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"broadnet/gemma-4-26b-a4b",
       "messages":[{"role":"system","content":"Answer in one line."},
                   {"role":"user","content":"What is a token?"}]}'
```

OpenAI Python SDK에서는 같은 호출이 `client.chat.completions.create(...)`입니다. 선택 필드로 출력을 조절합니다. `max_tokens`, `temperature`, `stream`, `tools`, `response_format` 등이 있습니다.

이 API는 상태를 저장하지 않습니다. OpenAI 마이그레이션 가이드에 따르면 Chat Completions에서는 “conversation state must be managed manually”(번역: 대화 상태를 직접 관리해야 한다). 즉 코드가 기록을 보관하고 턴마다 다시 보내야 합니다. OpenAI의 더 새로운 Responses API는 타입이 지정된 항목을 쓰고 상태를 서버 쪽에 보관할 수 있으며, OpenAI는 자사 플랫폼의 새 프로젝트에 이를 권장합니다. 하지만 Chat Completions도 “remains supported”(번역: 계속 지원된다)라고 밝힙니다.

## 왜 중요한가

-   **이식성.** [OpenAI 호환 API](https://broadrouter.com/ko/glossary/openai-compatible-api/)라고 하면 대개 이 엔드포인트를 뜻합니다. 제공업체를 바꿀 때는 새 [base URL](https://broadrouter.com/ko/glossary/base-url/), 키, 모델 이름만 바꾸면 되는 경우가 많습니다.
-   **비용.** 전체 기록을 다시 보내므로 입력 토큰이 턴마다 늘어납니다. 긴 대화는 잘라 내거나 요약하세요.
-   **필드 차이.** 호환 제공업체가 모든 OpenAI 필드를 받는 것은 아닙니다. 알 수 없는 필드는 무시되거나 거부될 수 있으니, 의존하는 필드는 테스트하세요.

## BroadNet Inference에서는

BroadNet은 `https://inference.broadnet.ai/v1`의 POST /v1/chat/completions로 DeepSeek V4.1 Flash, [GLM 5.3](https://broadrouter.com/ko/models/glm-5.3/), [Qwen3.8 27B](https://broadrouter.com/ko/models/qwen3.8-27b/), [Gemma 4 VL 26B](https://broadrouter.com/ko/models/gemma-4-vl-26b/)의 채팅을 제공합니다. [스트리밍](https://broadrouter.com/ko/glossary/streaming/)은 `stream=true`를 쓰고 `data: [DONE]`으로 끝납니다. 도구 호출과 구조화된 출력은 GLM 5.3과 Qwen3.8 27B에만 문서화되어 있습니다. BroadNet의 [API 레퍼런스](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-glossary-chat-completions-api&utm_content=body)는 Responses 엔드포인트를 문서화하지 않으므로 Chat Completions를 사용하세요. [curl 빠른 시작](https://broadrouter.com/ko/guides/curl-quickstart/)이나 [Python SDK 가이드](https://broadrouter.com/ko/guides/openai-python-sdk/)부터 시작하세요.

## 흔한 실수

-   최신 사용자 메시지만 보내고 모델이 대화를 기억하길 기대하는 것.
-   다른 제공업체의 레퍼런스를 확인하지 않고 OpenAI 전용 필드를 그대로 복사하는 것.

## 자주 묻는 질문

### Chat Completions API는 deprecated되었나요?

아니요. OpenAI 마이그레이션 가이드에는 "Chat Completions remains supported"(번역: Chat Completions는 계속 지원된다)라고 나와 있습니다. 다만 OpenAI에서 새로 시작하는 프로젝트에는 더 새로운 Responses API를 권장합니다.

### Chat Completions API는 이전 메시지를 기억하나요?

아니요. 상태를 저장하지 않습니다(stateless). OpenAI 가이드에 따르면 대화 상태는 "must be managed manually"(번역: 직접 관리해야 한다)이므로, 요청할 때마다 전체 메시지 기록을 보내야 합니다.

### BroadNet Inference는 채팅에 어떤 엔드포인트를 쓰나요?

base URL https://inference.broadnet.ai/v1에서 POST /v1/chat/completions를 씁니다. BroadNet은 Responses API 엔드포인트를 문서화하지 않습니다.

## 함께 보기

-   [OpenAI 호환 API(OpenAI-compatible API)](https://broadrouter.com/ko/glossary/openai-compatible-api/) (용어)
-   [base URL(베이스 URL)](https://broadrouter.com/ko/glossary/base-url/) (용어)
-   [스트리밍(streaming)](https://broadrouter.com/ko/glossary/streaming/) (용어)
-   [finish\_reason(종료 이유)](https://broadrouter.com/ko/glossary/finish-reason/) (용어)
-   [도구 호출(tool calling)](https://broadrouter.com/ko/glossary/tool-calling/) (용어)
-   [시스템 프롬프트(system prompt)](https://broadrouter.com/ko/glossary/system-prompt/) (용어)
-   [이미지 토큰(image tokens)](https://broadrouter.com/ko/glossary/image-tokens/) (용어)
-   [curl로 BroadNet Inference에 첫 요청 보내기](https://broadrouter.com/ko/guides/curl-quickstart/) (가이드)
-   [BroadNet Inference에서 OpenAI Python SDK 사용하기](https://broadrouter.com/ko/guides/openai-python-sdk/) (가이드)
-   [채팅 완성 스트리밍과 끊긴 연결 처리하기](https://broadrouter.com/ko/guides/streaming-chat-completions/) (가이드)
-   [OpenAI API에서 옮겨 가기: Python, Node, cURL 코드로 보는 전환 과정](https://broadrouter.com/ko/blog/migrate-from-openai-api-code-walkthrough/) (글)
-   [OpenAI 호환 API로 전환하기: 마이그레이션 체크리스트](https://broadrouter.com/ko/blog/openai-compatible-api-migration-checklist/) (글)

실제 워크로드로 테스트해 보세요. 신규 계정에는 US$5 상당의 초기 크레딧이 제공되며 Gemma 및 음성 전사에 사용할 수 있습니다. DeepSeek, GLM 및 Qwen3.8 모델은 충전이 필요합니다.

[시작하기](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-glossary-chat-completions-api&utm_content=page-cta) ·

**출처**

-   [OpenAI API 레퍼런스, chat completion 생성 (2026-11-15 확인)](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [OpenAI, Responses API로 마이그레이션 (2026-11-15 확인)](https://developers.openai.com/api/docs/guides/migrate-to-responses)
-   [BroadNet Inference API 레퍼런스 (2026-11-15 확인) (영어)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-glossary-chat-completions-api&utm_content=sources)
