---
title: "JSON 모드란? json_object와 json_schema 차이 | BroadRouter"
description: "JSON 모드는 LLM 응답이 유효한 JSON으로 파싱되게 하지만 스키마는 강제하지 않습니다. response_format json_object의 작동 방식과 구조화된 출력을 써야 할 때를 정리했습니다."
url: https://broadrouter.com/ko/glossary/json-mode/
lang: ko
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# JSON 모드(JSON mode)

업데이트 2026-11-14

JSON 모드는 OpenAI 방식 API의 response\_format {"type": "json\_object"} 같은 LLM API 설정으로, 모델의 응답을 파싱 가능한 유효한 JSON으로 만듭니다. JSON Schema를 쓰는 구조화된 출력과 달리, 객체에 어떤 키와 타입, 값이 들어갈지는 보장하지 않습니다.

다른 이름: JSON 모드, JSON 출력 모드, JSON 응답 모드, response\_format json\_object, json\_object, JSON output mode, JSON response mode

JSON 모드는 “`json.loads()`가 성공할까?”라는 질문 하나에 답합니다. “이게 내 코드가 기대하는 객체인가?”라는 두 번째 질문에는 답하지 않습니다.

## 작동 방식

Chat Completions API에서는 필드 하나로 켭니다.

```json
{"response_format": {"type": "json_object"},
 "messages": [
   {"role": "system", "content": "Return JSON with keys name and email."},
   {"role": "user", "content": "Reach me at Sara, sara@example.com"}]}
```

OpenAI API 레퍼런스는 이를 “the older JSON mode, which ensures the message the model generates is valid JSON.”(번역: 모델이 생성하는 메시지가 유효한 JSON이 되도록 보장하는 예전 방식의 JSON 모드)이라고 부릅니다. 여기에는 두 가지 규칙이 따릅니다. 먼저 메시지에서 JSON을 요청해야 합니다. OpenAI 가이드에 따르면 API는 “will throw an error if the string ‘JSON’ does not appear somewhere in the context.”(번역: 컨텍스트 어딘가에 ‘JSON’이라는 문자열이 없으면 오류를 던진다) 그리고 구조는 모델 마음대로입니다. 가이드는 JSON 모드가 “will not guarantee the output matches any specific schema.”(번역: 출력이 특정 스키마와 일치함을 보장하지 않는다)라고 밝힙니다.

