Genesis Docs

Tencent Cloud TokenHub

Tencent Cloud ships as a bundled provider plugin in Genesis. It gives access to Tencent Hy3 preview through the TokenHub endpoint (tencent-tokenhub).

The provider uses an OpenAI-compatible API.

Property Value
Provider tencent-tokenhub
Default model tencent-tokenhub/hy3-preview
Auth TOKENHUB_API_KEY
API OpenAI-compatible chat completions
Base URL https://tokenhub.tencentmaas.com/v1
Global URL https://tokenhub-intl.tencentmaas.com/v1

Quick start

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.

Run onboarding

```bash
genesis onboard --auth-choice tokenhub-api-key
```

Verify the model

```bash
genesis models list --provider tencent-tokenhub
```

Non-interactive setup

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

Built-in catalog

Model ref Name Input Context Max output Notes
tencent-tokenhub/hy3-preview Hy3 preview (TokenHub) text 256,000 64,000 Default; 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 Genesis chat model configured by this provider.

Endpoint override

Genesis defaults to Tencent Cloud's https://tokenhub.tencentmaas.com/v1 endpoint. Tencent also documents an international TokenHub endpoint:

genesis 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 ~/.genesis/.env or via env.shellEnv).

Related documentation