Apertis Docs

Utilities

Models

Updated
Reading time
2 min
Edit this page

On this page
/v1/models

List all models

Returns available models in OpenAI-compatible format. The response depends on your API key type:

  • Standard API key (sk-): Returns all publicly available models
  • Subscription API key (sk-sub-): Returns only models included in your subscription plan

HTTP Request

cURL

curl https://api.apertis.ai/v1/models \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <APERTIS_API_KEY>"

Python

from openai import OpenAI

client = OpenAI(
    api_key="<APERTIS_API_KEY>",
    base_url="https://api.apertis.ai/v1"
)

for model in client.models.list():
    print(model.id)

JavaScript

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: '<APERTIS_API_KEY>',
  baseURL: 'https://api.apertis.ai/v1'
});

for await (const model of client.models.list()) {
  console.log(model.id);
}
  • <APERTIS_API_KEY>: Your API key

Response (Standard Key)

{
  "object": "list",
  "data": [
    {
      "id": "gpt-5.5",
      "object": "model",
      "created": 1626777600,
      "owned_by": "OpenAI",
      "root": "gpt-5.5",
      "parent": null
    }
  ]
}

Response (Subscription Key)

When using a subscription API key, the response includes additional fields to help you understand quota costs:

{
  "object": "list",
  "data": [
    {
      "id": "claude-sonnet-4-6",
      "object": "model",
      "created": 1626777600,
      "owned_by": "Anthropic",
      "root": "claude-sonnet-4-6",
      "parent": null,
      "multiplier": 2.1,
      "tier": "pro",
      "context_length": 1000000
    },
    {
      "id": "gemini-2.5-flash-preview",
      "object": "model",
      "created": 1626777600,
      "owned_by": "Google",
      "root": "gemini-2.5-flash-preview",
      "parent": null,
      "multiplier": 0,
      "tier": "free"
    }
  ]
}
Field Description
multiplier Quota cost multiplier. 0 means the model is free and does not consume quota
tier The plan tier where this model originates (free, lite, pro, max)
context_length Maximum context window size in tokens (when available)

Plan Model Access

Models are organized by tier with inheritance — higher-tier plans include all models from lower tiers:

Plan Accessible Models
Lite Lite + Free models
Pro Pro + Lite + Free models
Max Max + Pro + Lite + Free models

Retrieve a model

Returns details for a single model.

HTTP Request

cURL

curl https://api.apertis.ai/v1/models/gemini-2.5-flash-preview \
    -H "Authorization: Bearer <APERTIS_API_KEY>"

Python

from openai import OpenAI

client = OpenAI(
    api_key="<APERTIS_API_KEY>",
    base_url="https://api.apertis.ai/v1"
)

model = client.models.retrieve("gemini-2.5-flash-preview")
print(model.id, model.owned_by)

JavaScript

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: '<APERTIS_API_KEY>',
  baseURL: 'https://api.apertis.ai/v1'
});

const model = await client.models.retrieve('gemini-2.5-flash-preview');
console.log(model.id, model.owned_by);

Response

Returns the model object if found. When using a subscription key, only models within your plan are accessible — requesting a model outside your plan returns a model_not_found error.

Python Example

from openai import OpenAI

client = OpenAI(
    api_key="sk-sub-your-subscription-key",
    base_url="https://api.apertis.ai/v1"
)

# List models available in your plan
models = client.models.list()
for model in models:
    print(model.id)

# Retrieve a specific model
model = client.models.retrieve("claude-sonnet-4-6")
print(model.id, model.owned_by)

Node.js Example

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-sub-your-subscription-key',
  baseURL: 'https://api.apertis.ai/v1'
});

// List models available in your plan
const models = await client.models.list();
for await (const model of models) {
  console.log(model.id);
}