Skip to main content
GET
/
v1
/
models
List available models
curl --request GET \
  --url https://api.perceptron.inc/v1/models
{
  "data": [
    {
      "created": 123,
      "id": "<string>",
      "object": "<string>",
      "owned_by": "perceptron"
    }
  ],
  "object": "<string>"
}

​
Overview

The Models API returns a list of models available in the Perceptron API. This endpoint is compatible with OpenAI’s model listing specification. Use the optional extended query parameter to retrieve detailed metadata about each model, including capabilities, supported input/output modalities, and token limits.

​
Authentication

All requests require an Authorization header with your API key: 
Authorization: Bearer YOUR_API_KEY

​
Examples

​
List Available Models

Retrieve a basic list of all available models: 
curl --location 'https://api.perceptron.inc/v1/models' \
--header 'Authorization: Bearer YOUR_API_KEY'

​
Get Extended Model Metadata

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

​
Rate Limits

This endpoint is limited to 30 requests/min.

​
Use Cases

  • Model Discovery: Query available models before making inference requests
  • Capability Checking: Verify a model supports specific features (structured outputs, video input, etc.)
  • Dynamic Configuration: Build UIs that adapt to model capabilities
  • Token Limit Validation: Check context and output limits before sending requests
See the API reference below for complete request/response schemas.

Query Parameters

​
extended
boolean

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

Response

List of available models. Returns GetModelsResponse when extended=false (default), or GetModelsExtendedResponse when extended=true.

Response union for GET /v1/models endpoint. Returns GetModelsResponse when extended=false (default), or GetModelsExtendedResponse when extended=true.

​
data
object[]
required

List of available models.

​
object
string
required

Object type, always "list".