Skip to main content
GET
List models

Overview

Use the Models API to discover which models are available to you. Each model includes the endpoint families it supports and lifecycle metadata you can use to migrate away from deprecated or retired models.
Use supported_endpoint_types to choose the correct generation endpoint instead of relying only on model naming conventions.

Endpoints

  • GET https://api.siray.ai/v1/models
  • GET https://api.siray.ai/v1/models/{model}
Headers
  • Authorization: Bearer <SIRAY_API_TOKEN>
Path parameters

List response structure

Retrieve response structure

Fields

  • id: Model identifier used in request payloads.
  • object: Always model for each model item.
  • created: Unix timestamp attached to the model metadata.
  • owned_by: Owner derived from id. If the ID contains /, this is the part before the first /; otherwise it is the full model ID.
  • supported_endpoint_types: Endpoint families supported by the model. Empty array means the API could not determine a supported endpoint type.
  • status: Lifecycle state of the model. Values are listed below.
  • deprecated_at: Unix timestamp when the model was deprecated. Omitted when empty.
  • retired_at: Unix timestamp when the model was retired. Omitted when empty.
  • replaced_by: Replacement model ID. Omitted when empty.

Supported endpoint types

Lifecycle status values

Usage examples

List all models available to the token:
Retrieve one model:
For provider-qualified IDs that contain /, URL-encode the slash if your HTTP client does not preserve it in path parameters.

Authorizations

Authorization
string
header
required

API token passed as a Bearer token in the Authorization header.

Response

200 - application/json

Model list or an error envelope

OpenAI-compatible model list response.

success
boolean
required
data
object[]
required
object
string
required
Allowed value: "list"