Skip to content

Price Vertex grounding and Sonar request fees - #97

Merged
VasiliyRad merged 5 commits into
mainfrom
claude/vertex-grounding-and-sonar-request-fees
Oct 5, 2026
Merged

VasiliyRad merged 5 commits into
mainfrom
claude/vertex-grounding-and-sonar-request-fees

Conversation

@VasiliyRad

@VasiliyRad VasiliyRad commented Oct 5, 2026 •

Copy link
Copy Markdown
Collaborator

What

Two search fees added to the retrieval section of prices.yaml:

  • google-vertex-ai / google_search_grounding: $14 per 1,000 grounding queries, effective 2026-01-05, Google's stated billing start for per-query grounding on Gemini 3 models.
  • perplexity-api / search_request_low|medium|high: $5, $8 and $12 per 1,000 requests, effective 2025-04-18. Low is Perplexity's default when a request names no search context size.

The perplexity/sonar token row keeps uncaptured_fees: true: nothing prices requests alongside tokens yet, so the row should still come out partial.

Evidence

  • Vertex pricing page (cloud.google.com/gemini-enterprise-agent-platform/generative-ai/pricing, read 2026-10-05): "Includes 5,000 Grounding Queries per month at no charge, aggregated across all Gemini 3 models. Grounding Queries exceeding those limits are billed at $14 per 1,000 Grounding Queries. You will be charged for each individual Grounding Query performed. Billing will start January 5, 2026." Gemini 2.5 and 2.0 are billed per grounded prompt at $35 per 1,000 after a daily allowance; they are not represented, since the retrieval catalog is keyed by channel and operation, not by model.
  • A production tenant's Gemini 3 calls on Vertex, billed through Portkey, cost a whole multiple of $0.014 above their token cost on every one of 2,562 calls checked (0 to 12 queries each). Calls without the google_search tool show no such difference.
  • Perplexity pricing page (read 2026-10-05): $5, $8 and $12 per 1,000 requests for low, medium and high search context, low by default, charged in addition to tokens. The same tenant's Sonar calls cost exactly $0.005 above tokens on every one of 3,175 calls, none naming a context size.

The free monthly allowance on Vertex is not modelled; a customer's invoice can be up to $70 a month below what these rows compute.

Checks

  • pytest core/tests -q: 795 passed (Python 3.12) before the date change; retrieval and loader tests rerun after it.
  • python core/tests/package/verify_artifacts.py: OK.
  • Catalog header version and pricing_verified_at unchanged; only these rows were verified.

Not in this PR

Applying retrieval prices to captured calls at ingest. The app prices tokens only, so these rows change nothing for customers until that lands.

🤖 Generated with Claude Code

VasiliyRad and others added 2 commits October 5, 2026 15:48
Two search fees were missing from the retrieval catalog.

Grounding with Google Search on Vertex AI had no row; only the Gemini API
channel carried the $14 per 1,000 queries price. Gateway-billed Vertex
traffic shows every grounded call costing a whole multiple of $0.014 above
its tokens, and Google's Gemini API pricing states the same per-query rate
for Gemini 3.x. The Vertex row is dated from the earliest traffic it was
checked against.

Perplexity Sonar carried only `uncaptured_fees: true`. Perplexity charges a
request fee on top of tokens by search context size: $5, $8 and $12 per
1,000 requests for low, medium and high, with low as the default. Gateway
billing shows exactly $0.005 per request on traffic that names no size. The
sonar token row keeps its flag until callers price requests alongside tokens.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
The Vertex pricing page states the per-query price directly: Gemini 3
models are charged $14 per 1,000 grounding queries after 5,000 free a
month, with billing from January 5, 2026. The row now carries that date
and the page that states it. Gemini 2.5 and 2.0 stay per grounded prompt
and are left out.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@VasiliyRad
VasiliyRad marked this pull request as ready for review October 5, 2026 22:59
VasiliyRad and others added 3 commits October 5, 2026 16:06
The catalog guide says a catalog change updates the declared version, and
the release gate ties the verified date to it.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@VasiliyRad
VasiliyRad merged commit b2be8f8 into main Oct 5, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant