SPB Git

Repository Public

models-list.md 7.9 KB 370 lines markdown

1---2title: List Models3url: https://platform.claude.com/docs/en/api/models/list4---56# List Models78**GET** `/v1/models`910List available models.1112The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.1314## Query parameters1516- `after_id: optional string`1718  ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.1920- `before_id: optional string`2122  ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.2324- `limit: optional number`2526  Number of items to return per page.2728  Defaults to `20`. Ranges from `1` to `1000`.2930  default: 20, maximum: 1000, minimum: 13132## Headers3334- `"anthropic-beta": optional array of AnthropicBeta`3536  Optional header to specify the beta version(s) you want to use.3738  - `string`3940  - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`4142    - `"message-batches-2024-09-24"`4344    - `"prompt-caching-2024-07-31"`4546    - `"computer-use-2024-10-22"`4748    - `"computer-use-2025-01-24"`4950    - `"pdfs-2024-09-25"`5152    - `"token-counting-2024-11-01"`5354    - `"token-efficient-tools-2025-02-19"`5556    - `"output-128k-2025-02-19"`5758    - `"files-api-2025-04-14"`5960    - `"mcp-client-2025-04-04"`6162    - `"mcp-client-2025-11-20"`6364    - `"dev-full-thinking-2025-05-14"`6566    - `"interleaved-thinking-2025-05-14"`6768    - `"code-execution-2025-05-22"`6970    - `"extended-cache-ttl-2025-04-11"`7172    - `"context-1m-2025-08-07"`7374    - `"context-management-2025-06-27"`7576    - `"model-context-window-exceeded-2025-08-26"`7778    - `"skills-2025-10-02"`7980    - `"fast-mode-2026-02-01"`8182    - `"output-300k-2026-03-24"`8384    - `"user-profiles-2026-03-24"`8586    - `"user-profiles-2026-08-18"`8788    - `"user-profiles-2026-09-04"`8990    - `"advisor-tool-2026-03-01"`9192    - `"managed-agents-2026-04-01"`9394    - `"cache-diagnosis-2026-04-07"`9596    - `"dreaming-2026-04-21"`9798    - `"thinking-token-count-2026-05-13"`99100    - `"server-side-fallback-2026-06-01"`101102    - `"server-side-fallback-2026-07-01"`103104    - `"fallback-credit-2026-06-01"`105106    - `"fallback-credit-2026-07-01"`107108    - `"agent-memory-2026-07-22"`109110    - `"mid-conversation-tool-changes-2026-07-01"`111112    - `"compact-2026-01-12"`113114    - `"computer-use-2025-11-24"`115116    - `"mcp-tunnels-2026-06-22"`117118    - `"structured-outputs-2025-11-13"`119120    - `"task-budgets-2026-03-13"`121122    - `"thinking-display-updates-2026-08-18"`123124    - `"ce-user-management-2026-07-13"`125126    - `"mid-conversation-output-config-2026-07-01"`127128    - `"thinking-binding-controls-2026-08-01"`129130    - `"mid-conversation-system-clear-at-2026-08-21"`131132    - `"compact-2026-09-04"`133134- `"anthropic-workspace-id": optional string`135136## Returns137138- `data: array of ModelInfo`139140  - `type: "model"`141142    Object type.143144    For Models, this is always `"model"`.145146    default: model147148  - `id: string`149150    Unique model identifier.151152  - `capabilities: ModelCapabilities or null`153154    Model capability information.155156    - `batch: CapabilitySupport`157158      Whether the model supports the Batch API.159160      - `supported: boolean`161162        Whether this capability is supported by the model.163164    - `citations: CapabilitySupport`165166      Whether the model supports citation generation.167168    - `code_execution: CapabilitySupport`169170      Whether the model supports code execution tools.171172    - `context_management: ContextManagementCapability`173174      Context management support and available strategies.175176      - `clear_thinking_20251015: CapabilitySupport or null`177178        Indicates whether a capability is supported.179180      - `clear_tool_uses_20250919: CapabilitySupport or null`181182        Indicates whether a capability is supported.183184      - `compact_20260112: CapabilitySupport or null`185186        Indicates whether a capability is supported.187188      - `supported: boolean`189190        Whether this capability is supported by the model.191192    - `effort: EffortCapability`193194      Effort (reasoning_effort) support and available levels.195196      - `high: CapabilitySupport`197198        Whether the model supports high effort level.199200      - `low: CapabilitySupport`201202        Whether the model supports low effort level.203204      - `max: CapabilitySupport`205206        Whether the model supports max effort level.207208      - `medium: CapabilitySupport`209210        Whether the model supports medium effort level.211212      - `supported: boolean`213214        Whether this capability is supported by the model.215216      - `xhigh: CapabilitySupport or null`217218        Indicates whether a capability is supported.219220    - `image_input: CapabilitySupport`221222      Whether the model accepts image content blocks.223224    - `pdf_input: CapabilitySupport`225226      Whether the model accepts PDF content blocks.227228    - `structured_outputs: CapabilitySupport`229230      Whether the model supports structured output / JSON mode / strict tool schemas.231232    - `thinking: ThinkingCapability`233234      Thinking capability and supported type configurations.235236      - `supported: boolean`237238        Whether this capability is supported by the model.239240      - `types: ThinkingTypes`241242        Supported thinking type configurations.243244        - `adaptive: CapabilitySupport`245246          Whether the model supports thinking with type 'adaptive' (auto).247248        - `enabled: CapabilitySupport`249250          Whether the model supports thinking with type 'enabled'.251252  - `created_at: string`253254    RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.255256    format: date-time257258  - `display_name: string`259260    A human-readable name for the model.261262  - `max_input_tokens: number or null`263264    Maximum input context window size in tokens for this model.265266  - `max_tokens: number or null`267268    Maximum value for the `max_tokens` parameter when using this model.269270- `first_id: string or null`271272  First ID in the `data` list. Can be used as the `before_id` for the previous page.273274- `has_more: boolean`275276  Indicates if there are more results in the requested page direction.277278- `last_id: string or null`279280  Last ID in the `data` list. Can be used as the `after_id` for the next page.281282## Example283284```bash285curl https://api.anthropic.com/v1/models \286    -H 'anthropic-version: 2023-06-01' \287    -H "X-Api-Key: $ANTHROPIC_API_KEY"288```289290### Response (200)291292```json293{294  "data": [295    {296      "id": "claude-opus-5",297      "capabilities": {298        "batch": {299          "supported": true300        },301        "citations": {302          "supported": true303        },304        "code_execution": {305          "supported": true306        },307        "context_management": {308          "clear_thinking_20251015": {309            "supported": true310          },311          "clear_tool_uses_20250919": {312            "supported": true313          },314          "compact_20260112": {315            "supported": true316          },317          "supported": true318        },319        "effort": {320          "high": {321            "supported": true322          },323          "low": {324            "supported": true325          },326          "max": {327            "supported": true328          },329          "medium": {330            "supported": true331          },332          "supported": true,333          "xhigh": {334            "supported": true335          }336        },337        "image_input": {338          "supported": true339        },340        "pdf_input": {341          "supported": true342        },343        "structured_outputs": {344          "supported": true345        },346        "thinking": {347          "supported": true,348          "types": {349            "adaptive": {350              "supported": true351            },352            "enabled": {353              "supported": true354            }355          }356        }357      },358      "created_at": "2026-07-24T00:00:00Z",359      "display_name": "Claude Opus 5",360      "max_input_tokens": 0,361      "max_tokens": 0,362      "type": "model"363    }364  ],365  "first_id": "first_id",366  "has_more": true,367  "last_id": "last_id"368}369```370
Files main
Menu

Theme