Skip to main content
Call the SDK’s list method to read the model catalogue from GET /v1/models, with optional filters.

Filter the list

All filters are optional and have the same names in every SDK: they’re the query parameters. By default the list holds only routable models. Set availability to all to include the rest, then narrow it:
  • provider_availability_reason selects rollout states such as preview_only, provider_not_ready, gated, access_limited, region_limited, project_limited, paused or soft_blocked.
  • capability_status selects endpoint mappings that aren’t routable yet, such as coming_soon or internal_testing.

Check one model

checkParameters and its equivalents read live provider-route metadata, mark each parameter supported, partial, unsupported or unknown, check advertised values and ranges, and return the provider routes that accept the whole set. preflight does the same for a whole request body and adds the model’s lifecycle check, with an overall ok. “Next release” means the method is in the SDK source but not in the published package; see Check what each package ships. The deprecation-info methods return the model’s status (active, deprecated or retired), deprecation and retirement dates, and replacement model ID.

Response

ModelListResponse:
Last modified on November 5, 2026