New VDF AI Enterprise is now available on AWS Marketplace
API Reference

Models

The model catalogue lists the language models your deployment offers, as configured by your administrator. Use a model's model_name when you choose the model for an agent.

Each model belongs to a provider, the label the catalogue groups it under. Filter List models by provider to see one group, and retrieve a model for its context window, costs and supported features.

Endpoints 2

Paths are relative to /agent-hub-api

The model object

One catalogue entry.

Attributes

  • model_name string

    Unique identifier of the model in the catalogue. May contain /.

  • name string

    Display name of the model.

  • provider string

    Label the catalogue groups the model under.

  • type string

    Model type from the catalogue, for example chat.

  • context_window nullable integer

    Maximum context length in tokens, when known.

  • max_tokens nullable integer

    Maximum number of output tokens, when known.

  • cost_per_1k_input nullable number

    Cost of 1,000 input tokens, when known.

  • cost_per_1k_output nullable number

    Cost of 1,000 output tokens, when known.

  • supports_tools boolean

    Whether the model can call tools.

  • supports_streaming boolean

    Whether the model can stream its output.

  • supports_vision boolean

    Whether the model accepts images.

  • supports_json_mode boolean

    Whether the model supports structured JSON output.

  • supports_reasoning boolean

    Whether the model is a reasoning model.

  • temperature_supported boolean

    Whether the model accepts a temperature setting.

  • capabilities array of strings

    Capability labels, sorted, such as reasoning, tool_use and vision.

  • tags array of strings

    Free-form tags from the catalogue.

  • level nullable string

    Level label from the catalogue, when set.

  • regulated_approved boolean

    Whether the model is approved for use in regulated domains.

The model object 
{
  "provider": "meta-llama",
  "model_name": "meta-llama/llama-3.3-70b-instruct",
  "name": "Llama 3.3 70B Instruct",
  "type": "chat",
  "context_window": 131072,
  "max_tokens": 16384,
  "cost_per_1k_input": 0.0001,
  "cost_per_1k_output": 0.00032,
  "supports_tools": true,
  "supports_streaming": true,
  "supports_vision": false,
  "supports_json_mode": true,
  "supports_reasoning": false,
  "temperature_supported": true,
  "capabilities": [
    "tool_use"
  ],
  "tags": [
    "open-weights"
  ],
  "level": null,
  "regulated_approved": true
}

List models

GET /agent-hub-api/api/models

Returns the models in the catalogue, sorted by model_name.

Returns plain model names by default. Set detailed to get a short summary of each model; retrieve a model for all of its attributes.

Authentication
Bearer token How it works

Query parameters

  • provider string

    Only models whose provider is exactly this value. An unknown provider returns an empty list.

  • detailed boolean

    Set to true to return objects with model_name, name, provider and type instead of plain names.

    Defaults to false.

Returns

Returns data, a list of model names, or of model summaries when detailed is true.

Errors

  • 503 The model catalogue could not be loaded or is empty.
Request 
curl "$VDF_BASE_URL/agent-hub-api/api/models?detailed=true" \
  -H "Authorization: Bearer $VDF_ACCESS_TOKEN"
Response 200 
{
  "success": true,
  "data": [
    {
      "model_name": "meta-llama/llama-3.3-70b-instruct",
      "name": "Llama 3.3 70B Instruct",
      "provider": "meta-llama",
      "type": "chat"
    },
    {
      "model_name": "mistralai/mistral-small-3.2-24b-instruct",
      "name": "Mistral Small 3.2 24B Instruct",
      "provider": "mistralai",
      "type": "chat"
    }
  ]
}

Retrieve a model

GET /agent-hub-api/api/models/{name}

Returns one model from the catalogue.

Authentication
Bearer token How it works

Path parameters

  • name string Required

    The model's model_name. It may contain /, which you can send as is.

Returns

Returns data, the model object.

Errors

  • 404 No model with this name is in the catalogue.
  • 503 The model catalogue could not be loaded or is empty.
Request 
curl "$VDF_BASE_URL/agent-hub-api/api/models/meta-llama/llama-3.3-70b-instruct" \
  -H "Authorization: Bearer $VDF_ACCESS_TOKEN"
Response 200 
{
  "success": true,
  "data": {
    "provider": "meta-llama",
    "model_name": "meta-llama/llama-3.3-70b-instruct",
    "name": "Llama 3.3 70B Instruct",
    "type": "chat",
    "context_window": 131072,
    "max_tokens": 16384,
    "cost_per_1k_input": 0.0001,
    "cost_per_1k_output": 0.00032,
    "supports_tools": true,
    "supports_streaming": true,
    "supports_vision": false,
    "supports_json_mode": true,
    "supports_reasoning": false,
    "temperature_supported": true,
    "capabilities": [
      "tool_use"
    ],
    "tags": [
      "open-weights"
    ],
    "level": null,
    "regulated_approved": true
  }
}