---
title: "Get model"
method: GET
path: "/v1/workspaces/{workspace_id}/models/{model_id}"
tags: ["Models"]
---

# Get model

`GET /v1/workspaces/{workspace_id}/models/{model_id}`

Get full details for a specific model including capabilities, timing, and prompt format.

## Path parameters

- `workspace_id` string, uuid, required — Id of the workspace that owns the resource.
- `model_id` string, uuid, required — Id of the model, as returned by the list models endpoint.

## Response `200`

Successful Response

- GetModelRESTOutput
  - `model` ModelDetailREST, required
    - `model_id` string, uuid, required
    - `name` string, required
    - `modality` 'text' | 'image' | 'audio' | 'video' | 'three_d' | 'playable', required
    - `base_model_id` string, nullable
    - `base_model_name` string, nullable
    - `description` string, nullable
    - `inference_timing` string, required
    - `capabilities` ModelCapabilitiesREST, required — ModelCapabilities without the MCP token-saving serializer — returns all fields.
      - `session_modes` string[] — Supported modes: create, create_video, create_3_d, create_speech, create_sound_effect, prompt_edit_image, etc.
      - `text_prompt` boolean
      - `text_prompt_required` boolean
      - `negative_prompt` boolean
      - `seed` boolean
      - `inpainting` boolean
      - `outpainting` boolean
      - `tileability` boolean
      - `guidance_file_types` string[] — Supported reference image types: pose, depth, canny, lineart, prompt (style reference), init, reference_image, etc.
      - `duration_seconds` integer[] — Supported video durations in seconds
      - `auto_aspect_ratio` boolean
      - `generate_audio` boolean
      - `lipsync` boolean
      - `textures` boolean
      - `quad_mesh` boolean
      - `pbr_materials` boolean
      - `text_to_speech` boolean
      - `sound_effect` boolean
      - `music` boolean
      - `voice_changer` boolean
      - `text_to_dialogue` boolean
      - `audio_separation` boolean
      - `audio_isolation` boolean
      - `audio_inpaint` boolean
      - `audio_outpaint` boolean
      - `audio_denoise` boolean
    - `prompt_format` string, nullable

## Other responses

- `401` — Unauthenticated — missing or invalid Bearer token.
- `403` — Forbidden — insufficient permissions, or the access token lacks the scope the operation requires.
- `404` — Resource not found.
- `409` — The request with this `Idempotency-Key` is still running — retry after the number of seconds in `Retry-After`.
- `422` — Invalid input parameters, or an `Idempotency-Key` reused for a different request.
- `429` — Rate limited — retry after the number of seconds in `Retry-After`.
- `500` — Internal server error.

---

[API](https://skmtc.dev/layer/apis/layer-rest-api.md) · [All operations](https://skmtc.dev/layer/apis/layer-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/layer/layer-rest-api/revisions/fafc779f9ba2/schema)