Skip to main content
GET
/
v1
/
models
/
{model_id}
Retrieve a model
curl --request GET \
  --url https://api.perceptron.inc/v1/models/{model_id}
{
  "created": 123,
  "id": "<string>",
  "object": "<string>",
  "owned_by": "perceptron"
}

​
Overview

The Retrieve Model API returns a specific model by its ID. This endpoint is compatible with OpenAI’s model retrieval specification. Use the optional extended query parameter to retrieve detailed metadata about the model, including capabilities, supported input/output modalities, and token limits.

​
Examples

​
Retrieve a Model

Get basic information about a specific model: 
curl --location 'https://api.perceptron.inc/v1/models/perc-x1' \
--header 'Authorization: Bearer YOUR_API_KEY'

​
Get Extended Model Metadata

Retrieve detailed information about a model’s capabilities and limits: 
curl --location 'https://api.perceptron.inc/v1/models/perc-x1?extended=true' \
--header 'Authorization: Bearer YOUR_API_KEY'

​
Rate Limits

This endpoint is limited to 30 requests/min.

​
Use Cases

  • Model Validation: Verify a specific model exists and is available before making inference requests
  • Capability Checking: Check if a model supports specific features (structured outputs, video input, etc.)
  • Dynamic Configuration: Fetch model details to adapt UI or request parameters
  • Token Limit Validation: Check context and output limits before sending requests
See the API reference below for complete request/response schemas.

Path Parameters

​
model_id
string
required

The ID of the model to retrieve.

Query Parameters

​
extended
boolean

If true, returns extended model metadata including capabilities, modalities, and limits.

Response

The model with the given ID. Returns Model when extended=false (default), or ModelExtended when extended=true.

Response union for GET /v1/models/{model_id} endpoint. Returns Model when extended=false (default), or ModelExtended when extended=true.

​
created
integer<int64>
required

Unix timestamp when the model was created.

​
id
string
required

The model identifier.

​
object
string
required

Object type, always "model".

​
owned_by
enum<string>
required

The organization that owns the model.

Available options:
perceptron,
alibaba