Models
Models
List available models and retrieve model metadata.
Endpoint
GET /v1/modelsReturns the set of models currently registered with the LLM Controller. Each entry includes the model identifier, owning backend, and health status.
Example
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
| Field | Type | Description |
|---|---|---|
id | string | Unique model identifier used in model request fields |
object | string | Always model |
created | integer | Unix timestamp of registration |
owned_by | string | Owner 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
| Status | Type | Description |
|---|---|---|
| 401 | authentication_error | Invalid or missing API key |
| 503 | service_unavailable | LLM Controller unreachable or circuit breaker open |