models

Resolve Model

Changed on

Resolve a model string (slug or id) to its catalog record.

General slug→id lookup: any client holding a model string (e.g. a trainable model's gateway slug) can map it to the id and metadata. Declared before /{model_id} so the literal resolve path is not parsed as an id; a query param (not a path segment) so slugs with / or : need no encoding. Team-scoping still hides other teams' private fine-tunes.

get/v2/models/resolve

Request

  • Base URL
    https://api.hud.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://api.hud.ai/v2/models/resolve
  • Auth
    none declared

Query parameters

modelstring required

Model slug (or id) to resolve to its catalog record

Response

Successful Response

idstring uuid required
model_namestring required
namestring nullable
routesstring[]
is_betaboolean
hiddenboolean
is_trainableboolean
publicboolean
checkpoint_countinteger nullable
inference_countinteger nullable

Lifetime platform-wide inference-call count. Null for signed-out callers.

fork_of_model_idstring uuid nullable
fork_of_model_namestring nullable
context_windowinteger nullable
sdk_agent_typestring required
input_cost_per_tokennumber nullable
output_cost_per_tokennumber nullable
pricing_configobject
request_defaultsobject
metadataobject
created_atstring date-time required
released_atstring date-time nullable

Vendor-published release time. Null until an admin sets it; not catalog insert time.

deprecated_atstring date-time nullable

Vendor retirement time. Null = not deprecated. A future value announces the date; once it passes, the gateway rejects requests for the model.

deprecation_messagestring nullable

Operator-set deprecation notice shown in the UI and returned on rejected requests.

can_editboolean

Changes