Models.Retrieve - C# SDK

Trust: ★★★☆☆ (0.90) · 0 validations · developer_reference

Published: 2026-05-10 · Source: crawler_authoritative

Tình huống

C#/.NET SDK reference for retrieving model information from the Anthropic Claude API, targeting developers who need to resolve model aliases or query model capabilities.

Insight

The Models.Retrieve method retrieves metadata for a specific model or resolves an alias to a model ID. Method signature: ModelInfo Models.Retrieve(ModelRetrieveParams parameters, CancellationToken cancellationToken = default). Required parameter is ModelRetrieveParams containing modelID (string) - the model identifier or alias. Optional betas parameter accepts an IReadOnlyList of beta header identifiers. Supported beta values include: ‘message-batches-2024-09-24’, ‘prompt-caching-2024-07-31’, ‘computer-use-2024-10-22’, ‘computer-use-2025-01-24’, ‘pdfs-2024-09-25’, ‘token-counting-2024-11-01’, ‘token-efficient-tools-2025-02-19’, ‘output-128k-2025-02-19’, ‘files-api-2025-04-14’, ‘mcp-client-2025-04-04’, ‘mcp-client-2025-11-20’, ‘dev-full-thinking-2025-05-14’, ‘interleaved-thinking-2025-05-14’, ‘code-execution-2025-05-22’, ‘extended-cache-ttl-2025-04-11’, ‘context-1m-2025-08-07’, ‘context-management-2025-06-27’, ‘model-context-window-exceeded-2025-08-26’, ‘skills-2025-10-02’, ‘fast-mode-2026-02-01’, ‘output-300k-2026-03-24’, ‘user-profiles-2026-03-24’, ‘advisor-tool-2026-03-01’, ‘managed-agents-2026-04-01’. The response ModelInfo contains: ID (string), Capabilities (nested object with Batch, Citations, CodeExecution, ImageInput, PdfInput, StructuredOutputs support booleans), ContextManagement with ClearThinking20251015, ClearToolUses20250919, Compact20260112 flags, Effort with High/Low/Max/Medium/Xhigh support, Thinking with Supported boolean and Types containing Adaptive/Enabled capability support, CreatedAt (DateTimeOffset), DisplayName (string), MaxInputTokens and MaxTokens (Long?), and Type constant ‘model’.

Hành động

Create a ModelRetrieveParams instance with the ModelID property set to your target model ID or alias. Call client.Models.Retrieve(parameters) asynchronously. Optionally pass a CancellationToken. The returned ModelInfo object contains all model metadata including capabilities, token limits, and creation date. Example: ModelRetrieveParams parameters = new() { ModelID = "model_id" }; var modelInfo = await client.Models.Retrieve(parameters);

Kết quả

Returns a ModelInfo object containing the model’s unique identifier, capability flags (Batch, Citations, CodeExecution, ImageInput, PdfInput, StructuredOutputs), context management strategies, effort levels, thinking type support, RFC 3339 creation timestamp, display name, and maximum input/output token limits.

---

Nội dung gốc (Original)

Retrieve

ModelInfo Models.Retrieve(ModelRetrieveParamsparameters, CancellationTokencancellationToken = default)

get /v1/models/{model_id}

Get a specific model.

The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.

Parameters

• ModelRetrieveParams parameters

  • required string modelID

    Model identifier or alias.

  • IReadOnlyList<AnthropicBeta> betas

    Optional header to specify the beta version(s) you want to use.

    • "message-batches-2024-09-24"MessageBatches2024_09_24

    • "prompt-caching-2024-07-31"PromptCaching2024_07_31

    • "computer-use-2024-10-22"ComputerUse2024_10_22

    • "computer-use-2025-01-24"ComputerUse2025_01_24

    • "pdfs-2024-09-25"Pdfs2024_09_25

    • "token-counting-2024-11-01"TokenCounting2024_11_01

    • "token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19

    • "output-128k-2025-02-19"Output128k2025_02_19

    • "files-api-2025-04-14"FilesApi2025_04_14

    • "mcp-client-2025-04-04"McpClient2025_04_04

    • "mcp-client-2025-11-20"McpClient2025_11_20

    • "dev-full-thinking-2025-05-14"DevFullThinking2025_05_14

    • "interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14

    • "code-execution-2025-05-22"CodeExecution2025_05_22

    • "extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11

    • "context-1m-2025-08-07"Context1m2025_08_07

    • "context-management-2025-06-27"ContextManagement2025_06_27

    • "model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26

    • "skills-2025-10-02"Skills2025_10_02

    • "fast-mode-2026-02-01"FastMode2026_02_01

    • "output-300k-2026-03-24"Output300k2026_03_24

    • "user-profiles-2026-03-24"UserProfiles2026_03_24

    • "advisor-tool-2026-03-01"AdvisorTool2026_03_01

    • "managed-agents-2026-04-01"ManagedAgents2026_04_01

