AI Models

List the catalog of AI models available through the Hoody AI gateway. Use this endpoint to retrieve the current cached list of models along with their capabilities (modalities, context length) and Hoody pricing. Provider details are intentionally not exposed.

List available AI models

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

GET /api/v1/ai/models

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"
        }
      }
    ]
  }
}

Response fields

Field	Type	Description
statusCode	number	HTTP status code of the response
message	string	Human-readable status message
data	object	Response payload
data.updated_at	string | null	ISO 8601 timestamp of when the catalog was last updated
data.models	array	List of available AI models
data.models[].id	string	Model identifier (e.g. openai/gpt-4o)
data.models[].name	string	Display name of the model
data.models[].description	string | null	Short description of the model
data.models[].created	integer | null	Unix timestamp of the model’s upstream creation date
data.models[].context_length	integer | null	Maximum context length in tokens
data.models[].input_modalities	array	Supported input modalities (e.g. text, image, file)
data.models[].output_modalities	array	Supported output modalities (e.g. text)
data.models[].pricing	object	Hoody pricing map keyed by cost dimension (e.g. prompt, completion, image)

SDK usage

Node.js

const result = await client.api.ai.listModels();