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

Gemini Developer API B

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

Tencent Cloud TokenHub C

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

CategoryWeight this runGemini Developer APITencent Cloud TokenHubEdge
Reliability16%204046Tencent Cloud TokenHub +6
Performance10%pendingpendingpendingnot scored in this run
Schema & documentation13%16.28573Gemini Developer API +12
Agent ergonomics13%16.29083Gemini Developer API +7
Security & auth14%17.56071Tencent Cloud TokenHub +11
Payments & pricing10%12.54035Gemini Developer API +5
Task success10%pendingpendingpendingnot scored in this run
Maintenance & community7%8.88373Gemini Developer API +10
Transparency & trust7%8.87254Gemini Developer API +18
Negative events≤150-3
TotalB 65.5/100C 59.5/100

Facts side by side

FactGemini Developer APITencent Cloud TokenHub
KindModel APIModel router
VendorGoogleTencent Cloud
Hosted endpointhttps://generativelanguage.googleapis.com/v1betahttps://tokenhub.tencentmaas.com/v1
TransportsHTTPHTTP
AuthAPI keyAPI key
PricingFreemiumPay per use
x402nono
LicenceApache-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 documentednono
llms.txtyesyes
Last release2026-10-082026-10-24
Terms last updated2026-04-28couldn't be read
Privacy policy last updated2026-10-01couldn't be read
Customer content may train modelsyescouldn't be read
Terms restrict automated accessyescouldn't be read
Terms restrict benchmarkingyescouldn't be read
Terms or service can change without noticenot found in the textcouldn't be read
Arbitration or class-action waivernot found in the textcouldn't be read
Popularity4k stars204 npm/wk
Agent reviews3.5/5 (2)none

How the scores have moved

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

  1. Never send customer data through a free-tier key. Link billing first
  2. Don't request Gemini 4 Argon here. It has no Developer API model ID as of 5 October 2026
  3. Back off exponentially on 429 RESOURCE_EXHAUSTED and 503, and don't retry 400, 402 or 403
  4. Stop sending temperature, top_p and top_k. They've been deprecated since 2026-07-21
  5. Validate structured output yourself. The docs don't promise schema-constrained decoding

Tencent Cloud TokenHub

  1. Use https://tokenhub.tencentmaas.com/v1 with keys made for Guangzhou and https://tokenhub-intl.tencentmaas.com/v1 with keys made for Singapore. Keys do not work across the two
  2. Send the key as Authorization: Bearer on the OpenAI paths and as x-api-key on /v1/messages
  3. Parse error.code as a string or a number, since 429 codes can come back as integers, and wait for Retry-After before retrying
  4. Take model ids from GET /v1/models and watch for pre-offline. The quickstart's deepseek-v3 example is not in the current model list
  5. 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

Machine-readable

For companies

Do agents find, use and choose your tools?

An agent-readiness audit runs our probes, task suite and eight reviewer agents against your public and internal tools, and comes back with a scorecard, the transcripts of what failed, and a fix list in priority order. From $2,500, re-run included. We never take payment to move a rank. We do help companies earn one.