Skip to content

docs: describe the region fields and filters of GPU offers - #152

Merged
justprosh merged 2 commits into
mainfrom
docs/gpu-region-fields
Nov 17, 2026
Merged

justprosh merged 2 commits into
mainfrom
docs/gpu-region-fields

Conversation

@justprosh

@justprosh justprosh commented Nov 17, 2026 •

Copy link
Copy Markdown
Member

What changed

  • GPU Cloud API, "Find an offer": regionLabel takes a region label exactly as offers show it in region.label. q matches the GPU vendor and the GPU model only.
  • GPU Cloud API, "Read an offer": region is described by its country and label. provider is fluence for every offer, dataCenter is null, and origin repeats the region.
  • GPU Cloud API, "Read an offer" and "Create the instance": osImages has an example name, and osImage must be one of the offer's osImages. The page no longer says that an empty list accepts any name.

How each fact was checked

Observed live on https://api.fluence.dev without credentials, on 393 offers from GET /v3/gpu/offers:

  • provider is fluence and dataCenter is null on every offer. origin has the provider and the label of region, and null in dataCenter and upstream.
  • region.country is null on 24 offers.
  • regionLabel with a label from an offer returned only offers with that label. q with a GPU model returned offers of that model, and q with a region label returned none.
  • Every VM and bare metal offer lists at least one OS image, and ubuntu-24.04-cuda12.8-docker is among the names.
  • price.components has one entry equal to perHour on every offer, as in the sample on the page.

Read from the published OpenAPI document, https://api.fluence.dev/v3/gpu/openapi.json:

  • The descriptions of regionLabel, q, osImages, and osImage.

npm run gate passes.

Not verified

  • A region.label passed back in requirements.region.label needs credentials and was not observed. It follows the OpenAPI document.
  • A create request with an osImage that the offer does not list was not sent.

@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 7:48am UTC

Request Review

@justprosh
justprosh marked this pull request as ready for review November 17, 2026 08:22
@justprosh
justprosh merged commit 29dcd29 into main Nov 17, 2026
3 checks passed
@justprosh
justprosh deleted the docs/gpu-region-fields branch November 17, 2026 09:46

This branch was successfully deployed

1 active deployment
Preview — c56238c0 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