Skip to main content

​
Tencent Cloud TokenHub

Tencent Cloud ships as a bundled provider plugin in FluffBuzz. It gives access to Tencent Hy3 preview through the TokenHub endpoint (tencent-tokenhub). The provider uses an OpenAI-compatible API.
PropertyValue
Providertencent-tokenhub
Default modeltencent-tokenhub/hy3-preview
AuthTOKENHUB_API_KEY
APIOpenAI-compatible chat completions
Base URLhttps://tokenhub.tencentmaas.com/v1
Global URLhttps://tokenhub-intl.tencentmaas.com/v1

​
Quick start

1

Create a TokenHub API key

Create an API key in Tencent Cloud TokenHub. If you choose a limited access scope for the key, include Hy3 preview in the allowed models.
2

Run onboarding

fluffbuzz onboard --auth-choice tokenhub-api-key
3

Verify the model

fluffbuzz models list --provider tencent-tokenhub

​
Non-interactive setup

fluffbuzz onboard --non-interactive \
  --mode local \
  --auth-choice tokenhub-api-key \
  --tokenhub-api-key "$TOKENHUB_API_KEY" \
  --skip-health \
  --accept-risk

​
Built-in catalog

Model refNameInputContextMax outputNotes
tencent-tokenhub/hy3-previewHy3 preview (TokenHub)text256,00064,000Default; reasoning-enabled
Hy3 preview is Tencent Hunyuan’s large MoE language model for reasoning, long-context instruction following, code, and agent workflows. Tencent’s OpenAI-compatible examples use hy3-preview as the model id and support standard chat-completions tool calling plus reasoning_effort.
The model id is hy3-preview. Do not confuse it with Tencent’s HY-3D-* models, which are 3D generation APIs and are not the FluffBuzz chat model configured by this provider.

​
Endpoint override

FluffBuzz defaults to Tencent Cloud’s https://tokenhub.tencentmaas.com/v1 endpoint. Tencent also documents an international TokenHub endpoint: 
fluffbuzz config set models.providers.tencent-tokenhub.baseUrl "https://tokenhub-intl.tencentmaas.com/v1"
Only override the endpoint when your TokenHub account or region requires it.

​
Notes

  • TokenHub model refs use tencent-tokenhub/<modelId>.
  • The bundled catalog currently includes hy3-preview.
  • The plugin marks Hy3 preview as reasoning-capable and streaming-usage capable.
  • The plugin ships with tiered Hy3 pricing metadata, so cost estimates are populated without manual pricing overrides.
  • Override pricing, context, or endpoint metadata in models.providers only when needed.

​
Environment note

If the Gateway runs as a daemon (launchd/systemd), make sure TOKENHUB_API_KEY is available to that process (for example, in ~/.fluffbuzz/.env or via env.shellEnv).