List Models

Retrieve information about all available models, including their capabilities, pricing, and specifications.

Endpoint

GET https://api.assisters.dev/v1/models

Request

No request body required. Authentication is optional for this endpoint.

from openai import OpenAI

client = OpenAI(
    api_key="ask_your_api_key",
    base_url="https://api.assisters.dev/v1"
)

models = client.models.list()

for model in models.data:
    print(f"{model.id}: {model.owned_by}")

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'ask_your_api_key',
  baseURL: 'https://api.assisters.dev/v1'
});

const models = await client.models.list();

for (const model of models.data) {
  console.log(`${model.id}: ${model.owned_by}`);
}

curl https://api.assisters.dev/v1/models \
  -H "Authorization: Bearer ask_your_api_key"

Response

{
  "object": "list",
  "data": [
    {
      "id": "assisters-chat-v1",
      "object": "model",
      "created": 1704067200,
      "owned_by": "assisters",
      "category": "chat",
      "version": "1.0",
      "capabilities": {
        "chat_completion": true,
        "streaming": true,
        "function_calling": false
      },
      "pricing": {
        "input_price_per_million": 0.10,
        "output_price_per_million": 0.20,
        "currency": "usd"
      },
      "specifications": {
        "context_window": 128000,
        "max_output_tokens": 8192,
        "training_cutoff": "2025-01"
      },
      "status": "active"
    },
    {
      "id": "assisters-embed-v1",
      "object": "model",
      "created": 1704067200,
      "owned_by": "assisters",
      "category": "embedding",
      "version": "1.0",
      "capabilities": {
        "embeddings": true
      },
      "pricing": {
        "price_per_million_tokens": 0.01,
        "currency": "usd"
      },
      "specifications": {
        "max_tokens": 8192,
        "output_dimensions": 1024
      },
      "status": "active"
    }
  ]
}

Response Fields

objectstring

Always list

dataarray

Array of model objects with the following fields:

Get Single Model

Retrieve information about a specific model:

GET https://api.assisters.dev/v1/models/{model_id}

model = client.models.retrieve("assisters-chat-v1")
print(f"Context window: {model.specifications.context_window}")

const model = await client.models.retrieve('assisters-chat-v1');
console.log(`Context window: ${model.specifications.context_window}`);

curl https://api.assisters.dev/v1/models/assisters-chat-v1 \
  -H "Authorization: Bearer ask_your_api_key"

Available Models by Category

Chat & Reasoning Models

Model	Context	Input Price	Output Price
`assisters-chat-v1`	128K	$0.10/M	$0.20/M
`assisters-vision-v1`	128K	$0.05/M	$0.10/M
`assisters-code-v1`	128K	$0.10/M	$0.20/M

Embedding Models

Model	Dimensions	Max Tokens	Price
`assisters-embed-v1`	1024	8192	$0.01/M

Moderation Models

Model	Categories	Price
`assisters-moderation-v1`	14	$0.05/M

Reranking Models

Model	Max Documents	Price
`assisters-rerank-v1`	100	$0.02/M

Audio Models

Model	Capability	Price
`assisters-whisper-v1`	Speech-to-text	$0.006/min
`assisters-tts-v1`	Text-to-speech	$15.00/M chars

Image Models

Model	Capability	Price
`assisters-image-v1`	Image generation	$0.020/image

Detailed Model Comparison

See full specifications and capabilities for all models

Filtering Models

Filter models by category in your code:

models = client.models.list()

# Get only chat models
chat_models = [m for m in models.data if m.category == "chat"]

# Get only embedding models
embedding_models = [m for m in models.data if m.category == "embedding"]

# Get active models only
active_models = [m for m in models.data if m.status == "active"]

Model Status

Status	Description
`active`	Fully available and recommended for use
`beta`	Available but may change without notice
`deprecated`	Still available but will be removed; migrate to alternatives

We announce deprecations at least 3 months in advance. Check the changelog for updates.

Caching

The models endpoint has a 5-minute cache. For real-time availability, check the status page.

Cache-Control: public, max-age=300

List Models

Model Object

Detailed Model Comparison

On this page