AI Models

List available AI models

Returns the current cached catalog of AI models available through the Hoody AI gateway. Prices are returned as Hoody prices, and provider details are intentionally not exposed. Use this endpoint to enumerate model identifiers (for example, minimax/minimax-m3) before issuing chat or completion requests against the gateway.

`GET /api/v1/ai/models`

This endpoint takes no parameters.

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

import { HoodyClient } from 'hoody-sdk';

const client = new HoodyClient({ baseURL: 'https://api.hoody.com', token: process.env.HOODY_TOKEN });

await client.api.ai.listModels();

{
  "statusCode": 200,
  "message": "AI models retrieved successfully",
  "data": {
    "updated_at": "2025-12-12T20:00:00.000Z",
    "models": [
      {
        "id": "minimax/minimax-m3",
        "name": "MiniMax M3",
        "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"
        }
      }
    ]
  }
}

Response fields

Field	Type	Description
`statusCode`	number	HTTP-style status code returned by the gateway (always `200` for this endpoint).
`message`	string	Human-readable status message.
`data.updated_at`	null \| string	ISO 8601 timestamp of when the catalog was last refreshed, or `null` if never refreshed.
`data.models`	array	List of available AI models in the Hoody catalog.
`data.models[].id`	string	Stable model identifier. Use this value when invoking chat or completion endpoints.
`data.models[].name`	string	Human-readable display name for the model.
`data.models[].description`	null \| string	Short description of the model, or `null` when not provided.
`data.models[].created`	null \| integer	Unix epoch timestamp (seconds) indicating when the model was created upstream, or `null`.
`data.models[].context_length`	null \| integer	Maximum context window in tokens, or `null` if unknown.
`data.models[].input_modalities`	array	Modalities accepted as input (e.g. `text`, `image`, `file`).
`data.models[].output_modalities`	array	Modalities produced as output (e.g. `text`).
`data.models[].pricing`	object	Pricing map keyed by metric (such as `prompt`, `completion`, `image`). Values are strings representing Hoody prices.