[구조화된 출력](https://broadrouter.com/ko/glossary/structured-output/)은 더 엄격한 선택지입니다. `{"type": "json_schema", ...}`로 JSON Schema를 전달하면 모델은 그 스키마에 맞춰 출력하도록 제약됩니다.

|  | JSON 모드(`json_object`) | 구조화된 출력(`json_schema`) |
| --- | --- | --- |
| 유효한 JSON | 예 | 예 |
| 필수 키와 타입 | 아니요 | 예 |
| 스키마를 직접 제공 | 아니요 | 예 |
| 프롬프트에 “JSON” 언급 필수 | 예(OpenAI) | 아니요 |

OpenAI는 “always using Structured Outputs instead of JSON mode when possible.”(번역: 가능하면 항상 JSON 모드 대신 Structured Outputs를 사용할 것)을 권합니다.

## 왜 중요한가

-   **검증은 여전히 여러분의 몫입니다.** JSON 모드에서는 키가 빠졌거나 숫자가 문자열로 와도 파싱은 성공하고, 나중에 실패합니다. 코드에서 스키마로 검증하세요.
-   **잘림.** 응답이 [`max_tokens`](https://broadrouter.com/ko/glossary/max-tokens/)에 도달하면 JSON이 불완전해집니다. 추론 모델은 생각하는 데도 같은 예산을 쓰므로 더 취약합니다.
-   **대비책.** OpenAI 가이드는 `json_schema`를 쓸 수 없는 이전 모델에 JSON 모드를 안내합니다. 지원 여부는 제공업체와 모델마다 다르므로, 스키마가 받아들여지지 않을 때는 JSON 모드에 자체 검증을 더하는 것이 대비책입니다.

## BroadNet Inference에서는

BroadNet의 [API 레퍼런스](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-glossary-json-mode&utm_content=body#models)는 GLM 5.3과 Qwen3.8 27B에 구조화된 출력을 표시합니다. 하지만 지원되는 `response_format`이 `json_object`인지 `json_schema`인지, DeepSeek V4.1 Flash와 BroadNet Gemma 4 VL 26B가 둘 중 하나라도 받는지는 밝히지 않습니다. 사용하는 모델에서 둘 다 테스트하세요. 스키마는 [JSON Schema 생성기](https://broadrouter.com/tools/json-schema-generator/)로 작성할 수 있습니다. [JSON 모드와 json\_schema 비교](https://broadrouter.com/ko/blog/structured-output-json-schema/) 글은 복구와 모니터링을 다루고, [인보이스 가이드](https://broadrouter.com/ko/guides/read-arabic-invoices-with-vision/)는 이미지에서 JSON을 추출하는 방법을 보여 줍니다.

## 자주 묻는 질문

### JSON 모드와 구조화된 출력은 같은 건가요?

아닙니다. OpenAI 가이드에 따르면 둘 다 유효한 JSON을 만들지만, 스키마 준수를 보장하는 것은 Structured Outputs뿐입니다. JSON 모드는 유효하기만 하면 어떤 객체든 반환할 수 있습니다.

### JSON 모드에서 JSON이라는 단어와 관련된 오류가 나는 이유는 무엇인가요?

OpenAI는 메시지 어딘가에 JSON을 생성하라는 지시가 있어야 하며, 컨텍스트에 "JSON"이라는 문자열이 없으면 오류를 반환합니다.

### JSON 모드에서도 깨진 JSON이 나올 수 있나요?

네. 응답이 max\_tokens나 컨텍스트 한도에서 잘리면 그렇습니다. 파싱하기 전에 finish\_reason을 확인하세요.

## 함께 보기

-   [구조화된 출력(Structured output)](https://broadrouter.com/ko/glossary/structured-output/) (용어)
-   [도구 호출(tool calling)](https://broadrouter.com/ko/glossary/tool-calling/) (용어)
-   [max\_tokens(최대 출력 토큰)](https://broadrouter.com/ko/glossary/max-tokens/) (용어)
-   [시스템 프롬프트(system prompt)](https://broadrouter.com/ko/glossary/system-prompt/) (용어)
-   [OpenAI 호환 API(OpenAI-compatible API)](https://broadrouter.com/ko/glossary/openai-compatible-api/) (용어)
-   [JSON Schema(JSON 스키마)](https://broadrouter.com/ko/glossary/json-schema/) (용어)
-   [비전 모델로 아랍어 인보이스와 영수증 읽기](https://broadrouter.com/ko/guides/read-arabic-invoices-with-vision/) (가이드)
-   [BroadNet Inference에서 OpenAI Python SDK 사용하기](https://broadrouter.com/ko/guides/openai-python-sdk/) (가이드)
-   [JSON 모드 vs json\_schema: 믿고 쓸 수 있는 구조화된 출력](https://broadrouter.com/ko/blog/structured-output-json-schema/) (글)
-   [비전 LLM으로 송장·영수증·양식 데이터를 JSON으로 추출하기](https://broadrouter.com/ko/blog/extract-data-from-documents-with-vision-llm/) (글)
-   [LLM이 잘못된 JSON을 반환할 때 해결법: 원인, 복구, 재시도](https://broadrouter.com/ko/blog/fix-invalid-json-from-llm/) (글)

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

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

**출처**

-   [OpenAI, Structured Outputs 가이드(JSON 모드와 Structured Outputs 비교)](https://developers.openai.com/api/docs/guides/structured-outputs)
-   [OpenAI API 레퍼런스, chat completion 생성(response\_format)](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [BroadNet Inference API 레퍼런스, 모델 ID (영어)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-glossary-json-mode&utm_content=sources#models)
