Hunyuan 매개변수 및 프로토콜 차이
호환 프로토콜에서 Hunyuan 모델의 매개변수 차이와 사용 방법을 알아봅니다.
Hunyuan은 이 페이지에 따라 매개변수를 조정하세요. 구조: Chat Completions, Responses, Messages.
| 모델 | 적용 범위 |
|---|
| hy4-preview | 세 프로토콜 지원, Chat 강도 none/high, 기본 high |
| hy3 | 세 프로토콜 지원, Chat 강도 none/low/high, 기본 high, 보존/도구 제한은 아래 표 |
| 필드 | 차이 설명 |
|---|
thinking.type | 둘 다 기본 추론, enabled/disabled으로 명시 전환. reasoning_effort 강도는 위 표 |
reasoning_effort | Hy3에 tools 있으면 low을 high로 매핑, 도구 작업에 따라 깊이 결정 |
max_tokens, max_completion_tokens | 둘 다 추론/답변 합 제한, 후자 우선. Hy3 추론은 최소 16000 권장일 뿐 필드 최솟값 아님 |
top_k, repetition_penalty | 조용히 무시. Qwen식 확장으로 사용하지 않음 |
n | 추론 시 1이어야 함 |
preserved_thinking | Hy3 보존 스위치. tools 있으면 기본 켬, 일반 텍스트는 끔. 이름은 preserved_thinking |
이전 reasoning_content | 도구 결과와 이전 assistant 추론 및 tool_calls 전체 유지. 보존 활성화가 누락 이력을 채우지 않음 |
tool_choice | 추론 시 auto/none 사용, required 및 함수 강제는 사용하지 않음 |
web_search_options | Hy3 검색 확장: enable: true, search_source은 standard/lite, 기본 standard. 이 행은 Hy3만 적용 |
| 필드 | 차이 설명 |
|---|
max_output_tokens | 추론과 답변 포함, 보이는 텍스트만 예산 잡지 않음 |
tool_choice | Hy3은 auto/none만, required이나 함수 객체 미지원 |
previous_response_id | Hy3은 비어 있지 않은 값에 400, 여러 턴은 input에 이력 직접 전달 |
reasoning.preserved_thinking | Hy3 보존을 reasoning 객체에 설정, 기본은 Chat과 같음 |
text.format | text/json_object/json_schema 지원, Hy3 JSON Schema는 additionalProperties: false 필수 |
tools의 web_search | Hy3 검색은 type: "web_search", Chat의 web_search_options과 위치 다름 |
| 필드 | 차이 설명 |
|---|
thinking.type, max_tokens | 스위치 enabled/disabled, max_tokens은 추론과 답변 포함. budget_tokens 사용 시 답변 공간 확보 |
HY-Preserved-Thinking | Hy3 보존 Header true/false, 생략하면 기본 전략. Chat 최상위 필드를 Messages에 넣지 않음 |
| 이전 thinking 블록 | 실제 assistant를 도구 결과와 보존. Hy3이 signature을 생략하면 서명 만들지 않음. Claude 규칙 적용 안 함 |
| 필드 | 차이 설명 |
|---|
prompt_cache_key | Chat 캐시 ID 확장, 같은 접두사/안정값, 응답으로 적중 확인 |
| 추론 보존과 캐시 | 보존은 추론 연속성으로 캐시 적중과 다름. 완전하고 안정적인 이력이 재사용에 도움 |
| 캐시 사용량 | Chat usage.prompt_tokens_details.cached_tokens, Responses 실제 usage.input_tokens_details.cached_tokens, Messages 실제 usage.cache_read_input_tokens |
MODEL_ID을 전체 ID로 바꾸고 API Key를 사용하세요. 아래는 텍스트 입력입니다.
curl 'https://api.agtcloud.ai/v1/chat/completions' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"model": "MODEL_ID",
"messages": [{"role": "user", "content": "API 시간 초과 진단 방법을 세 가지로 설명하세요"}],
"reasoning_effort": "high",
"max_completion_tokens": 16384
}'