Models API

UsageGuard supports a large number of models that can be used to generate content using our Unified Inference API. You can use the Models API to list all available models and their capabilities.

We are continuing to add more models and modalities as we grow and with customers feedback, please check back often.

GET/v1/management/models

List Available Models

Retrieve a list of all available AI models. Use this to see which models you can use for inference and their capabilities.

Required headers

Name
Authorization
Type
string
Description
Bearer token for authentication. Format: 'Bearer your-token-here'
Name
traceparent
Type
string
Description
OpenTelemetry trace parent for distributed tracing
Name
tracestate
Type
string
Description
OpenTelemetry trace state information

Query parameters

Name
page
Type
integer
Description
Page number for pagination. Defaults to 1.
Name
pageSize
Type
integer
Description
Number of items per page. Defaults to 10.

Request

GET

/v1/management/models

curl -X GET https://api.usageguard.com/v1/management/models?page=1&pageSize=10 \
  -H "Authorization: Bearer {token}" \
  -H "traceparent: {traceparent}" \
  -H "tracestate: {tracestate}"

{
  "items": [
    {
      "modelId": "openai-gpt4",
      "displayName": "GPT-4",
      "provider": "OpenAI",
      "capabilities": ["text-generation", "chat", "streaming"],
      "isEnabled": true,
      "isPremium": true,
      "maxTokens": 8192,
      "contextWindow": 8192
    }
  ],
  "page": 1,
  "pageSize": 10,
  "totalCount": 1
}

Error responses

401: Unauthorized

{
  "error": "Unauthorized",
  "message": "Invalid or expired token"
}

403: Forbidden

{
  "error": "Forbidden",
  "message": "Insufficient permissions"
}