Skip to content

docs: GPU offer search also matches the country and the region label - #153

Merged
justprosh merged 2 commits into
mainfrom
docs/gpu-offer-search-by-place
Nov 17, 2026
Merged

justprosh merged 2 commits into
mainfrom
docs/gpu-offer-search-by-place

Conversation

@justprosh

@justprosh justprosh commented Nov 17, 2026 •

Copy link
Copy Markdown
Member

What changed

  • GPU Cloud API, "Find an offer": q also matches a country code, a country name in English, and a region label.
  • GPU Cloud API, "Read an offer": region.label is the country code and a number, for example US-5, or LOC-4 when the country is not known.

How each fact was checked

  • Observed on api.fluence.dev on 2026-11-17 at 16:40 UTC, with GET /v3/gpu/offers without credentials:
    • q=DE, q=de, and q=germany return the same 6 offers as country=DE. q=US and q=united states return the same 235 offers as country=US.
    • q=US-5 and q=us-5 return the same 3 offers as regionLabel=US-5. q=DE-2 returns the same 6 offers as regionLabel=DE-2.
    • q=rtx and q=nvid still match the GPU model and the GPU vendor.
    • Every region label in the list is a country code and a number, such as US-5 and DE-2, or LOC and a number. The offers with the label LOC-4 have region.country set to null.
  • Offer groups and offer facets need credentials. Read through the Fluence MCP server with the tools gpu_listGpuOfferGroups and gpu_getGpuOfferFacets: q=DE and q=germany return the same 4 groups and the same counts as country=DE.
  • Read from the published OpenAPI document at https://api.fluence.dev/v3/gpu/openapi.json: q on the three offer calls names the GPU vendor or model, the country by code or English name, or a place label. Region.label is the country code and a number, with LOC where the country is unknown.
  • npm run gate passes.

Not verified

  • GET /v3/gpu/offer-groups and GET /v3/gpu/offer-facets were not called over REST directly. The checks above cover them through the MCP server and the OpenAPI document.

@vercel

vercel Bot commented Nov 17, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
fluence-dev-docs Ready Ready Preview Nov 17, 2026 4:43pm UTC

Request Review

@justprosh
justprosh marked this pull request as ready for review November 17, 2026 16:44
@justprosh
justprosh merged commit c3cfab5 into main Nov 17, 2026
3 checks passed
@justprosh
justprosh deleted the docs/gpu-offer-search-by-place branch November 17, 2026 16:47

This branch was successfully deployed

1 active deployment
Preview — 602c5b95 Deployed Nov 17, 2026 by vercel[bot]
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