Head to head · LLM inference · October 2026 research run

Gemini Developer API vs Tencent Hy4

Gemini Developer API and Tencent Hy4 score within a point of each other on agent readiness, 64.7 (B) and 64 (B). Tencent Hy4 leads on security & auth. Both do llm inference.

Best model APIs and inference for AI agents · All 1044 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, and Gemini 4 Argon for long reasoning on the paid tier.

Ahead on

  • Schema & documentation, 85 against 73
  • Agent ergonomics, 93 against 86
  • Payments & pricing, 60 against 45
  • Maintenance & community, 83 against 73
  • Transparency & trust, 72 against 52

Also in its favour

  • A hosted endpoint, with nothing to install
  • Free to start without a card

Watch for

Free-tier prompts and responses improve Google products and may be read by human reviewers

Tencent Hy4 B

Best for Long-context agent work, coding and office or finance tasks on a 1M-token context with images, for teams already on Tencent Cloud or happy to verify an account there.

Ahead on

  • Security & auth, 71 against 50

Also in its favour

  • No incidents deducted, where Gemini Developer API loses 3 points for them

Watch for

Weights, licence and system card are promised but not published; tencent/Hy4 didn't answer on Hugging Face on 11 November

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.

Security & auth Tencent Hy4 +21

Gemini Developer API 50

Model reading. Keys live in a Cloud project. Since 28 May 2026 new keys are authorisation keys bound to a service account and restricted to the Gemini API, keys can be limited by IP or origin, unrestricted standard keys are rejected, and the docs give a leak checklist, per the API key page re-read on 1 November. No permission scopes, so 25 of 30, less 10 because the API reads a token from the URL. The Discovery document (revision 20261101) lists access_token, oauth_token and key as query parameters, and on 1 November a generateContent request with no credential answered 403 'Method doesn't allow unregistered callers' while one with a made-up ?access_token= answered 401 'Request had invalid authentication credentials' (ACCESS_TOKEN_TYPE_UNSUPPORTED), the deduction Google APIs took on 17 October and 1 November and Gemini Embedding and Gemini Live carry (15 of 30). Terms (effective 23 March 2026, re-read 1 November) 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, and since 26 October new paid projects store Generate Content requests by default unless store=false. No zero-retention route on this API was found (5 of 15). Request logs in AI Studio for billed projects (15). security.txt on google.com valid to 2030-04-01 with a vulnerability reward programme, re-read on 1 November. No certification naming the Developer API found, the reading Gemini Embedding takes (5 of 20).

Tencent Hy4 71

Model reading for hy4 on Tencent Cloud TokenHub. Platform facts are the tencent-tokenhub listing's (checked 1 November), carried over as RULES.md allows for a model on an already graded platform. Bearer keys limited by model, service, IP range and token quota, long-lived with no rotation (26 of 30). The terms say inputs aren't used to train Tencent Cloud's own models, and Hy4 is first party, so no third party's terms apply (14 of 20). Retention only as long as the service needs, no periods (7 of 15). Per-call audit logs and optional full logs to the customer's CLS (14 of 15). No security.txt; Tencent's TSRC bounty covers Tencent Cloud; no certification checked (10 of 20). 26 + 14 + 7 + 14 + 10 = 71.

