What's free
One-time free package on first activation: 1,000,000 tokens shared across Hunyuan text/vision models (Hunyuan-a13b, Hunyuan-role-latest, Hunyuan-translation, Hunyuan-translation-lite, Tencent HY Vision 1.5 Instruct, Hunyuan-turbos-vision, Hunyuan-t1-vision, Hunyuan-turbos-vision-video), plus a separate 1,000,000 tokens for Hunyuan-embedding
- Credit card
- not required
- Phone verification
- not confirmed
- Commercial use
- not confirmed
Free limits
Numeric limits are not recorded in structured form for this provider.
In the provider's words
ChatCompletions (Tencent Cloud API): default 5 concurrent requests per account; GetEmbedding: 5 requests/second (both marked pre-offline, expected 2026-12-21). A limit of 20 requests/second for the other Hunyuan APIs is not stated on any official API page checked on 2026-10-08, so it is not confirmed
The catch
Free resource package valid 1 year from activation; unused tokens expire, and it does not roll into pay-as-you-go automatically. Activation requires Tencent Cloud real-name verification (enterprise or personal) — a practical barrier for many non-China users. Tencent says Hunyuan is migrating to TokenHub: the legacy platform will add no new models and stops supporting new model-service purchases; the legacy ChatCompletions and GetEmbedding APIs are marked pre-offline with expected shutdown 2026-12-21 (the OpenAI-compatible endpoint is the documented alternative), and the same API page (updated 2026-09-23) says the old Hunyuan console goes offline on 30 September. Whether new activations still receive the free package after the migration is not stated. Commercial-use terms not stated on the free-quota page.
Free models: not listed yet.
Quickstart — chat completions
from openai import OpenAI
client = OpenAI(base_url="https://api.hunyuan.cloud.tencent.com/v1", api_key="<YOUR_FREE_API_KEY>")
resp = client.chat.completions.create(
model="<a-free-model>",
messages=[{"role": "user", "content": "Hello!"}],
)
print(resp.choices[0].message.content)…or with curl:
curl https://api.hunyuan.cloud.tencent.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"<a-free-model>","messages":[{"role":"user","content":"Hello!"}]}'Appears in
Compare
Change history
How this free tier has changed since we started tracking it (2026-07-30) — generated from the git history of providers.json.
- 2026-10-09 Updated rate limits
- 2026-10-08 Updated the catch
- 2026-10-08 Updated free tier, rate limits, the catch
- 2026-08-14 Updated card requirement
- 2026-08-14 Updated the catch
- 2026-07-30 Added to the hub