---
title: "생성 및 출력 문제"
slug: "clovastudio-troubleshoot-generation"
updated: 2026-10-26T10:59:50Z
published: 2026-10-26T10:59:50Z
canonical: "guide-gov.ncloud-docs.com/clovastudio-troubleshoot-generation"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide-gov.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 생성 및 출력 문제

Classic/VPC 환경에서 이용 가능합니다.

CLOVA Studio를 사용하면서 발생할 수 있는 문제와 해결 방법에 대해 설명합니다.

## 추론 과정 미노출

HCX-007 모델 사용 시 추론/생각 과정이 보이지 않습니다.

#### 원인

플레이그라운드에서는 추론 내용(생각 과정, thinking/reasoning trace)을 표시하지 않습니다.

#### 해결 방법

HCX-007 모델의 추론 내용(생각 과정, thinking/reasoning trace)은 Chat Completions v3 API 응답에서의 `result.message.thinkingContent` 필드, 또는 오픈AI 호환 API(/chat/completions) 응답에서의 `choices[0].message.thinking_content` 필드에서 확인해 주십시오.

## 입력한 글자와 토큰 수의 불일치

입력 글자 수는 짧은데 이용한 토큰 수가 크게 나옵니다.

#### 원인

토큰 수는 단순한 글자 수가 아니라, 문장의 구성 요소를 언어별 토큰화 기준으로 분리한 '단어 조각(token)' 수로 계산됩니다. 또한, Chat Completions API에서는 `system`, `user`, `assistant` 등 message 전체가 모두 입력 토큰 수에 포함되며, 특히 시스템 프롬프트를 길게 설정한 경우 이용 토큰 수가 많아질 수 있습니다.

#### 해결 방법

요청 구문 전체에 대한 토큰 수를 [토큰 계산기](https://clovastudio.gov-ncloud.com/explorer/tools/tokenizer)를 사용하여 미리 확인해 주십시오.

## HCX-007로 도구 호출 시 오류

도구 호출 시 HCX-005는 정상적으로 작동하나 HCX-007은 오류가 발생합니다.

#### 원인

HCX-007은 하이브리드 추론 모델입니다. 추론 기능을 이용할 경우 Function calling 등의 기능을 사용할 수 없습니다. 추론 여부 및 사고 과정 깊이를 설정하는 파라미터인 thinking.effort의 기본값이 'low'이므로 별도로 설정하지 않으면 추론 기능이 사용됩니다.

#### 해결 방법

HCX-007로 Function calling 사용이 필요한 경우, 추론 기능을 활용하지 않도록 추가 파라미터를 정의해야 합니다.

```
model_hcx007 = ChatClovaX(model="HCX-007", api_key={api_key}, reasoning_effort="none")
```

자세한 설명은 [추론](https://api-gov.ncloud-docs.com/docs/clovastudio-chatcompletionsv3-thinking), [Function calling](https://api-gov.ncloud-docs.com/docs/clovastudio-chatcompletionsv3-fc)을 참조해 주십시오.

## 특정 정보(전화번호, URL)의 마스킹 처리

전화번호, URL 등 일부 정보가 *로 자동으로 마스킹 처리되어 전달됩니다. 마스킹 처리를 해제하고 싶습니다.

#### 원인

CLOVA Studio 약관 제10조(권리 및 의무 등)의 2항에 따라, 개인정보는 CLOVA Studio 사용 시 입력되어서는 안 됩니다.

#### 해결 방법

CLOVA Studio에서는 개인정보 보호를 위해 전화번호, 이메일, URL 등 개인 식별 가능 정보가 자동으로 마스킹 처리됩니다. 해당 기능은 시스템 보안 및 개인정보 보호 정책에 따라 해제할 수 없습니다. 개인정보가 필요한 테스트나 서비스 검증이 필요한 경우에는 샘플 데이터(예: 010-XXXX-XXXX, test@example.com 등) 또는 비식별 처리된 데이터를 사용해 주십시오.

              참고

              

이 가이드에서 필요한 정보를 찾지 못했거나 추가로 필요한 정보가 있으신 경우, 언제든지 아래의 피드백 아이콘을 클릭하여 의견을 보내 주십시오. 전달해 주신 의견을 참고하여 더 유용한 정보를 제공하겠습니다.