AI Models

List AI Models

The AI Models endpoint returns the current cached catalog of AI models available through the Hoody AI gateway. Use it to discover which models you can target, inspect their supported modalities, and review Hoody-specific pricing. Provider details are intentionally not exposed in this response.

`GET /api/v1/ai/models`

Returns the current cached catalog of available AI models. Pricing is returned as Hoody prices. Provider details are intentionally not exposed.

This endpoint takes no parameters.

Response (200)

{
  "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": "A balanced model optimized for reasoning and code generation.",
        "created": 1726012800,
        "context_length": 200000,
        "input_modalities": ["text", "image"],
        "output_modalities": ["text"],
        "pricing": {
          "prompt": "0.00000300",
          "completion": "0.00001500"
        }
      }
    ]
  }
}

Response fields

Field	Type	Required	Description
`statusCode`	number	Yes	HTTP-style status code for the response (always `200` for this endpoint)
`message`	string	Yes	Human-readable summary of the result
`data`	object	Yes	Catalog payload
`data.updated_at`	`null` \| string	Yes	ISO-8601 timestamp indicating when the catalog was last refreshed, or `null` if never updated
`data.models`	array	Yes	List of available AI models
`data.models[].id`	string	Yes	Model identifier (e.g. `openai/gpt-4o`)
`data.models[].name`	string	Yes	Human-readable model name
`data.models[].description`	`null` \| string	No	Short description of the model and its capabilities
`data.models[].created`	`null` \| integer	No	Unix timestamp (seconds) representing the upstream model’s release date
`data.models[].context_length`	`null` \| integer	No	Maximum context window in tokens
`data.models[].input_modalities`	array	No	Supported input modalities (e.g. `text`, `image`, `file`)
`data.models[].output_modalities`	array	No	Supported output modalities (e.g. `text`)
`data.models[].pricing`	object	Yes	Hoody pricing for the model, keyed by metric (e.g. `prompt`, `completion`, `image`)

SDK usage

TypeScript SDK

import { Hoody } from "@hoody/sdk";

const hoody = new Hoody({
  apiKey: process.env.HOODY_API_KEY,
});

const catalog = await hoody.api.ai.listModels();

console.log(catalog.data.models[0].id);
console.log(catalog.data.models[0].pricing);