Skip to content
Tencent

Hy3

Hy3 is an Apache 2.0 Mixture-of-Experts model from the Tencent Hunyuan team, with 295B total parameters, 21B active per token, and three selectable reasoning levels. It supports a context window of 262.1K tokens and a max output of 262.1K tokens per request. Your use is subject to Tencent's Terms & Privacy Policies.

Use with AI GatewayView docs
import { streamText } from 'ai'


const result = streamText({
  model: 'tencent/hy3',
  prompt: 'Why is the sky blue?'
})
Read docs
OverviewAPIAboutProvidersThroughputLatencyUptimeStatusFAQ

Frequently Asked Questions

  • What is Hy3?

    Hy3 is a text-only Mixture-of-Experts language model from the Tencent Hunyuan team, released on July 6, 2026. It carries 295B total parameters with 21B active per token and succeeds the Hy3 Preview from late April 2026.

  • What architecture does Hy3 use?

    A Mixture-of-Experts (MoE) design with 295B total parameters, 21B active per token, 80 layers, and 192 routed experts using top-8 routing. Attention is grouped-query with 64 heads and eight key-value heads, and a 3.8B multi-token prediction layer supports speculative decoding.

  • How do the three reasoning modes work?

    Set reasoning_effort on the request. no_think returns a direct answer and is the default, low applies shallow reasoning, and high applies deep chain-of-thought for math, coding, and analysis. Providers expose the field differently, so check that your client forwards it, and remember reasoning tokens count toward your output budget.

  • What is the context window for Hy3?

    Hy3 supports a context window of 262.1K tokens and a max output of 262.1K tokens per request. That covers long agent transcripts, large document sets, and repository-scale code review.

  • Is Hy3 open source?

    Yes. Tencent released Hy3 under the Apache License 2.0, with BF16 and FP8 weights on Hugging Face, ModelScope, GitCode, and CNB. Through AI Gateway you use hosted inference, so licensing matters only if you also run the weights yourself.

  • What sampling parameters does Tencent recommend?

    temperature=0.9 and top_p=1.0. Published quality figures assume those settings, so treat them as the starting point before you tune for your own task.

  • How consistent is Hy3 across agent frameworks?

    SWE-Bench Verified accuracy varies by less than 4% across scaffoldings including CodeBuddy, Cline, and KiloCode. That narrow spread means a result you measure in one harness generally holds when you switch to another.

  • How much does Hy3 hallucinate?

    Tencent's internal evaluations on real-world scenarios report a 5.4% hallucination rate, down from 12.5%, and a 12.7% commonsense error rate, down from 25.4%. The stated design target is to answer when grounded and say so when evidence is missing.

  • How do I call Hy3 through AI Gateway?

    Use the model identifier tencent/hy3 with the AI SDK, the Chat Completions API, the Responses API, the Messages API, or another supported API format. You authenticate with an AI Gateway API key, and no Tencent account is needed.

  • Does AI Gateway support Zero Data Retention for Hy3?

    Yes, Zero Data Retention is available for this model. Zero Data Retention is offered on a per-provider basis. See https://vercel.com/docs/ai-gateway/capabilities/zdr for details.