puter.ai.listModels()

Returns the AI chat/completion models that are currently available to your app. The list is pulled from the same source as the public /puterai/chat/models/details endpoint and includes pricing and capability metadata where available.

Syntax

puter.ai.listModels(provider = null)

Parameters

provider (String) (Optional)

A string containing the provider you want to list the models for.

Return value

Resolves to an array of model objects. Each object always contains id and provider, and may include fields such as name, aliases, context, max_tokens, and a cost object (currency, tokens, input and output costs in cents). Additional provider-specific capability fields may also be present.

Example model entry:

[
  {
    "id": "claude-opus-4-8",
    "provider": "claude",
    "name": "Claude Opus 4.8",
    "aliases": ["claude-opus-4-8-latest"],
    "context": 200000,
    "max_tokens": 64000,
    "cost": {
      "currency": "usd-cents",
      "tokens": 1000000,
      "input": 500,
      "output": 2500
    }
  }
]

Model variants

Some models have variants. A variant is the same model with a different price, rate limit, or speed. The variant is a suffix on the model ID, separated by a colon.

The model ID without a suffix is the standard variant. Not every model has variants. :flex and :priority are the provider's service tiers. To use a variant, pass its full ID as the model option. Options and response shape are the same as the base model. Price, context window, and max output length can differ. The model's page lists its variants and their limits.

Examples

<html>
<body>
    <script src="https://js.puter.com/v2/"></script>
    <script>
        (async () => {
            // Fetch all models
            const models = await puter.ai.listModels();
            puter.print('First model:', JSON.stringify(models[0]));
        })();
    </script>
</body>
</html>