> ## Documentation Index
> Fetch the complete documentation index at: https://docs.b3os.org/llms.txt
> Use this file to discover all available pages before exploring further.

# List AI Models

List AI models available via OpenRouter (Anthropic, OpenAI, Google, Meta, DeepSeek, etc.) with context window and USD pricing per 1M tokens. Supports an optional search filter on id/name. Ideal for: discovering valid 'model' values for the AI Prompt action, comparing model pricing.

![List AI Models logo](https://ai-icon.b3.fun/logo/openrouter)
Catalog action Utility

List AI models available via OpenRouter (Anthropic, OpenAI, Google, Meta, DeepSeek, etc.) with context window and USD pricing per 1M tokens. Supports an optional search filter on id/name. Ideal for: discovering valid 'model' values for the AI Prompt action, comparing model pricing.


## At a Glance

| Field | Value |
| --- | --- |
| Action ID | `openrouter-list-models` |
| Category | Utility |
| Connector | Not required |
| Requires gas | No |
| Funds movement | None declared |
| Tags | `ai`, `llm`, `openrouter`, `utility`, `read` |

## Payload Schema

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `search` | `string` | No | Optional case-insensitive filter matched against model id and name \(e.g., 'claude', 'gpt-5', 'gemini'\). Omit to list the full catalog. |

## Result Schema

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `models` | `array` | Yes | Available OpenRouter models, newest first \(catalog order\) |
| `count` | `number` | Yes | Number of models returned |

## Examples

**Workflow node**

```json
{
  "type": "openrouter-list-models",
  "payload": {
    "search": "claude"
  },
  "children": []
}
```
  **Test with API**

```bash
curl -X POST "https://api.b3os.org/v1/actions/openrouter-list-models/test" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "inputs": {
    "search": "claude"
  }
}'
```

**Use expressions for dynamic values**

Payload fields can use workflow expressions such as `{{$trigger.body.amount}}`, `{{$nodes.fetch.result.price}}`, and `{{$props.asset}}` when the value should come from a trigger, prior node, or reusable workflow prop.