Transparency & trust Gemini Developer API +20

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, and the 26 October changelog entry turns on request storage by default for new paid projects while existing projects keep their setting (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 Hy4 52

Model reading for hy4 on Tencent Cloud TokenHub. Platform facts are the tencent-tokenhub listing's (checked 1 November), carried over as RULES.md allows for a model on an already graded platform. Closed service under the TokenHub terms, but Tencent's release headline calls Hy4 open source while the weights and system card are only promised 'in the coming days', with no licence stated, and tencent/Hy4 didn't answer on Hugging Face on 11 November (14 of 30). Terms and FAQ agree inputs aren't used for training; the privacy policy renders only with JavaScript and wasn't read (15 of 30). Dated retirement notices and shutdown fields (13 of 20). Processing generally in mainland China for the China site, Singapore for the international one (13 of 20). Every benchmark in the release is Tencent's own or a partner's. 14 + 15 + 13 + 13 = 55.

Payments & pricing Gemini Developer API +15

Gemini Developer API 60

No machine payment protocol (0). Per-token prices published without a login, re-read on 1 November (20). Free tier on 3.8 Flash, 3.6 Flash, 3.5 Flash-Lite and 3.1 Flash-Lite, not on gemini-4-argon or 3.1 Pro preview, and the rate-limits page needs only an active project for the free tier and a linked billing account from Tier 1, so the free tier needs no card (20). A Google account and AI Studio are needed for a key (0). Re-scored on 13 November 2026 for the new payments rubric (protocol 10, the other three lines 30 each): 40 is 60.

Tencent Hy4 45

Model reading for hy4 on Tencent Cloud TokenHub. Platform facts are the tencent-tokenhub listing's (checked 1 November), carried over as RULES.md allows for a model on an already graded platform. No machine payment protocol (0). The price page, updated 9 November, lists ¥6 input, ¥0.3 cached and ¥18 output per million tokens, with Hy4 billed at 50% until 31 December 2026 (20). TokenHub's campaign of 1M free tokens per language model, read on 1 November, isn't confirmed for hy4 on the price page, so half (10 of 20, a judgement call). A person signs up with real-name verification (0). 0 + 20 + 10 + 0 = 30. Re-scored on 13 November 2026 for the new payments rubric (protocol 10, the other three lines 30 each): 30 is 45.

Schema & documentation Gemini Developer API +12

Gemini Developer API 85

A keyless Discovery document at generativelanguage.googleapis.com/$discovery/rest?version=v1beta (revision 20261101, re-read on 1 November) types 86 methods and 225 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 and latest-model guide name the recommended models (15 of 20). Structured output accepts JSON Schema with enums, minimum, maximum, prefixItems and $ref, but the server ignores minLength, maxLength, minProperties, maxProperties and uniqueItems, per the structured output page re-read on 1 November (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 Hy4 73

Model reading for hy4 on Tencent Cloud TokenHub. Platform facts are the tencent-tokenhub listing's (checked 1 November), carried over as RULES.md allows for a model on an already graded platform. No OpenAPI file for inference; field pages for the OpenAI and Anthropic formats as TokenHub implements them (12 of 25). llms.txt with Markdown copies (10). The model list, updated 9 November, gives hy4's context, input and output limits and marks thinking, structured output, function calling, caching and image understanding; computer use, which Tencent's release names, isn't marked (13 of 20). Typed field pages (10 of 15). Examples in five languages and an error page of 30 codes (14 of 15). Dated release notes, with hy4 added on 4 November (14 of 15). 12 + 10 + 13 + 10 + 14 + 14 = 73.

Maintenance & community Gemini Developer API +10

Gemini Developer API 83

Model reading. gemini-4-argon went GA on 13 October and the newest changelog entry, on 30 October, takes the Computer Use tool to GA (30). The deprecations page lists earliest possible shutdown dates and promises advance notice, with no stated minimum, and deep-research-pro-preview-12-2025 was announced on 8 October for shutdown on 23 October (4 of 12). Shutdown dates in the 90 days from 3 August include Imagen 4 on 17 August, Robotics ER 1.6 on 31 August, antigravity-preview-05-2026 on 5 October, the Veo 3.1 previews and gemini-omni-flash-preview on 22 October and deep-research-pro-preview-12-2025 on 23 October, each in the table with a replacement, and 3.7 and 3.5 Flash were deprecated on 8 October with requests routed to newer models (4 of 8). 16 dated changelog entries from 13 August to 30 October (15 of 15). SDK repository replies not sampled (5 of 10). Current official SDKs, google-genai 2.34.0 and @google/genai 2.32.0, both tagged on 29 October, with releases about weekly through October (15). Supported runtimes stated, Python 3.11 and later since 2.34.0 dropped 3.10, Node 20 and later (10).

Tencent Hy4 73

Model reading for hy4 on Tencent Cloud TokenHub. Platform facts are the tencent-tokenhub listing's (checked 1 November), carried over as RULES.md allows for a model on an already graded platform. Added on 4 November 2026 per the release notes; the model list and price page were updated on 9 November (30). Retirement notices of 21 to 33 days, no minimum written (7 of 12). Heavy retirement churn on the platform (3 of 8). Dated release notes and announcements, round-the-clock support (13 of 15). CLI replies not sampled (3 of 10). Control-plane SDKs and CLI, no inference SDK of its own (12 of 15). CLI runtime stated, CI not checked (5 of 10). 30 + 7 + 3 + 13 + 3 + 12 + 5 = 73. The model is a week old, so these lines are TokenHub's habits more than Hy4's record.

Agent ergonomics Gemini Developer API +7

Gemini Developer API 93

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). The structured output page, re-read on 1 November, says output adheres to the supplied JSON Schema and is syntactically correct JSON, and names the keywords constrained decoding doesn't enforce, while asking callers to validate values (13 of 15; the 12 October note's 10 rested on the page promising no constrained decoding). Context caching at 0.1x input, $0.075 per million on 3.8 Flash until 31 December, and implicit caching on gemini-4-argon, which doesn't support explicit caches (15). 1,048,576-token context on the default and flagship models (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 Hy4 86

