에이전트용 모델을 찾는다면 Hunyuan Hy4는 꽤 강력한 선택지다. 한 평가에서는 Tencent의 최고 추천 모델로 꼽혔고, API 요금은 입력 토큰 100만 개당 $0.834, 출력 토큰 100만 개당 $2.501이다. 다만 실제 도입을 결정할 때는 가격보다 먼저 786GB에 달하는 FP8 체크포인트를 감당할 배포 환경이 있는지부터 확인해야 한다.
API는 2026년 11월 4일 출시됐다. Tencent는 2026년 11월 20일 @TencentHunyuan을 통해 총 770B, 활성 파라미터 49B 규모의 웨이트와 System Card, 저장소 링크를 공개했다.
Hy4는 가격보다 786GB 배포 조건이 먼저다
Hy4를 직접 운영하려면 사실상 데이터센터급 환경이 필요하다. 총 770B, 활성 49B인 혼합 전문가 모델은 FP8 기준 약 786GB가 필요하며(LimitDigest 하드웨어 확인, 11월 20일), Tencent 역시 같은 가이드에서 여러 GPU에 모델을 분할하는 구성을 제시한다.
11월 4일 API, 11월 20일 웨이트—실제로 공개된 것
hy4 API는 Preview 버전에 비전 입력과 도구 사용 기능을 추가했다(Tencent Cloud 개발자 가이드, 11월 10일). Instruct, FP8, Base 웨이트와 System Card는 11월 20일에 뒤이어 공개됐다. 이전에 오픈 웨이트로 소개된 자료는 대개 Preview 또는 Flash를 가리키는 경우가 많았다.
Hy4에 필요한 하드웨어의 현실
현재 공유된 GGUF 파일 중 가장 작은 용량은 약 215GB다(단일 사용자 하드웨어 보고). 24GB RTX 3090 한 장으로는 담을 수 없다. 단일 머신에서 돌렸다는 보고가 비교적 확실한 모델은 총 220B, 활성 12B인 Hy4-Flash다(LimitDigest 사양). Hy4 플래그십을 운영하려면 여러 GPU를 탑재한 서버가 필요하다.
tencent: hy4 is open weights smallest gguf: ~215 gb my 3090: 24 gb cool cool cool — @blakeothy, 단일 사용자 하드웨어 보고, 2026년 11월 20일
대부분의 팀은 무시해도 되지만, 일부 기업에는 중요한 라이선스 조건
Hy4는 Apache 2.0을 기반으로 하되 상업적 배포 조항이 추가된 Tencent Hy License를 사용한다(LimitDigest 라이선스 메모). API 액세스를 판매하는 기업의 연 매출이 5,000만 달러를 초과하거나 월간 사용자가 1억 명을 넘는 제품이라면 별도의 Tencent 라이선스가 필요하다. 상업적으로 재배포하기 전에는 Hugging Face에서 최신 라이선스 원문을 확인해야 한다.
통화 단위 혼동 없이 보는 Hunyuan Hy4 API 요금
Hunyuan Hy4 API의 정가는 Tencent Cloud TokenHub 싱가포르 탭 기준 입력 토큰 100만 개당 $0.834, 출력 토큰 100만 개당 $2.501, 캐시된 입력 토큰 100만 개당 $0.042다(LimitDigest 11월 20일 확인, ModelMenu 가격표). 광저우 탭에서는 입력 CNY 6, 출력 CNY 18, 캐시 입력 CNY 0.30으로 표시된다(Tencent Cloud 개발자 가이드).
| 모델 | 입력 / 100만 토큰 | 캐시 입력 / 100만 토큰 | 출력 / 100만 토큰 | 컨텍스트 |
|---|---|---|---|---|
| Hunyuan Hy4 | $0.834 | $0.042 | $2.501 | 1M |
| Hunyuan Hy4 Flash | $0.07 | $0.003 | $0.281 | 1M |
| Hunyuan Hy3 | $0.132 | $0.033 | $0.528 | 256K |
| Hunyuan Hy4 Preview | $0.834 | $0.042 | $2.501 | 1M |
Hy4는 일반 입력보다 캐시 입력이 95% 저렴하고, Hy4 Flash는 96% 저렴하다. 인용한 가격표에서는 별도의 캐시 기록 비용이나 긴 프롬프트 추가 요금을 확인할 수 없었다.
12월 31일까지 청구액을 절반으로 줄이는 50% 프로모션
Hy4는 베이징 시간 기준 2026년 12월 31일까지 50% 할인된다. 할인 기간에는 입력 토큰 100만 개당 $0.417, 출력 토큰 100만 개당 $1.25다. Flash의 별도 프로모션은 11월 30일에 끝난다(LimitDigest 프로모션 표). 이후에는 두 모델 모두 정가로 돌아간다.
입력과 출력 비율을 3:1로 잡으면 프로모션 기간의 Hy4 혼합 요금은 토큰 100만 개당 약 $0.63이다. DeepSeek V4.1 Flash의 정가 기준 약 $0.52보다 높다(LimitDigest 혼합 요금 계산).
입력 960K, 출력 64K—요금을 바꾸는 한도
전체 컨텍스트는 1M 토큰이며, 요청 하나당 입력은 최대 960K, 출력은 최대 64K까지 가능하다. 신규 TokenHub 계정은 언어 모델마다 100만 무료 토큰을 신청할 수 있으며, 유효 기간은 1년이고 2026년 12월 31일까지 제공된다(LimitDigest 무료 사용량 메모). Tencent는 활성화한 Hunyuan 모델마다 $30을 보증금처럼 동결하고 엔드포인트를 삭제하면 환불한다. 생성을 취소하더라도 이미 생성된 토큰은 과금된다.
리셀러 요금은 입력 $0.33 / 출력 $1.15부터 입력 $0.90 / 출력 $2.70까지 다양하다. 가격만 보지 말고 안정성과 지연 시간도 함께 비교해야 한다(AIRateCard 공급자 표, 11월 5일).
표 하나로 비교하는 Hy4, Preview, Flash
hy4-preview와 hy4는 정가와 1M 컨텍스트를 공유하지만, 이미지 입력을 지원하는 것은 전체 모델뿐이다(BUMO 통합 테스트, 11월 8일). Tencent는 hy4-preview를 종료 예정("To Be Discontinued")으로 표시했지만, 종료 날짜는 공개하지 않았다(LimitDigest 상태 확인).
| 변형 | 모델 ID | 비전 | 상태 | 추천 용도 |
|---|---|---|---|---|
| Hunyuan Hy4 | hy4 / 라우터에서의 tencent/hy4 | 지원 | 현재 제공 | 에이전트 작업, 코딩 에이전트, 이미지와 텍스트를 함께 쓰는 워크플로 |
| Hunyuan Hy4 Preview | hy4-preview | 미지원 | 종료 예정 | 가격이 같으므로 즉시 hy4로 이전 |
| Hunyuan Hy4 Flash | hy4-flash | 지원 | 현재 제공 | 프롬프트 단위 테스트를 마친 뒤 대규모 일괄 작업 |
3:1 비율로 계산하면 Flash는 약 5배 저렴하고, 아래의 4:1 작업에서는 약 10배 저렴하다. 자세한 내용은 Hunyuan Hy4 Flash API pricing와 Hy4 Preview API pricing을 참고하면 된다.
사고 토큰으로 출력 비용을 태우지 않고 Hy4 호출하기
Hy4는 BUMO 같은 라우터를 통해 OpenAI 호환 방식으로 사용할 수 있다. BUMO는 tencent/hy4에 OpenAI와 Anthropic 형식을 지원한다고 문서화했다(BUMO 테스트). 여기서 주의할 점은 추론 토큰도 출력 요금으로 과금된다는 것이다. 해당 테스트의 팰린드롬 작업에서는 사고 모드가 켜졌을 때 24초 동안 출력 토큰 1,009개 중 사고 토큰만 971개가 사용됐고 비용은 약 CNY 0.018이었다. 사고 모드를 끄면 2.9초 동안 출력 토큰 45개, 비용 약 CNY 0.0011로 줄었다.
from openai import OpenAI
client = OpenAI(
base_url="https://router.bumo.cc/v1", # BUMO Router OpenAI-compatible endpoint
api_key="sk-your-key",
)
resp = client.chat.completions.create(
model="tencent/hy4",
messages=[{"role": "user", "content": "Fix add() so tests pass."}],
max_tokens=4096,
extra_body={"thinking": {"type": "disabled"}},
)이 테스트에서는 enable_thinking: false가 사고 모드를 끄지 못했고, {"thinking": {"type": "disabled"}}가 실제로 작동했다. 사고 모드를 켤 때는 max_tokens를 넉넉하게 잡아야 한다. 2,048토큰 제한에서는 사고 내용이 대부분을 차지해 도구 호출에 쓸 공간이 남지 않았다. 공식 TokenHub 키와 엔드포인트를 사용할 때는 Tencent Cloud 개발자 가이드를 따라야 한다.
Claude Code는 /v1/messages를 자체적으로 덧붙이므로 기본 URL에는 /v1을 넣지 않는다. tencent/hy4를 사용하면 unrecognized_model을 기록하지만 도구 호출 자체를 막지는 않는다. 한 번의 9턴 수정-테스트-검증 작업에서는 캐시되지 않은 입력 토큰 11,895개와 캐시된 입력 토큰 68,224개, 출력 토큰 797개를 사용했으며 비용은 약 CNY 0.106이었다(BUMO Claude Code 실행 사례).
초기 사용자들이 실제로 보고한 내용
인용된 11월 20일 스냅샷에서 LMArena Agent Arena 순위는 45개 중 17위, Code Arena는 58개 중 22위였다. DeepSeek V4.1 Flash는 각각 24위와 19위, Kimi K3.1 Pro는 18위와 15위였다(LimitDigest 리더보드 확인). 다만 순위는 방향성을 보여주는 참고 자료로 보는 편이 좋다.
i ran into some issues with the hy4 model after like 400k context where at times the model was looping. — r/ArtificialIntelligence의 u/Constant_Art_20, 실제 사용자의 장문 컨텍스트 보고
700K를 넘는 입력을 계획하고 있다면, 1M 전체 창에서 품질이 일정할 것이라고 가정하기 전에 직접 needle-in-a-haystack 테스트를 돌려보는 것이 좋다.
Hy4에 비용을 지불할 만한 팀은 어디인가
| 워크로드 | 선택 | 이유 |
|---|---|---|
| 오피스 에이전트, 장시간 이어지는 도구 루프 | 프로모션 기간의 Hy4 | Agent Arena 17위, 1M 컨텍스트, 캐시 할인으로 반복 프롬프트 비용 절감 |
| 대규모 저가 코드 완성 | DeepSeek V4.1 Flash | 더 낮은 출력 요금, Code Arena에서 Hy4 22위 대비 19위 |
| 대량 추출, 짧은 재작성 | 테스트 후 Hy4 Flash | 입력 20M과 출력 5M 기준 약 $2.81로, Hy4 정가의 $29.18보다 저렴 |
기존 hy4-preview 트래픽 | 지금 hy4로 전환 | 가격은 같고 비전을 지원하며 Preview는 종료 예정 |
입력 20M, 출력 5M 토큰을 사용하는 중간 규모의 한 달 비용은 Hy4 정가 기준 약 $29.18, 프로모션 기간에는 약 $14.59, Hy4 Flash 정가에서는 약 $2.81이다. 안정적인 프롬프트를 요청 앞부분에 유지하는 캐시 중심 에이전트 세션에서는 모델 선택보다 캐시 적중 여부가 전체 비용에 더 큰 영향을 줄 수 있다.
12월 31일 이후 정가가 적용되면, 코드 중심 작업은 Hy4를 기본값으로 두기보다 DeepSeek V4.1 Flash와 다시 비교해보는 편이 좋다.
FAQ
Hunyuan Hy4 API 요금은 얼마인가?
정가는 토큰 100만 개당 입력 $0.834, 출력 $2.501, 캐시 입력 $0.042다. 2026년 12월 31일까지 프로모션 기간에는 각각 $0.417 / $1.25가 적용된다.
Hy4의 컨텍스트 윈도는 얼마인가?
전체 1M이며, 요청당 입력은 최대 960K, 출력은 최대 64K다. Hy3는 256K다.
Hy4 Preview는 종료되나?
Tencent는 종료 예정("To Be Discontinued")으로 표시했지만 날짜는 공개하지 않았다. 새 호출에는 hy4를 사용하면 된다.
API 대신 Hy4를 직접 호스팅할 수 있나?
가능하다. 다만 플래그십 모델을 직접 운영하려면 약 786GB의 FP8 메모리와 여러 GPU를 탑재한 서버가 필요하다. 대부분의 팀에는 API 사용이 현실적이다.
캐싱으로 Hy4 요금을 줄이려면 어떻게 해야 하나?
변하지 않는 프롬프트를 요청 앞부분에 배치하면 된다. 캐시 입력은 95% 저렴하며, 에이전트 루프에서 특히 효과가 크다.
Hy4를 Claude Code에서 사용할 수 있나?
Anthropic 호환 라우팅을 통해 tencent/hy4를 사용할 수 있다. unrecognized_model 경고가 표시될 수 있지만 도구 호출을 막지는 않는다.