# Get model GET /v1/workspaces/{workspace\_id}/models/{model\_id} ```bash curl --request GET \ --url https://api.app.layer.ai/api/v1/workspaces/:workspace_id/models/:model_id \ --header 'Authorization: Bearer ' ``` ```python import requests url = "https://api.app.layer.ai/api/v1/workspaces/:workspace_id/models/:model_id" headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers) print(response.json()) ``` ```js const url = 'https://api.app.layer.ai/api/v1/workspaces/:workspace_id/models/:model_id'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.app.layer.ai/api/v1/workspaces/:workspace_id/models/:model_id" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```php "https://api.app.layer.ai/api/v1/workspaces/:workspace_id/models/:model_id", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "GET", CURLOPT_HTTPHEADER => [ "Authorization: Bearer " ], ]); $response = curl_exec($curl); $err = curl_error($curl); curl_close($curl); if ($err) { echo "cURL Error #:" . $err; } else { echo $response; } ``` ```java OkHttpClient client = new OkHttpClient(); Request request = new Request.Builder() .url("https://api.app.layer.ai/api/v1/workspaces/:workspace_id/models/:model_id") .get() .addHeader("Authorization", "Bearer ") .build(); Response response = client.newCall(request).execute(); ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.app.layer.ai/api/v1/workspaces/:workspace_id/models/:model_id") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ```csharp var client = new RestClient("https://api.app.layer.ai/api/v1/workspaces/:workspace_id/models/:model_id"); var request = new RestRequest("", Method.Get); request.AddHeader("Authorization", "Bearer "); var response = client.Execute(request); ``` * Production Get full details for a specific model including capabilities, timing, and prompt format. ## Authorizations * **[bearerAuth](/docs/rest-api#bearerauth)** ## Parameters ### Path Parameters **workspace\_id** required _Workspace Id_ string format: uuid **model\_id** required _Model Id_ string format: uuid ## Responses ### 200 Successful Response _GetModelRESTOutput_object **model** required _ModelDetailREST_object **model\_id** required _Model Id_ string format: uuid **name** required _Name_ string **modality** required _Modality_ string Allowed values: text image audio video three\_d playable **base\_model\_id** Any of: **string** string **null** null **base\_model\_name** Any of: **string** string **null** null **description** Any of: **string** string **null** null **inference\_timing** required _Inference Timing_ string **capabilities** required _ModelCapabilitiesREST_ ModelCapabilities without the MCP token-saving serializer — returns all fields. object **session\_modes** _Session Modes_ Supported modes: create, create\_video, create\_3\_d, create\_speech, create\_sound\_effect, prompt\_edit\_image, etc. Array **text\_prompt** _Text Prompt_ boolean **text\_prompt\_required** _Text Prompt Required_ boolean **negative\_prompt** _Negative Prompt_ boolean **seed** _Seed_ boolean **inpainting** _Inpainting_ boolean **outpainting** _Outpainting_ boolean **tileability** _Tileability_ boolean **guidance\_file\_types** _Guidance File Types_ Supported reference image types: pose, depth, canny, lineart, prompt (style reference), init, reference\_image, etc. Array **duration\_seconds** _Duration Seconds_ Supported video durations in seconds Array **auto\_aspect\_ratio** _Auto Aspect Ratio_ boolean **generate\_audio** _Generate Audio_ boolean **lipsync** _Lipsync_ boolean **textures** _Textures_ boolean **quad\_mesh** _Quad Mesh_ boolean **pbr\_materials** _Pbr Materials_ boolean **text\_to\_speech** _Text To Speech_ boolean **sound\_effect** _Sound Effect_ boolean **music** _Music_ boolean **voice\_changer** _Voice Changer_ boolean **text\_to\_dialogue** _Text To Dialogue_ boolean **audio\_separation** _Audio Separation_ boolean **audio\_isolation** _Audio Isolation_ boolean **audio\_inpaint** _Audio Inpaint_ boolean **audio\_outpaint** _Audio Outpaint_ boolean **audio\_denoise** _Audio Denoise_ boolean **prompt\_format** Any of: **string** string **null** null ##### Example ```json { "model": { "modality": "text", "capabilities": { "text_prompt": false, "text_prompt_required": false, "negative_prompt": false, "seed": false, "inpainting": false, "outpainting": false, "tileability": false, "auto_aspect_ratio": false, "generate_audio": false, "lipsync": false, "textures": false, "quad_mesh": false, "pbr_materials": false, "text_to_speech": false, "sound_effect": false, "music": false, "voice_changer": false, "text_to_dialogue": false, "audio_separation": false, "audio_isolation": false, "audio_inpaint": false, "audio_outpaint": false, "audio_denoise": false } } } ``` ### 401 Unauthenticated — missing or invalid Bearer token. object **type** required string **title** required string **status** required integer **detail** required string ##### Example ```json { "type": "https://api.layer.ai/errors/ERROR_CODE", "title": "Error Title", "status": 400, "detail": "Human-readable description." } ``` ### 403 Forbidden — insufficient permissions. object **type** required string **title** required string **status** required integer **detail** required string ##### Example ```json { "type": "https://api.layer.ai/errors/ERROR_CODE", "title": "Error Title", "status": 400, "detail": "Human-readable description." } ``` ### 404 Resource not found. object **type** required string **title** required string **status** required integer **detail** required string ##### Example ```json { "type": "https://api.layer.ai/errors/ERROR_CODE", "title": "Error Title", "status": 400, "detail": "Human-readable description." } ``` ### 422 Invalid input parameters. object **type** required string **title** required string **status** required integer **detail** required string ##### Example ```json { "type": "https://api.layer.ai/errors/ERROR_CODE", "title": "Error Title", "status": 400, "detail": "Human-readable description." } ``` ### 429 Rate limited — too many concurrent requests. object **type** required string **title** required string **status** required integer **detail** required string ##### Example ```json { "type": "https://api.layer.ai/errors/ERROR_CODE", "title": "Error Title", "status": 400, "detail": "Human-readable description." } ``` ### 500 Internal server error. object **type** required string **title** required string **status** required integer **detail** required string ##### Example ```json { "type": "https://api.layer.ai/errors/ERROR_CODE", "title": "Error Title", "status": 400, "detail": "Human-readable description." } ```