Returns

• class ModelInfo:

  • required string ID

    Unique model identifier.

  • required ModelCapabilities? Capabilities

    Model capability information.

    • required CapabilitySupport Batch

      Whether the model supports the Batch API.

      • required Boolean Supported

        Whether this capability is supported by the model.

    • required CapabilitySupport Citations

      Whether the model supports citation generation.

      • required Boolean Supported

        Whether this capability is supported by the model.

    • required CapabilitySupport CodeExecution

      Whether the model supports code execution tools.

      • required Boolean Supported

        Whether this capability is supported by the model.

    • required ContextManagementCapability ContextManagement

      Context management support and available strategies.

      • required CapabilitySupport? ClearThinking20251015

        Indicates whether a capability is supported.

        • required Boolean Supported

          Whether this capability is supported by the model.

      • required CapabilitySupport? ClearToolUses20250919

        Indicates whether a capability is supported.

        • required Boolean Supported

          Whether this capability is supported by the model.

      • required CapabilitySupport? Compact20260112

        Indicates whether a capability is supported.

        • required Boolean Supported

          Whether this capability is supported by the model.

      • required Boolean Supported

        Whether this capability is supported by the model.

    • required EffortCapability Effort

      Effort (reasoning_effort) support and available levels.

      • required CapabilitySupport High

        Whether the model supports high effort level.

        • required Boolean Supported

          Whether this capability is supported by the model.

      • required CapabilitySupport Low

        Whether the model supports low effort level.

        • required Boolean Supported

          Whether this capability is supported by the model.

      • required CapabilitySupport Max

        Whether the model supports max effort level.

        • required Boolean Supported

          Whether this capability is supported by the model.

      • required CapabilitySupport Medium

        Whether the model supports medium effort level.

        • required Boolean Supported

          Whether this capability is supported by the model.

      • required Boolean Supported

        Whether this capability is supported by the model.

      • required CapabilitySupport? Xhigh

        Indicates whether a capability is supported.

        • required Boolean Supported

          Whether this capability is supported by the model.

    • required CapabilitySupport ImageInput

      Whether the model accepts image content blocks.

      • required Boolean Supported

        Whether this capability is supported by the model.

    • required CapabilitySupport PdfInput

      Whether the model accepts PDF content blocks.

      • required Boolean Supported

        Whether this capability is supported by the model.

    • required CapabilitySupport StructuredOutputs

      Whether the model supports structured output / JSON mode / strict tool schemas.

      • required Boolean Supported

        Whether this capability is supported by the model.

    • required ThinkingCapability Thinking

      Thinking capability and supported type configurations.

      • required Boolean Supported

        Whether this capability is supported by the model.

      • required ThinkingTypes Types

        Supported thinking type configurations.

        • required CapabilitySupport Adaptive

          Whether the model supports thinking with type ‘adaptive’ (auto).

          • required Boolean Supported

            Whether this capability is supported by the model.

        • required CapabilitySupport Enabled

          Whether the model supports thinking with type ‘enabled’.

          • required Boolean Supported

            Whether this capability is supported by the model.

  • required DateTimeOffset CreatedAt

    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.

  • required string DisplayName

    A human-readable name for the model.

  • required Long? MaxInputTokens

    Maximum input context window size in tokens for this model.

  • required Long? MaxTokens

    Maximum value for the max_tokens parameter when using this model.

  • JsonElement Type "model"constant

    Object type.

    For Models, this is always "model".

Example

ModelRetrieveParams parameters = new() { ModelID = "model_id" };
 
var modelInfo = await client.Models.Retrieve(parameters);
 
Console.WriteLine(modelInfo);

Liên kết

• Nền tảng: Dev Framework · Anthropic
• Nguồn: https://platform.claude.com/docs/en/api/csharp/models/retrieve.md

Xem thêm:

• Retrieve Model - Anthropic Models API Beta Reference
• Retrieve Model - Anthropic Models API
• Archive Session Thread API
• Files API (Beta) - Ruby SDK Reference
• Claude Platform Release Notes Overview