List AI models

GET 
/ai/models

Returns available AI models. Three list modes:

• When action is omitted, returns all available models. - When action is list_by_modality, returns models whose enabled modality entries intersect both input_modality and output_modality. - When action is list_by_component, returns the models allow-listed for the given component. component is required; an unknown component returns IPV-1041.

Request

Responses

200

A page of AI models. Iterate by incrementing offset by limit while next_available is "yes", and stop when it is "no". next_available is a string ("yes" or "no"). total_count is the size of the full result set before pagination. For the default listing and action=list_by_modality, each item uses the listing projection documented by AIModelsListObject. For action=list_by_component, items are returned with full model metadata.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

400

Input validation failure. Body is {"Message": " - "}. Codes: IPV-1050 (limit above 1000), IPV-1041 (unknown action or component), IPV-1001 (component missing when action=list_by_component), GE-1010 (method/resource combination not routable).

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

500

Backend failure. Body is {"Message": " - "}. Codes: GE-1008 (catch-all), DB-1002 (DynamoDB failure).

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers