AI Models

List AI Models

Returns the current cached catalog of AI models available through the Hoody AI gateway. Use this endpoint to discover available models and their Hoody-denominated pricing before initiating inference requests. Provider details are intentionally omitted from the response.

`GET /api/v1/ai/models`

This endpoint takes no parameters.

curl -X GET https://api.hoody.icu/api/v1/ai/models \
  -H "Authorization: Bearer <token>"

await client.api.ai.listModels();

{
  "statusCode": 200,
  "message": "AI models retrieved successfully",
  "data": {
    "updated_at": "2025-12-12T20:00:00.000Z",
    "models": [
      {
        "id": "openai/gpt-4o",
        "name": "GPT-4o",
        "description": "A multimodal model supporting text and image inputs.",
        "created": 1715558400,
        "context_length": 128000,
        "input_modalities": [
          "text",
          "image",
          "file"
        ],
        "output_modalities": [
          "text"
        ],
        "pricing": {
          "prompt": "0.00000263",
          "completion": "0.00001050",
          "image": "0.003793"
        }
      },
      {
        "id": "anthropic/claude-3.5-sonnet",
        "name": "Claude 3.5 Sonnet",
        "description": "Anthropic's mid-size model balancing capability and speed.",
        "created": 1720560000,
        "context_length": 200000,
        "input_modalities": [
          "text",
          "image"
        ],
        "output_modalities": [
          "text"
        ],
        "pricing": {
          "prompt": "0.00000300",
          "completion": "0.00001500"
        }
      }
    ]
  }
}

Response fields

Name	Type	Required	Description
`statusCode`	number	Yes	HTTP-style status code returned in the body
`message`	string	Yes	Human-readable description of the result
`data`	object	Yes	Container for the catalog payload
`data.updated_at`	null \| string	Yes	ISO 8601 timestamp of when the catalog was last refreshed, or `null` if not yet known
`data.models`	array	Yes	The list of available AI models
`data.models[].id`	string	Yes	Canonical model identifier (e.g. `openai/gpt-4o`) used when issuing inference requests
`data.models[].name`	string	Yes	Display name of the model
`data.models[].description`	null \| string	No	Short description of the model and its capabilities
`data.models[].created`	null \| integer	No	Unix timestamp (seconds) representing when the model was created upstream
`data.models[].context_length`	null \| integer	No	Maximum context window in tokens
`data.models[].input_modalities`	array	No	Supported input modality identifiers (e.g. `text`, `image`, `file`)
`data.models[].output_modalities`	array	No	Supported output modality identifiers (e.g. `text`)
`data.models[].pricing`	object	Yes	Hoody-denominated pricing keys (e.g. `prompt`, `completion`, `image`) mapped to cost-per-unit strings