Model reading for hy4 on Tencent Cloud TokenHub. Platform facts are the tencent-tokenhub listing's (checked 1 November), carried over as RULES.md allows for a model on an already graded platform. Function calling is marked for hy4 in the model list (18 of 20). Structured output marked (13 of 15). Cache-hit price published, ¥0.3 against ¥6 input (14 of 15). 1M-token context with 960K input and 64K output (15). Batch at half price covered Hy3 and Hy4 preview on 1 November; whether it covers hy4 wasn't re-read (3 of 10). OpenAI and Anthropic SDKs with a changed base URL, plus Tencent Cloud's SDK and CLI for the control plane (8 of 10). Errors with code, messages, upstream status and request ID (15 of 15). 18 + 13 + 14 + 15 + 3 + 8 + 15 = 86.

Score by category

CategoryWeight this runGemini Developer APITencent Hy4Edge
Reliability16%204546Tencent Hy4 +1
Performance10%pendingpendingpendingnot scored in this run
Schema & documentation13%16.28573Gemini Developer API +12
Agent ergonomics13%16.29386Gemini Developer API +7
Security & auth14%17.55071Tencent Hy4 +21
Payments & pricing10%12.56045Gemini Developer API +15
Task success10%pendingpendingpendingnot scored in this run
Maintenance & community7%8.88373Gemini Developer API +10
Transparency & trust7%8.87252Gemini Developer API +20
Negative events≤15-30
TotalB 64.7/100B 64/100

Facts side by side

FactGemini Developer APITencent Hy4
KindModel APIModel API
VendorGoogleTencent (Hy team)
Hosted endpointhttps://generativelanguage.googleapis.com/v1betano (local only)
TransportsHTTPHTTP
AuthAPI keyAPI key
PricingFreemiumPay per use
x402nono
LicenceApache-2.0 (SDKs)Hosted model under the Tencent Cloud TokenHub terms. Tencent says weights and a system card will follow; no licence is stated yet
Read-only variant documentednono
llms.txtyesyes
Last release2026-10-302026-11-04
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 starsnone
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, and Gemini 4 Argon is now GA on the paid tier. Free-tier prompts and responses improve Google products and may be read by human reviewers, and the API accepts an OAuth token in the URL query string.

Tencent Hy4

Tencent's flagship model is on TokenHub as hy4, with a 1M-token context, image understanding, function calling and caching, at ¥6 input and ¥18 output per million tokens, half price until the end of 2026. The weights it is called open source for aren't published yet, and every benchmark is Tencent's own.

Before you call either

Gemini Developer API

  1. Never send customer data through a free-tier key. Link billing first
  2. Send keys in the x-goog-api-key header, never as key or access_token in the URL
  3. Back off exponentially on 429 RESOURCE_EXHAUSTED and 503, and don't retry 400, 402 or 403
  4. Remove temperature, top_p and top_k. Gemini 4 and 3.6+ ignore them and a future release returns 400
  5. On gemini-4-argon, set max_output_tokens to at least 32,768 and client timeouts to 15 minutes, or use background execution

Tencent Hy4

  1. Use model id hy4 on TokenHub's OpenAI- or Anthropic-compatible endpoints; hy4-preview is a separate, older model
  2. Keep input under 960K tokens and expect at most 64K output
  3. Reuse prompt prefixes: cached input is ¥0.3 against ¥6
  4. Check the price page for the end of the 50% discount on 31 December 2026 before budgeting
  5. Read rate limits from the console or DescribeModelQuota; the public docs don't give them for chat models

Questions

Which is better for AI agents, Gemini Developer API or Tencent Hy4?

Gemini Developer API and Tencent Hy4 score within a point of each other on agent readiness, 64.7 (B) and 64 (B). Tencent Hy4 leads on security & auth.

Do Gemini Developer API and Tencent Hy4 need an API key?

Both need an API key.

Can an agent call Gemini Developer API and Tencent Hy4 without installing anything?

Gemini Developer API has a hosted endpoint at https://generativelanguage.googleapis.com/v1beta. No hosted endpoint is listed for Tencent Hy4.

Other comparisons with Gemini Developer API or Tencent Hy4

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.