Retrieve Model - Anthropic Models API (Go SDK)

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

Published: 2026-05-10 · Source: crawler_authoritative

Tình huống

Guide for using the Anthropic Go SDK to retrieve information about a specific model or resolve a model alias to a model ID.

Insight

The Models.Get method retrieves a specific model by ID or alias using the endpoint GET /v1/models/{model_id}. The method signature is client.Models.Get(ctx, modelID, query) (*ModelInfo, error). The modelID parameter accepts either a model identifier string or an alias. The optional ModelGetParams query parameter includes Betas field (param.Field[[]AnthropicBeta]) to specify beta versions. Available beta constants include: AnthropicBetaMessageBatches2024_09_24, AnthropicBetaPromptCaching2024_07_31, AnthropicBetaComputerUse2024_10_22, AnthropicBetaComputerUse2025_01_24, AnthropicBetaPDFs2024_09_25, AnthropicBetaTokenCounting2024_11_01, AnthropicBetaTokenEfficientTools2025_02_19, AnthropicBetaOutput128k2025_02_19, AnthropicBetaFilesAPI2025_04_14, AnthropicBetaMCPClient2025_04_04, AnthropicBetaMCPClient2025_11_20, AnthropicBetaDevFullThinking2025_05_14, AnthropicBetaInterleavedThinking2025_05_14, AnthropicBetaCodeExecution2025_05_22, AnthropicBetaExtendedCacheTTL2025_04_11, AnthropicBetaContext1m2025_08_07, AnthropicBetaContextManagement2025_06_27, AnthropicBetaModelContextWindowExceeded2025_08_26, AnthropicBetaSkills2025_10_02, AnthropicBetaFastMode2026_02_01, AnthropicBetaOutput300k2026_03_24, AnthropicBetaUserProfiles2026_03_24, AnthropicBetaAdvisorTool2026_03_01, and AnthropicBetaManagedAgents2026_04_01. The returned ModelInfo struct contains: ID (string), Capabilities (ModelCapabilities with Batch, Citations, CodeExecution, ContextManagement, Effort, ImageInput, PDFInput, StructuredOutputs, and Thinking support), CreatedAt (RFC 3339 datetime), DisplayName (human-readable name), MaxInputTokens (int64), MaxTokens (int64), and Type (constant ModelModel = “model”).

Hành động

Initialize the client with option.WithAPIKey(“your-api-key”), then call client.Models.Get with context, model ID string, and empty or populated ModelGetParams struct. Handle the returned ModelInfo and error. Example usage: modelInfo, err := client.Models.Get(context.TODO(), “model_id”, anthropic.ModelGetParams{}). The modelInfo response can determine model capabilities, resolve aliases, and get metadata like max tokens and supported features.

Kết quả

Returns a ModelInfo struct containing the model ID, capability information (including batch support, citations, code execution, context management strategies, effort levels, thinking types), creation timestamp, display name, input/output token limits, and object type. Returns error if the model is not found or request fails.

Điều kiện áp dụng

Requires github.com/anthropics/anthropic-sdk-go package


Nội dung gốc (Original)

Retrieve

client.Models.Get(ctx, modelID, query) (*ModelInfo, error)

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

  • modelID string

    Model identifier or alias.

  • query ModelGetParams

    • Betas param.Field[[]AnthropicBeta]

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

      • string

      • type AnthropicBeta string

        • const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"

        • const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"

        • const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"

        • const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"

        • const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"

        • const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"

        • const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"

        • const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"

        • const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"

        • const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"

        • const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"

        • const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"

        • const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"

        • const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"

        • const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"

        • const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"

        • const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"

        • const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"

        • const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"

        • const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"

        • const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"

        • const AnthropicBetaUserProfiles2026_03_24 AnthropicBeta = "user-profiles-2026-03-24"

        • const AnthropicBetaAdvisorTool2026_03_01 AnthropicBeta = "advisor-tool-2026-03-01"

        • const AnthropicBetaManagedAgents2026_04_01 AnthropicBeta = "managed-agents-2026-04-01"

Returns

  • type ModelInfo struct{…}

    • ID string

      Unique model identifier.

    • Capabilities ModelCapabilities

      Model capability information.

      • Batch CapabilitySupport

        Whether the model supports the Batch API.

        • Supported bool

          Whether this capability is supported by the model.

      • Citations CapabilitySupport

        Whether the model supports citation generation.

        • Supported bool

          Whether this capability is supported by the model.

      • CodeExecution CapabilitySupport

        Whether the model supports code execution tools.

        • Supported bool

          Whether this capability is supported by the model.

      • ContextManagement ContextManagementCapability

        Context management support and available strategies.

        • ClearThinking20251015 CapabilitySupport

          Indicates whether a capability is supported.

          • Supported bool

            Whether this capability is supported by the model.

        • ClearToolUses20250919 CapabilitySupport

          Indicates whether a capability is supported.

          • Supported bool

            Whether this capability is supported by the model.

        • Compact20260112 CapabilitySupport

          Indicates whether a capability is supported.

          • Supported bool

            Whether this capability is supported by the model.

        • Supported bool

          Whether this capability is supported by the model.

      • Effort EffortCapability

        Effort (reasoning_effort) support and available levels.

        • High CapabilitySupport

          Whether the model supports high effort level.

          • Supported bool

            Whether this capability is supported by the model.

        • Low CapabilitySupport

          Whether the model supports low effort level.

          • Supported bool

            Whether this capability is supported by the model.

        • Max CapabilitySupport

          Whether the model supports max effort level.

          • Supported bool

            Whether this capability is supported by the model.

        • Medium CapabilitySupport

          Whether the model supports medium effort level.

          • Supported bool

            Whether this capability is supported by the model.

        • Supported bool

          Whether this capability is supported by the model.

        • Xhigh CapabilitySupport

          Indicates whether a capability is supported.

          • Supported bool

            Whether this capability is supported by the model.

      • ImageInput CapabilitySupport

        Whether the model accepts image content blocks.

        • Supported bool

          Whether this capability is supported by the model.

      • PDFInput CapabilitySupport

        Whether the model accepts PDF content blocks.

        • Supported bool

          Whether this capability is supported by the model.

      • StructuredOutputs CapabilitySupport

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

        • Supported bool

          Whether this capability is supported by the model.

      • Thinking ThinkingCapability

        Thinking capability and supported type configurations.

        • Supported bool

          Whether this capability is supported by the model.

        • Types ThinkingTypes

          Supported thinking type configurations.

          • Adaptive CapabilitySupport

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

            • Supported bool

              Whether this capability is supported by the model.

          • Enabled CapabilitySupport

            Whether the model supports thinking with type ‘enabled’.

            • Supported bool

              Whether this capability is supported by the model.

    • CreatedAt Time

      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.

    • DisplayName string

      A human-readable name for the model.

    • MaxInputTokens int64

      Maximum input context window size in tokens for this model.

    • MaxTokens int64

      Maximum value for the max_tokens parameter when using this model.

    • Type Model

      Object type.

      For Models, this is always "model".

      • const ModelModel Model = "model"

Example

package main
 
import (
  "context"
  "fmt"
 
  "github.com/anthropics/anthropic-sdk-go"
  "github.com/anthropics/anthropic-sdk-go/option"
)
 
func main() {
  client := anthropic.NewClient(
    option.WithAPIKey("my-anthropic-api-key"),
  )
  modelInfo, err := client.Models.Get(
    context.TODO(),
    "model_id",
    anthropic.ModelGetParams{
 
    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", modelInfo.ID)
}

Liên kết

Xem thêm: