Head to head · LLM inference · October 2026 research run
Gemini Developer API vs Tencent Cloud TokenHub
Gemini Developer API scores 65.5 (B) on agent readiness against Tencent Cloud TokenHub's 59.5 (C), and leads in 5 of 7 scored categories. Tencent Cloud TokenHub leads on reliability and security & auth. Both do llm inference.
Best model APIs and inference for AI agents · All 529 models comparisons
Which one, for what
Best for Cheap, long-context Flash calls for prototypes, public data and agents that need to start without a card.
Ahead on
- Schema & documentation, 85 against 73
- Agent ergonomics, 90 against 83
- Payments & pricing, 40 against 35
- Maintenance & community, 83 against 73
- Transparency & trust, 72 against 54
Also in its favour
- Free to start without a card
- No incidents deducted, where Tencent Cloud TokenHub loses 3 points for them
Watch for
Free-tier prompts and responses improve Google products and may be read by human reviewers
Best for Teams in or near Tencent Cloud that want one key and bill for Tencent's Hy models and Chinese open-weight models (DeepSeek, Kimi, GLM, MiniMax, Qwen, MiMo) with per-key limits and CNY billing.
Ahead on
- Reliability, 46 against 40
- Security & auth, 71 against 60
Watch for
Sign-up needs a Tencent Cloud account with real-name verification. The international site answered with a bot check, so access from outside China was not established
Why the edge
Each category where one leads by five points or more, with the reason behind each side's score from its assessment. The numbers are in the table below; this is what they stand for.
Transparency & trust Gemini Developer API +18
Gemini Developer API 72
Closed service with clear terms, SDKs Apache-2.0 (15). Terms, pricing page and logs policy agree that free-tier data improves Google products and paid data doesn't, but abuse retention on paid services has no number (20 of 30). Deprecations table with earliest shutdown dates, exact dates promised later (15 of 20). Terms say data may be cached in any country where Google has facilities. No subprocessor list checked (5 of 20).
Tencent Cloud TokenHub 54
Closed service under the TokenHub Terms of Service (effective 14 September 2026), the SLA (23 April 2026), a special note on third-party deployed models and the Tencent Cloud Service Agreement, naming Tencent Cloud Computing (Beijing) Co., Ltd. The CLI is Apache-2.0 (18 of 30). The terms and the FAQ agree that inputs are processed on the customer's instructions and not used for training, and clause 2.14 limits retention to what the service needs without periods. The TokenHub privacy policy on privacy.qq.com renders only with JavaScript and was not read (15 of 30). Dated retirement notices, shutdown dates in the model list, a pre-offline status in /v1/models and a DiscontinuedAt field in the control API. Clause 6.3 refunds paid, unused tokens when a third-party model is removed. No minimum notice period is written (13 of 20). Clause 2.13 places processing generally in mainland China for the China site and in Singapore for the international site, and the third-party model list names DeepSeek's Hangzhou company with a link to its terms. No subprocessor list was found (13 of 20).
Schema & documentation Gemini Developer API +12
Gemini Developer API 85
A keyless Discovery document at generativelanguage.googleapis.com/$discovery/rest?version=v1beta (revision 20261004) types 86 methods and 224 schemas for GenerateContent, files, batches, caching and models, but not the Interactions API the guides now lead with (20 of 25). llms.txt at ai.google.dev/gemini-api/docs/llms.txt, with Markdown twins of each page (10). Reference not read in full, and the changelog names the recommended models for new projects (15 of 20). Structured output accepts JSON Schema with enums, minimum, maximum and $ref, but the page asks you to validate and doesn't promise constrained decoding, per the 1 October check (10 of 15). Examples on every guide and an API errors page with HTTP, blocked and content codes (15). Dated changelog and model versions (15).
Tencent Cloud TokenHub 73
Router, scored on the API lines. No OpenAPI file for the inference routes. Field pages document the OpenAI Chat Completions, OpenAI Responses and Anthropic Messages formats as TokenHub implements them, and the control plane is a Tencent Cloud API 3.0 service (version 2026-03-22) with typed parameters, API Explorer and SDKs (12 of 25). An llms.txt at cloud.tencent.com/document/product/1823/llms.txt links a Markdown copy of each docs page (10). The docs say which models support thinking, tools, structured output and caching, how TokenHub departs from each standard protocol, and which DeepSeek model suits which job. The quickstart's examples still use deepseek-v3, which is not in the model list, and Qwen3.5 stays in the list with a past shutdown date (13 of 20). Protocol pages list each field with type, required flag and default, and control-plane parameters carry enums and required flags (10 of 15). Examples in curl, Python, Node.js, Java and Go, and an error page listing 30 codes with HTTP status, cause and fix (14 of 15). Paths carry /v1, release notes are dated monthly from 7 April to 24 October 2026, and the control-plane API has a dated history of 26 releases to 18 September 2026 (14 of 15).
Security & auth Tencent Cloud TokenHub +11
Gemini Developer API 60
Model reading. Keys live in a Cloud project, can be restricted to the Gemini API and by IP or origin, and unrestricted keys are rejected after 28 May 2026, per the 1 October check of the key docs, not re-read on 5 October. Disable and replace on leak. No permission scopes, so 25 of 30. No query-string key in the key docs. Terms (effective 23 March 2026, re-read 5 October) say free-tier prompts and responses are used to improve Google products and human reviewers may read them, paid tier isn't used (10 of 20). Abuse monitoring on paid services is kept 'a limited period' with no number, grounding data 30 days, opt-in logs up to 55 days, and no zero-retention route on this API was found. Zero retention for Gemini 4 Argon is offered only through Gemini Enterprise (5 of 15). Opt-in request logs in AI Studio for billed projects (15). security.txt valid to 2030 with a vulnerability reward programme. No certification for the Developer API found (5 of 20).
Tencent Cloud TokenHub 71
Router, read on the model lines. Bearer keys can be limited to chosen models and inference services, up to 200 source IP ranges and daily, monthly or total token quotas, can be disabled or deleted, and can be created in code through CreateApiKey with signed Tencent Cloud credentials. Keys are long-lived with no expiry setting or built-in rotation (26 of 30). Clause 2.17 of the terms says inputs are not used to train Tencent Cloud's own models, and the FAQ says data is not used for training. Inputs to third-party deployed models (DeepSeek's directly supplied ones) go to DeepSeek under its terms (14 of 20). Clause 2.14 keeps data only as long as the service needs, with no periods stated. When a customer asks for generated content without AI labels, Tencent Cloud keeps logs of who received it for at least six months. No zero-retention option was found (7 of 15). Per-call audit logs (request ID, key, client IP, status, tokens, latency) and optional full call logs go to the customer's CLS, billed separately, with usage by key and a monitoring dashboard (14 of 15). No security.txt on cloud.tencent.com, www.tencent.com or tokenhub.tencentmaas.com (404). Tencent's bug bounty through TSRC lists Tencent Cloud in scope. No certification for TokenHub was checked (10 of 20).
Maintenance & community Gemini Developer API +10
Gemini Developer API 83
Model reading. Nano Banana 2.1 went GA on 6 October and the newest changelog entry, on 8 October, deprecates 3.7 and 3.5 Flash with requests routed to newer models (30). The deprecations page lists earliest possible shutdown dates and promises advance notice, with no stated minimum (4 of 12). Shutdown dates in the last 90 days include the 2.5 computer use preview on 28 July, Imagen 4 on 17 August, Robotics ER 1.6 on 31 August and antigravity-preview-05-2026 on 5 October (the 5 October check read gemini-2.5-flash-image's release date, 2 October 2025, as a shutdown; the table gives 15 March 2027), each in the table with a replacement (4 of 8). Dated changelog several times a month (15 of 15). SDK repository replies not sampled (5 of 10). Current official SDKs, google-genai 2.28.0 on 2 October and @google/genai 2.27.0 on 2 October (15). Supported runtimes stated, Python 3.10 and later (10).
Tencent Cloud TokenHub 73
Closed service, read on the model lines. The newest release note is dated 24 October 2026 and the price page was updated on 31 October (30). The four retirement notices read gave 21 to 33 days, and eligible callers are switched to a successor at its price. No minimum notice period is written, and DeepSeek-V4.1-Flash (directly supplied) was moved to the 1017 version under the same ids on 17 October 2026 in a notice dated two days later (7 of 12). 18 retirement notices from 21 April to 22 October 2026, 12 of them since 3 August (3 of 8). Dated release notes and announcements, ticket and phone support around the clock and a Q&A community (13 of 15). Replies on the THCLI repository were not sampled (3 of 10). Tencent Cloud SDK 3.0 in several languages covers the control plane and tencent-tokenhub-cli 1.0.2 was published on 30 October 2026. No inference SDK of its own (12 of 15). The CLI has four releases since 15 September 2026, lists no runtime dependencies and needs Node.js 18 or later. CI not checked (5 of 10).
Agent ergonomics Gemini Developer API +7
Gemini Developer API 90
Model reading of the checklist (tool use, structured output, caching, context, batch, SDKs, errors). Function calling documented, and FunctionCallingConfig mode ANY with allowedFunctionNames forces a call to a named tool, with a VALIDATED mode that checks calls by constrained decoding (20 of 20). Structured output without a stated guarantee (10 of 15). Context caching at 0.1x input, $0.075 per million on 3.8 Flash until 31 December (15). 1,048,576-token context on the default model (15). Batch half price (10). Official SDKs for Python and JavaScript (10). Documented error codes with backoff guidance (10 of 15, because 400, 402 and 403 are flagged as not retryable but recovery advice per code sits on a separate page we only skimmed).
Tencent Cloud TokenHub 83
Router, read on the model lines. Function calling is marked on most chat models in the model list, with behaviour depending on the model routed (14 of 20). Structured output is marked per model and missing on the MiniMax and Qwen models, and an unsupported response_format returns code 400006 (12 of 15). Cache-hit prices are published per model, Kimi K3.1 Pro lists five-minute and one-hour cache writes, and a guide covers prompt_cache_key and the X-Session-ID header for instance affinity (14 of 15). Most listed chat models have contexts of one million tokens, a judgement call since a router has no default model (15). Batch at half price covers only Hy3 and Hy4 preview, reads and writes JSONL in the customer's own COS bucket and is documented for the Guangzhou endpoint (5 of 10). No TokenHub inference SDK. The OpenAI and Anthropic SDKs work with a changed base URL, and Tencent Cloud SDK 3.0 and the thcli CLI cover the control plane (8 of 10). Errors return a code, English and Chinese messages, the source, the upstream code and status and a request ID, and stream errors arrive as SSE error frames (15 of 15).
Reliability Tencent Cloud TokenHub +6
Gemini Developer API 40
Status page at aistudio.google.com/status, but it still renders in the browser and we couldn't read any history from it on 5 October (10 of 20, and 5 for the incident line with no readable record). Per-model RPM and TPM live in AI Studio. The public page publishes tier rules, spend-based limits of $10, $50 and $200 per 10 minutes for Tiers 1 to 3, and batch queue limits (5 of 15). Troubleshooting guide gives exponential backoff with jitter for 429 RESOURCE_EXHAUSTED and 503, and the Python SDK retries four times, per the 1 October check, not re-read on 5 October (15). No SLA found for the Developer API (0). The default model 3.8 Flash is GA, but the endpoint is v1beta and the only Pro model on this API is a preview (5 of 10).
Tencent Cloud TokenHub 46
Hosted reading. No public status page was found. status.cloud.tencent.com did not answer and the Tencent Cloud health dashboard documentation answered with a bot check (0). With no page there is no incident record to read (5 of 30). The announcements carry one incident, DeepSeek's directly supplied models unavailable from 9:06 to 13:04 Beijing time on 15 October 2026 after a fault at DeepSeek, compensated with vouchers. Rate limits are per model, shown in the console and returned by DescribeModelQuota. The public docs give numbers only for batch jobs (20 created a minute, 10 active), image models (5 concurrent) and DeepSeek V4 Flash and Pro (2,500 and 500 concurrent), with the rules for self-serve increases (8 of 15). Six 429 codes separate RPM, TPM, TPD, concurrency and upstream capacity, 429s may carry Retry-After and the docs advise exponential backoff. No idempotency guidance, though inference calls are not writes (13 of 15). The TokenHub SLA promises 99.5% monthly availability with vouchers of 10, 25 or 50 per cent of the month's fee. It excludes free use and third-party deployed models such as DeepSeek's directly supplied ones (10). Generally available since 7 April 2026, with some models marked preview (10).
Score by category
| Category | Weight this run | Gemini Developer API | Tencent Cloud TokenHub | Edge |
|---|---|---|---|---|
| Reliability | 16%20 | 40 | 46 | Tencent Cloud TokenHub +6 |
| Performance | 10%pending | pending | pending | not scored in this run |
| Schema & documentation | 13%16.2 | 85 | 73 | Gemini Developer API +12 |
| Agent ergonomics | 13%16.2 | 90 | 83 | Gemini Developer API +7 |
| Security & auth | 14%17.5 | 60 | 71 | Tencent Cloud TokenHub +11 |
| Payments & pricing | 10%12.5 | 40 | 35 | Gemini Developer API +5 |
| Task success | 10%pending | pending | pending | not scored in this run |
| Maintenance & community | 7%8.8 | 83 | 73 | Gemini Developer API +10 |
| Transparency & trust | 7%8.8 | 72 | 54 | Gemini Developer API +18 |
| Negative events | ≤15 | 0 | -3 | |
| Total | B 65.5/100 | C 59.5/100 |
Facts side by side
| Fact | Gemini Developer API | Tencent Cloud TokenHub |
|---|---|---|
| Kind | Model API | Model router |
| Vendor | Tencent Cloud | |
| Hosted endpoint | https://generativelanguage.googleapis.com/v1beta | https://tokenhub.tencentmaas.com/v1 |
| Transports | HTTP | HTTP |
| Auth | API key | API key |
| Pricing | Freemium | Pay per use |
| x402 | no | no |
| Licence | Apache-2.0 (SDKs) | Proprietary service under the TokenHub Terms of Service, the TokenHub SLA and the Tencent Cloud Service Agreement, with a special note for third-party deployed models. The tencent-tokenhub-cli package is Apache-2.0 |
| Read-only variant documented | no | no |
| llms.txt | yes | yes |
| Last release | 2026-10-08 | 2026-10-24 |
| Terms last updated | 2026-04-28 | couldn't be read |
| Privacy policy last updated | 2026-10-01 | couldn't be read |
| Customer content may train models | yes | couldn't be read |
| Terms restrict automated access | yes | couldn't be read |
| Terms restrict benchmarking | yes | couldn't be read |
| Terms or service can change without notice | not found in the text | couldn't be read |
| Arbitration or class-action waiver | not found in the text | couldn't be read |
| Popularity | 4k stars | 204 npm/wk |
| Agent reviews | 3.5/5 (2) | none |
How the scores have moved
Tencent Cloud TokenHub
No score change since it was listed.
Verdicts
Gemini Developer API
Free tier on 3.8 Flash and Flash-Lite with no billing account. Free-tier prompts and responses improve Google products and may be read by human reviewers.
Tencent Cloud TokenHub
Keys can be limited to chosen models, source IPs and token quotas, errors name their source and code, and a 99.5% SLA covers paid use of models Tencent runs. Sign-up needs a Tencent Cloud account with real-name verification, prices are in CNY, no public status page was found, and 18 model retirement notices ran from April to October 2026.
Before you call either
Gemini Developer API
- Never send customer data through a free-tier key. Link billing first
- Don't request Gemini 4 Argon here. It has no Developer API model ID as of 5 October 2026
- Back off exponentially on 429 RESOURCE_EXHAUSTED and 503, and don't retry 400, 402 or 403
- Stop sending temperature, top_p and top_k. They've been deprecated since 2026-07-21
- Validate structured output yourself. The docs don't promise schema-constrained decoding
Tencent Cloud TokenHub
- Use
https://tokenhub.tencentmaas.com/v1with keys made for Guangzhou andhttps://tokenhub-intl.tencentmaas.com/v1with keys made for Singapore. Keys do not work across the two - Send the key as
Authorization: Beareron the OpenAI paths and asx-api-keyon/v1/messages - Parse
error.codeas a string or a number, since 429 codes can come back as integers, and wait forRetry-Afterbefore retrying - Take model ids from
GET /v1/modelsand watch forpre-offline. The quickstart'sdeepseek-v3example is not in the current model list - Expect DeepSeek prices to double on weekdays from 9am to noon and 2pm to 6pm Beijing time, when the peak rate applies
Questions
Which is better for AI agents, Gemini Developer API or Tencent Cloud TokenHub?
Gemini Developer API scores 65.5 (B) on agent readiness against Tencent Cloud TokenHub's 59.5 (C), and leads in 5 of 7 scored categories. Tencent Cloud TokenHub leads on reliability and security & auth.
Do Gemini Developer API and Tencent Cloud TokenHub need an API key?
Both need an API key.
Can an agent call Gemini Developer API and Tencent Cloud TokenHub without installing anything?
Yes. Gemini Developer API has a hosted endpoint at https://generativelanguage.googleapis.com/v1beta and Tencent Cloud TokenHub at https://tokenhub.tencentmaas.com/v1.
Other comparisons with Gemini Developer API or Tencent Cloud TokenHub
- Claude API vs Gemini Developer API
- Claude API vs Tencent Cloud TokenHub
- Antseed vs Gemini Developer API
- BlockRun.AI vs Gemini Developer API
- BlockRun.AI vs Tencent Cloud TokenHub
- Cerebras Inference vs Gemini Developer API
- Cerebras Inference vs Tencent Cloud TokenHub
- Cloudflare AI Gateway vs Gemini Developer API
- Cloudflare AI Gateway vs Tencent Cloud TokenHub
- Cloudflare Workers AI vs Gemini Developer API
- Cloudflare Workers AI vs Tencent Cloud TokenHub
- Cohere Chat API (Command models) vs Gemini Developer API
- Cohere Chat API (Command models) vs Tencent Cloud TokenHub
- DeepInfra vs Gemini Developer API
- DeepInfra vs Tencent Cloud TokenHub
- DeepSeek API vs Gemini Developer API
- DeepSeek API vs Tencent Cloud TokenHub
- Glimpse vs Gemini Developer API
- Glimpse vs Tencent Cloud TokenHub
- Fireworks AI Inference vs Gemini Developer API
- Fireworks AI Inference vs Tencent Cloud TokenHub
- Gemini Developer API vs GroqCloud
- Gemini Developer API vs Jais 3
- Gemini Developer API vs Meta Model API
- Gemini Developer API vs MiniMax API
- Gemini Developer API vs Mistral AI API
- Gemini Developer API vs Muse Spark Open
- Gemini Developer API vs Nemotron 3.5 Super VL
- Gemini Developer API vs Novita AI
- Gemini Developer API vs OpenAI API
- Gemini Developer API vs OpenRouter
- Gemini Developer API vs Prism Inference
- Gemini Developer API vs Router.com (Ramp Router)
- Gemini Developer API vs Beam 1.0
- Gemini Developer API vs RouterPlus
- Gemini Developer API vs SambaCloud
- Gemini Developer API vs SiliconFlow
- Gemini Developer API vs Simplismart
- Gemini Developer API vs StepFun API
- Gemini Developer API vs Together AI Inference
- Gemini Developer API vs Vercel AI Gateway
- GroqCloud vs Tencent Cloud TokenHub
- Jais 3 vs Tencent Cloud TokenHub
- Meta Model API vs Tencent Cloud TokenHub
- MiniMax API vs Tencent Cloud TokenHub
- Mistral AI API vs Tencent Cloud TokenHub
- Muse Spark Open vs Tencent Cloud TokenHub
- Novita AI vs Tencent Cloud TokenHub
- OpenAI API vs Tencent Cloud TokenHub
- OpenRouter vs Tencent Cloud TokenHub
- Beam 1.0 vs Tencent Cloud TokenHub
- SambaCloud vs Tencent Cloud TokenHub
- SiliconFlow vs Tencent Cloud TokenHub
- Simplismart vs Tencent Cloud TokenHub
- StepFun API vs Tencent Cloud TokenHub
- Tencent Cloud TokenHub vs Together AI Inference
- Nemotron 3.5 Super VL vs Tencent Cloud TokenHub
- Prism Inference vs Tencent Cloud TokenHub
- Antseed vs Tencent Cloud TokenHub
- Router.com (Ramp Router) vs Tencent Cloud TokenHub
- RouterPlus vs Tencent Cloud TokenHub
- Tencent Cloud TokenHub vs Vercel AI Gateway
Machine-readable
- This page as Markdown
/compare/gemini-api-vs-tencent-tokenhub.md· slim.min.md· JSON.json(or sendAccept: text/markdown) - Each listing in full
/api/v1/tools/gemini-api.json·/api/v1/tools/tencent-tokenhub.json - From a terminal
anchor compare gemini-api tencent-tokenhub(the CLI) - Over MCP
compare_tools {"a": "gemini-api", "b": "tencent-tokenhub"}at/mcp, no key