yangmao.ai · cURL setup money page

Tencent Hunyuan cURL API Setup

Use cURL to smoke-test Tencent Hunyuan before wiring SDK code. Confirm the exact endpoint, model name, and quota in the provider dashboard.

Open official provider → Get one OpenAI-compatible key → Compare API gateway options →

Quick verdict

Free API: 100万 tokens
Rate limits: 5 RPM
Best model starting point: Hunyuan-Large
Mainland China access: direct or relatively friendly

Provider fit matrix

Best fit Image generation prototypes, creative automation, and media workflows

Watch out Image/video credits can burn faster than chat tokens; test with small batches first

Production fallback Keep at least one compatible backup provider before shipping

Production readiness checklist

Quota gate Start inside 100万 tokens; log usage before adding retries or batch jobs.

No-card check Try the free path first, then confirm whether billing is required for API keys, higher RPM, or production endpoints.

Regional smoke test Still run one request from your deployment region and from mainland China if users are there.

Source freshness Snapshot date: 2026-06-16; official quota and pricing can change without notice.

cURL smoke test

Use this to verify endpoint, auth header, model name, response shape, and quota before adding SDK abstractions.

curl https://api.hunyuan.cloud.tencent.com/v1/chat/completions \
  -H "Authorization: Bearer $HUNYUAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Hunyuan-Large",
    "messages": [{"role": "user", "content": "Hello from yangmao.ai"}]
  }'

Free API and pricing notes

100万 tokens

Free credits via Tencent Cloud

Access and production risk

Mainland China friendly / direct path likely

By Tencent, direct access in mainland China, enterprise-stable.

How to set it up

Create an API key and copy the provider endpoint from official docs.

Export the key into your shell session.

Send a minimal chat completion payload with cURL.

Check status code, JSON body, and rate-limit headers.

Move the tested endpoint into your app or fallback relay.

Tencent Hunyuan production validation table

Use this table before sending real users, scheduled agents, or paid traffic to Tencent Hunyuan. The goal is to validate source freshness, quota behavior, regional access, and fallback needs instead of trusting a stale free-credit claim.

Check Pass condition If it fails

Signup and billing state Key creation works and the account can spend the recorded 100万 tokens. Compare Tencent Hunyuan alternatives or route through a gateway before inviting users.

First request from target region A minimal request succeeds from your deployment region and mainland-China test point if relevant. Do not ship cron jobs or public demos until latency, DNS, TLS, and auth are repeatable.

Quota, retry, and error shape Rate-limit behavior matches the current 5 RPM note or official dashboard values. Cap retries, add request logging, and keep a second route for 429/5xx bursts.

Cost per accepted task Real prompts stay within your target token, query, image-credit, or compute budget. Use cheaper primary routes, caching, shorter prompts, or fallback only after validation failure.

额度变动提醒

想知道免费额度、价格或可用性变化？先订阅提醒，后续也可以对比官方平台、API 网关和同类替代方案。

订阅提醒 → 获取 OpenLLMAPI Key → 比较 API 网关 →

Source snapshot

Data source: yangmao.ai provider YAML tracker plus provider docs reviewed by the daily crawler. Official dashboards can change quota and pricing without notice; verify before production.

yangmao.ai provider id: hunyuan
Official source: https://hunyuan.tencent.com
Last updated: 2026-06-16
Free tier: No explicit limit
API credits: 100万 tokens
Rate limit: 5 RPM
Access note: By Tencent, direct access in mainland China, enterprise-stable.

FAQ

Does Tencent Hunyuan have a free API?

Yes. Current yangmao.ai record: 100万 tokens. Rate limit note: 5 RPM.

Is Tencent Hunyuan OpenAI-compatible?

The recorded setup uses an OpenAI-compatible pattern or SDK-style call. Validate the latest base URL and model names in Tencent Hunyuan docs.

Can I use Tencent Hunyuan from mainland China?

Tencent Hunyuan is marked as relatively direct or Mainland-China-friendly in the current tracker.

What should I do when Tencent Hunyuan credits run out?

Compare the alternatives below, check /en/free-ai-api/, and shortlist official providers or API gateway options before production.