Skip to content

Models

Models

List available models and retrieve model metadata.

Endpoint

GET /v1/models

Returns the set of models currently registered with the LLM Controller. Each entry includes the model identifier, owning backend, and health status.

Example

Terminal window
curl https://cryptgpt.co/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"

Response

{
"object": "list",
"data": [
{
"id": "gemma-4-26b",
"object": "model",
"created": 1718169600,
"owned_by": "cryptgpt"
}
]
}

Model Object

FieldTypeDescription
idstringUnique model identifier used in model request fields
objectstringAlways model
createdintegerUnix timestamp of registration
owned_bystringOwner of the model weights (cryptgpt, google, etc.)

Hot-Swap

Administrators may register or replace a model at runtime through the admin API. The LLM Controller validates the new entry, drains in-flight requests on the previous model, and atomically swaps the registry entry. A circuit breaker guards the rollout: five consecutive backend failures trigger a thirty-second cooldown before further traffic is routed to the new model.

Error Responses

StatusTypeDescription
401authentication_errorInvalid or missing API key
503service_unavailableLLM Controller unreachable or circuit breaker open