---
title: "Get Model"
method: GET
path: "/v1/models/{model_id}"
tags: ["v1", "v1"]
---

# Get Model

`GET /v1/models/{model_id}`

Retrieve a model.

Retrieve detailed information about a specific model, including its capabilities,
provider, and supported features.

Args:
    model_id: The ID of the model to retrieve (e.g., 'openai/gpt-4', 'anthropic/claude-3-5-sonnet-20241022')
    user: Authenticated user obtained from API key validation

Returns:
    Model: Information about the requested model

Raises:
    HTTPException:
        - 401 if authentication fails
        - 404 if model not found or not accessible with current API key
        - 500 if internal error occurs

Requires:
    Valid API key with 'read' scope permission

Example:
    ```python
    import dedalus_labs

    client = dedalus_labs.Client(api_key="your-api-key")
    model = client.models.retrieve("openai/gpt-4")

    print(f"Model: {model.id}")
    print(f"Owner: {model.owned_by}")
    ```

    Response:
    ```json
    {
        "id": "openai/gpt-4",
        "object": "model",
        "created": 1687882411,
        "owned_by": "openai"
    }
    ```

## Path parameters

- `model_id` string, required

## Response `200`

Successful Response

- Model — Unified model metadata across all providers. Combines provider-specific schemas into a single, consistent format. Fields that aren't available from a provider are set to None.
  - `id` string, required — Unique model identifier with provider prefix (e.g., 'openai/gpt-4')
  - `provider` 'openai' | 'anthropic' | 'google' | 'xai' | 'mistral' | 'groq' | 'fireworks' | 'deepseek', required — Provider that hosts this model
  - `created_at` string, date-time, required — When the model was released (RFC 3339)
  - `display_name` string, nullable — Human-readable model name
  - `description` string, nullable — Model description
  - `version` string, nullable — Model version identifier
  - `capabilities` ModelCapabilities — Normalized model capabilities across all providers.
    - `text` boolean, nullable — Supports text generation
    - `vision` boolean, nullable — Supports image understanding
    - `image_generation` boolean, nullable — Supports image generation
    - `audio` boolean, nullable — Supports audio processing
    - `tools` boolean, nullable — Supports function/tool calling
    - `structured_output` boolean, nullable — Supports structured JSON output
    - `streaming` boolean, nullable — Supports streaming responses
    - `thinking` boolean, nullable — Supports extended thinking/reasoning
    - `input_token_limit` integer, nullable — Maximum input tokens
    - `output_token_limit` integer, nullable — Maximum output tokens
  - `defaults` ModelDefaults — Provider-declared default parameters for model generation.
    - `temperature` number, nullable — Default temperature setting
    - `top_p` number, nullable — Default top_p setting
    - `top_k` integer, nullable — Default top_k setting
    - `max_output_tokens` integer, nullable — Default maximum output tokens
  - `provider_info` object, nullable — Raw provider-specific metadata
  - `provider_declared_generation_methods` string[], nullable — Provider-specific generation method names (None = not declared)

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/dedalus-labs/apis/dedalus-api.md) · [All operations](https://skmtc.net/dedalus-labs/apis/dedalus-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dedalus-labs/dedalus-api/versions/81ffcde15f4c/schema)