AI Models

The AI Models endpoint returns the current cached catalog of models available through the Hoody AI gateway. Pricing is reported in Hoody prices; upstream provider details are intentionally not exposed. Use this endpoint when you need to discover which models are available, their context lengths, supported modalities, and current pricing before dispatching inference requests.

List AI models

`GET /api/v1/ai/models`

Returns the Hoody AI model catalog.

This endpoint takes no parameters.

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

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

Name	Type	Description
`statusCode`	`number`	HTTP-style status code returned by the catalog endpoint. Always `200` on success.
`message`	`string`	Human-readable status message.
`data.updated_at`	`string \| null`	Timestamp (ISO 8601) at which the cached catalog was last refreshed.
`data.models`	`array`	Array of model entries available through the gateway.
`data.models[].id`	`string`	Stable model identifier used when dispatching inference requests.
`data.models[].name`	`string`	Display name of the model.
`data.models[].description`	`string \| null`	Short description of the model, or `null` if none is available.
`data.models[].created`	`integer \| null`	Provider-reported creation timestamp (epoch seconds), or `null` if unknown.
`data.models[].context_length`	`integer \| null`	Maximum context window in tokens, or `null` if unspecified.
`data.models[].input_modalities`	`array`	Modalities the model accepts (for example `text`, `image`, `file`).
`data.models[].output_modalities`	`array`	Modalities the model can produce (for example `text`).
`data.models[].pricing`	`object`	Hoody-priced cost map. Common keys include `prompt`, `completion`, and `image`.