# Execute inference POST /v2/workspaces/{workspace\_id}/inferences ```bash curl --request POST \ --url https://api.app.layer.ai/api/v2/workspaces/:workspace_id/inferences \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data '{ "subtitle_preset": "", "subtitle_color": "", "subtitle_secondary_color": "", "subtitle_alignment": "top", "base_model_id": "", "reference_sets": [], "modality": "text", "prompt": "", "negative_prompt": "", "width": 0, "height": 0, "auto_aspect_ratio": true, "auto_resolution": "", "batch_size": 4, "num_inference_steps": 0, "guidance_scale": 0, "prompt_strength": 0, "quality": "low", "sharpness": 0, "prompt_enhancement": "off", "duration_seconds": 0, "generate_audio": true, "keep_audio": true, "draft": true, "instrumental": true, "loop": true, "output_format": "mp3", "lyrics": "", "composition_plan": { "positive_styles": [], "negative_styles": [], "sections": [ { "name": null, "duration_seconds": null, "positive_styles": null, "negative_styles": null, "lines": null } ], "respect_section_durations": true }, "fps": 0, "video_effects": [], "use_ta_pose": true, "pose_mode": "A_POSE", "include_textures": true, "detailed_geometry": true, "remesh_geometry": true, "texture_resolution": "RES_2K", "remove_lighting": true, "mesh_density": "ULTRA", "preserve_uvs": true, "segment_by": "AUTO", "segment_part_names": [ "" ], "segment_target": "CHARACTER", "segment_parts": 0, "segment_level": "LOW", "segment_strength": 0, "quad_mesh": true, "pbr_materials": true, "low_poly": true, "generate_parts": true, "face_limit": 0, "enable_rigging": true, "enable_animation": true, "stability": 0, "use_speaker_boost": true, "similarity_boost": 0, "style_exaggeration": 0, "speed": 0, "upscale_ratio": 0, "creativity": 0, "resemblance": 0, "denoise": 0, "compression_repair": 0, "halo_reduction": 0, "recover_detail": 0, "detail": 0, "grain": 0, "refine_strength": 0, "realism": 0, "face_enhancement": true, "face_enhancement_strength": 0, "face_enhancement_creativity": 0, "target_region": "all", "color_preservation": true, "vectorize": true, "vectorization_mode": "spline", "vectorization_color_mode": "color", "vectorization_layering": "stacked", "vectorization_filter_speckle": 0, "vectorization_color_precision": 0, "vectorization_layer_difference": 0, "vectorization_corner_threshold": 0, "vectorization_length_threshold": 0, "vectorization_splice_threshold": 0, "vectorization_max_iterations": 0, "vectorization_path_precision": 0, "transparency": true, "reframe": true, "tileability": true, "projection": "EQUIRECTANGULAR", "projection_strength": 0, "refill": true, "camera_transform": { "distance_delta": 0, "rotation_delta": { "pitch_delta": null, "yaw_delta": null, "roll_delta": null }, "zoom_delta": { "fov_y_delta": null } }, "camera_trajectory": [ { "time": 0, "azimuth": 0, "elevation": 0, "distance": 0 } ], "scene_lighting": { "lights": [] }, "tile_grid": { "shape": "SQUARE", "orientation": "DIAMOND", "elevation": 0, "facing": 0, "footprint_width": 1, "footprint_depth": 1, "height": 0, "tile_width": 128, "light_from": "left" }, "output_fit": { "trim": false, "canvas": "CONTENT", "width": 0, "height": 0, "scale": "PLACE", "anchor": "TOP_LEFT", "padding": 0 }, "nine_slice": true, "parallax": { "layers": 5, "cuts": [ 0 ], "loop": false }, "color_palette": { "colors": [], "reference_set_id": "" }, "expression": "", "target_language": "", "audio_sections": [], "audio_extension": { "before_seconds": 0, "after_seconds": 0 }, "video_section": { "start_seconds": 0, "end_seconds": 0 }, "guidance_files": [], "seed": -1, "mask": { "file_id": "", "for_transparency": true, "for_nontransparency": true, "edge_radius": 0 }, "session_name": "", "session_id": "", "webhook": { "url": "", "events": [ "inference.completed" ], "metadata": {} } }' ``` ```python import requests url = "https://api.app.layer.ai/api/v2/workspaces/:workspace_id/inferences" payload = { "subtitle_preset": "", "subtitle_color": "", "subtitle_secondary_color": "", "subtitle_alignment": "top", "base_model_id": "", "reference_sets": [], "modality": "text", "prompt": "", "negative_prompt": "", "width": 0, "height": 0, "auto_aspect_ratio": True, "auto_resolution": "", "batch_size": 4, "num_inference_steps": 0, "guidance_scale": 0, "prompt_strength": 0, "quality": "low", "sharpness": 0, "prompt_enhancement": "off", "duration_seconds": 0, "generate_audio": True, "keep_audio": True, "draft": True, "instrumental": True, "loop": True, "output_format": "mp3", "lyrics": "", "composition_plan": { "positive_styles": [], "negative_styles": [], "sections": [ { "name": None, "duration_seconds": None, "positive_styles": None, "negative_styles": None, "lines": None } ], "respect_section_durations": True }, "fps": 0, "video_effects": [], "use_ta_pose": True, "pose_mode": "A_POSE", "include_textures": True, "detailed_geometry": True, "remesh_geometry": True, "texture_resolution": "RES_2K", "remove_lighting": True, "mesh_density": "ULTRA", "preserve_uvs": True, "segment_by": "AUTO", "segment_part_names": [""], "segment_target": "CHARACTER", "segment_parts": 0, "segment_level": "LOW", "segment_strength": 0, "quad_mesh": True, "pbr_materials": True, "low_poly": True, "generate_parts": True, "face_limit": 0, "enable_rigging": True, "enable_animation": True, "stability": 0, "use_speaker_boost": True, "similarity_boost": 0, "style_exaggeration": 0, "speed": 0, "upscale_ratio": 0, "creativity": 0, "resemblance": 0, "denoise": 0, "compression_repair": 0, "halo_reduction": 0, "recover_detail": 0, "detail": 0, "grain": 0, "refine_strength": 0, "realism": 0, "face_enhancement": True, "face_enhancement_strength": 0, "face_enhancement_creativity": 0, "target_region": "all", "color_preservation": True, "vectorize": True, "vectorization_mode": "spline", "vectorization_color_mode": "color", "vectorization_layering": "stacked", "vectorization_filter_speckle": 0, "vectorization_color_precision": 0, "vectorization_layer_difference": 0, "vectorization_corner_threshold": 0, "vectorization_length_threshold": 0, "vectorization_splice_threshold": 0, "vectorization_max_iterations": 0, "vectorization_path_precision": 0, "transparency": True, "reframe": True, "tileability": True, "projection": "EQUIRECTANGULAR", "projection_strength": 0, "refill": True, "camera_transform": { "distance_delta": 0, "rotation_delta": { "pitch_delta": None, "yaw_delta": None, "roll_delta": None }, "zoom_delta": { "fov_y_delta": None } }, "camera_trajectory": [ { "time": 0, "azimuth": 0, "elevation": 0, "distance": 0 } ], "scene_lighting": { "lights": [] }, "tile_grid": { "shape": "SQUARE", "orientation": "DIAMOND", "elevation": 0, "facing": 0, "footprint_width": 1, "footprint_depth": 1, "height": 0, "tile_width": 128, "light_from": "left" }, "output_fit": { "trim": False, "canvas": "CONTENT", "width": 0, "height": 0, "scale": "PLACE", "anchor": "TOP_LEFT", "padding": 0 }, "nine_slice": True, "parallax": { "layers": 5, "cuts": [0], "loop": False }, "color_palette": { "colors": [], "reference_set_id": "" }, "expression": "", "target_language": "", "audio_sections": [], "audio_extension": { "before_seconds": 0, "after_seconds": 0 }, "video_section": { "start_seconds": 0, "end_seconds": 0 }, "guidance_files": [], "seed": -1, "mask": { "file_id": "", "for_transparency": True, "for_nontransparency": True, "edge_radius": 0 }, "session_name": "", "session_id": "", "webhook": { "url": "", "events": ["inference.completed"], "metadata": {} } } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```js const url = 'https://api.app.layer.ai/api/v2/workspaces/:workspace_id/inferences'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"subtitle_preset":"","subtitle_color":"","subtitle_secondary_color":"","subtitle_alignment":"top","base_model_id":"","reference_sets":[],"modality":"text","prompt":"","negative_prompt":"","width":0,"height":0,"auto_aspect_ratio":true,"auto_resolution":"","batch_size":4,"num_inference_steps":0,"guidance_scale":0,"prompt_strength":0,"quality":"low","sharpness":0,"prompt_enhancement":"off","duration_seconds":0,"generate_audio":true,"keep_audio":true,"draft":true,"instrumental":true,"loop":true,"output_format":"mp3","lyrics":"","composition_plan":{"positive_styles":[],"negative_styles":[],"sections":[{"name":null,"duration_seconds":null,"positive_styles":null,"negative_styles":null,"lines":null}],"respect_section_durations":true},"fps":0,"video_effects":[],"use_ta_pose":true,"pose_mode":"A_POSE","include_textures":true,"detailed_geometry":true,"remesh_geometry":true,"texture_resolution":"RES_2K","remove_lighting":true,"mesh_density":"ULTRA","preserve_uvs":true,"segment_by":"AUTO","segment_part_names":[""],"segment_target":"CHARACTER","segment_parts":0,"segment_level":"LOW","segment_strength":0,"quad_mesh":true,"pbr_materials":true,"low_poly":true,"generate_parts":true,"face_limit":0,"enable_rigging":true,"enable_animation":true,"stability":0,"use_speaker_boost":true,"similarity_boost":0,"style_exaggeration":0,"speed":0,"upscale_ratio":0,"creativity":0,"resemblance":0,"denoise":0,"compression_repair":0,"halo_reduction":0,"recover_detail":0,"detail":0,"grain":0,"refine_strength":0,"realism":0,"face_enhancement":true,"face_enhancement_strength":0,"face_enhancement_creativity":0,"target_region":"all","color_preservation":true,"vectorize":true,"vectorization_mode":"spline","vectorization_color_mode":"color","vectorization_layering":"stacked","vectorization_filter_speckle":0,"vectorization_color_precision":0,"vectorization_layer_difference":0,"vectorization_corner_threshold":0,"vectorization_length_threshold":0,"vectorization_splice_threshold":0,"vectorization_max_iterations":0,"vectorization_path_precision":0,"transparency":true,"reframe":true,"tileability":true,"projection":"EQUIRECTANGULAR","projection_strength":0,"refill":true,"camera_transform":{"distance_delta":0,"rotation_delta":{"pitch_delta":null,"yaw_delta":null,"roll_delta":null},"zoom_delta":{"fov_y_delta":null}},"camera_trajectory":[{"time":0,"azimuth":0,"elevation":0,"distance":0}],"scene_lighting":{"lights":[]},"tile_grid":{"shape":"SQUARE","orientation":"DIAMOND","elevation":0,"facing":0,"footprint_width":1,"footprint_depth":1,"height":0,"tile_width":128,"light_from":"left"},"output_fit":{"trim":false,"canvas":"CONTENT","width":0,"height":0,"scale":"PLACE","anchor":"TOP_LEFT","padding":0},"nine_slice":true,"parallax":{"layers":5,"cuts":[0],"loop":false},"color_palette":{"colors":[],"reference_set_id":""},"expression":"","target_language":"","audio_sections":[],"audio_extension":{"before_seconds":0,"after_seconds":0},"video_section":{"start_seconds":0,"end_seconds":0},"guidance_files":[],"seed":-1,"mask":{"file_id":"","for_transparency":true,"for_nontransparency":true,"edge_radius":0},"session_name":"","session_id":"","webhook":{"url":"","events":["inference.completed"],"metadata":{}}}' }; 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" "strings" "net/http" "io" ) func main() { url := "https://api.app.layer.ai/api/v2/workspaces/:workspace_id/inferences" payload := strings.NewReader("{\n \"subtitle_preset\": \"\",\n \"subtitle_color\": \"\",\n \"subtitle_secondary_color\": \"\",\n \"subtitle_alignment\": \"top\",\n \"base_model_id\": \"\",\n \"reference_sets\": [],\n \"modality\": \"text\",\n \"prompt\": \"\",\n \"negative_prompt\": \"\",\n \"width\": 0,\n \"height\": 0,\n \"auto_aspect_ratio\": true,\n \"auto_resolution\": \"\",\n \"batch_size\": 4,\n \"num_inference_steps\": 0,\n \"guidance_scale\": 0,\n \"prompt_strength\": 0,\n \"quality\": \"low\",\n \"sharpness\": 0,\n \"prompt_enhancement\": \"off\",\n \"duration_seconds\": 0,\n \"generate_audio\": true,\n \"keep_audio\": true,\n \"draft\": true,\n \"instrumental\": true,\n \"loop\": true,\n \"output_format\": \"mp3\",\n \"lyrics\": \"\",\n \"composition_plan\": {\n \"positive_styles\": [],\n \"negative_styles\": [],\n \"sections\": [\n {\n \"name\": null,\n \"duration_seconds\": null,\n \"positive_styles\": null,\n \"negative_styles\": null,\n \"lines\": null\n }\n ],\n \"respect_section_durations\": true\n },\n \"fps\": 0,\n \"video_effects\": [],\n \"use_ta_pose\": true,\n \"pose_mode\": \"A_POSE\",\n \"include_textures\": true,\n \"detailed_geometry\": true,\n \"remesh_geometry\": true,\n \"texture_resolution\": \"RES_2K\",\n \"remove_lighting\": true,\n \"mesh_density\": \"ULTRA\",\n \"preserve_uvs\": true,\n \"segment_by\": \"AUTO\",\n \"segment_part_names\": [\n \"\"\n ],\n \"segment_target\": \"CHARACTER\",\n \"segment_parts\": 0,\n \"segment_level\": \"LOW\",\n \"segment_strength\": 0,\n \"quad_mesh\": true,\n \"pbr_materials\": true,\n \"low_poly\": true,\n \"generate_parts\": true,\n \"face_limit\": 0,\n \"enable_rigging\": true,\n \"enable_animation\": true,\n \"stability\": 0,\n \"use_speaker_boost\": true,\n \"similarity_boost\": 0,\n \"style_exaggeration\": 0,\n \"speed\": 0,\n \"upscale_ratio\": 0,\n \"creativity\": 0,\n \"resemblance\": 0,\n \"denoise\": 0,\n \"compression_repair\": 0,\n \"halo_reduction\": 0,\n \"recover_detail\": 0,\n \"detail\": 0,\n \"grain\": 0,\n \"refine_strength\": 0,\n \"realism\": 0,\n \"face_enhancement\": true,\n \"face_enhancement_strength\": 0,\n \"face_enhancement_creativity\": 0,\n \"target_region\": \"all\",\n \"color_preservation\": true,\n \"vectorize\": true,\n \"vectorization_mode\": \"spline\",\n \"vectorization_color_mode\": \"color\",\n \"vectorization_layering\": \"stacked\",\n \"vectorization_filter_speckle\": 0,\n \"vectorization_color_precision\": 0,\n \"vectorization_layer_difference\": 0,\n \"vectorization_corner_threshold\": 0,\n \"vectorization_length_threshold\": 0,\n \"vectorization_splice_threshold\": 0,\n \"vectorization_max_iterations\": 0,\n \"vectorization_path_precision\": 0,\n \"transparency\": true,\n \"reframe\": true,\n \"tileability\": true,\n \"projection\": \"EQUIRECTANGULAR\",\n \"projection_strength\": 0,\n \"refill\": true,\n \"camera_transform\": {\n \"distance_delta\": 0,\n \"rotation_delta\": {\n \"pitch_delta\": null,\n \"yaw_delta\": null,\n \"roll_delta\": null\n },\n \"zoom_delta\": {\n \"fov_y_delta\": null\n }\n },\n \"camera_trajectory\": [\n {\n \"time\": 0,\n \"azimuth\": 0,\n \"elevation\": 0,\n \"distance\": 0\n }\n ],\n \"scene_lighting\": {\n \"lights\": []\n },\n \"tile_grid\": {\n \"shape\": \"SQUARE\",\n \"orientation\": \"DIAMOND\",\n \"elevation\": 0,\n \"facing\": 0,\n \"footprint_width\": 1,\n \"footprint_depth\": 1,\n \"height\": 0,\n \"tile_width\": 128,\n \"light_from\": \"left\"\n },\n \"output_fit\": {\n \"trim\": false,\n \"canvas\": \"CONTENT\",\n \"width\": 0,\n \"height\": 0,\n \"scale\": \"PLACE\",\n \"anchor\": \"TOP_LEFT\",\n \"padding\": 0\n },\n \"nine_slice\": true,\n \"parallax\": {\n \"layers\": 5,\n \"cuts\": [\n 0\n ],\n \"loop\": false\n },\n \"color_palette\": {\n \"colors\": [],\n \"reference_set_id\": \"\"\n },\n \"expression\": \"\",\n \"target_language\": \"\",\n \"audio_sections\": [],\n \"audio_extension\": {\n \"before_seconds\": 0,\n \"after_seconds\": 0\n },\n \"video_section\": {\n \"start_seconds\": 0,\n \"end_seconds\": 0\n },\n \"guidance_files\": [],\n \"seed\": -1,\n \"mask\": {\n \"file_id\": \"\",\n \"for_transparency\": true,\n \"for_nontransparency\": true,\n \"edge_radius\": 0\n },\n \"session_name\": \"\",\n \"session_id\": \"\",\n \"webhook\": {\n \"url\": \"\",\n \"events\": [\n \"inference.completed\"\n ],\n \"metadata\": {}\n }\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") 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/v2/workspaces/:workspace_id/inferences", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "POST", CURLOPT_POSTFIELDS => json_encode([ 'subtitle_preset' => '', 'subtitle_color' => '', 'subtitle_secondary_color' => '', 'subtitle_alignment' => 'top', 'base_model_id' => '', 'reference_sets' => [ ], 'modality' => 'text', 'prompt' => '', 'negative_prompt' => '', 'width' => 0, 'height' => 0, 'auto_aspect_ratio' => null, 'auto_resolution' => '', 'batch_size' => 4, 'num_inference_steps' => 0, 'guidance_scale' => 0, 'prompt_strength' => 0, 'quality' => 'low', 'sharpness' => 0, 'prompt_enhancement' => 'off', 'duration_seconds' => 0, 'generate_audio' => null, 'keep_audio' => null, 'draft' => null, 'instrumental' => null, 'loop' => null, 'output_format' => 'mp3', 'lyrics' => '', 'composition_plan' => [ 'positive_styles' => [ ], 'negative_styles' => [ ], 'sections' => [ [ 'name' => null, 'duration_seconds' => null, 'positive_styles' => null, 'negative_styles' => null, 'lines' => null ] ], 'respect_section_durations' => null ], 'fps' => 0, 'video_effects' => [ ], 'use_ta_pose' => null, 'pose_mode' => 'A_POSE', 'include_textures' => null, 'detailed_geometry' => null, 'remesh_geometry' => null, 'texture_resolution' => 'RES_2K', 'remove_lighting' => null, 'mesh_density' => 'ULTRA', 'preserve_uvs' => null, 'segment_by' => 'AUTO', 'segment_part_names' => [ '' ], 'segment_target' => 'CHARACTER', 'segment_parts' => 0, 'segment_level' => 'LOW', 'segment_strength' => 0, 'quad_mesh' => null, 'pbr_materials' => null, 'low_poly' => null, 'generate_parts' => null, 'face_limit' => 0, 'enable_rigging' => null, 'enable_animation' => null, 'stability' => 0, 'use_speaker_boost' => null, 'similarity_boost' => 0, 'style_exaggeration' => 0, 'speed' => 0, 'upscale_ratio' => 0, 'creativity' => 0, 'resemblance' => 0, 'denoise' => 0, 'compression_repair' => 0, 'halo_reduction' => 0, 'recover_detail' => 0, 'detail' => 0, 'grain' => 0, 'refine_strength' => 0, 'realism' => 0, 'face_enhancement' => null, 'face_enhancement_strength' => 0, 'face_enhancement_creativity' => 0, 'target_region' => 'all', 'color_preservation' => null, 'vectorize' => null, 'vectorization_mode' => 'spline', 'vectorization_color_mode' => 'color', 'vectorization_layering' => 'stacked', 'vectorization_filter_speckle' => 0, 'vectorization_color_precision' => 0, 'vectorization_layer_difference' => 0, 'vectorization_corner_threshold' => 0, 'vectorization_length_threshold' => 0, 'vectorization_splice_threshold' => 0, 'vectorization_max_iterations' => 0, 'vectorization_path_precision' => 0, 'transparency' => null, 'reframe' => null, 'tileability' => null, 'projection' => 'EQUIRECTANGULAR', 'projection_strength' => 0, 'refill' => null, 'camera_transform' => [ 'distance_delta' => 0, 'rotation_delta' => [ 'pitch_delta' => null, 'yaw_delta' => null, 'roll_delta' => null ], 'zoom_delta' => [ 'fov_y_delta' => null ] ], 'camera_trajectory' => [ [ 'time' => 0, 'azimuth' => 0, 'elevation' => 0, 'distance' => 0 ] ], 'scene_lighting' => [ 'lights' => [ ] ], 'tile_grid' => [ 'shape' => 'SQUARE', 'orientation' => 'DIAMOND', 'elevation' => 0, 'facing' => 0, 'footprint_width' => 1, 'footprint_depth' => 1, 'height' => 0, 'tile_width' => 128, 'light_from' => 'left' ], 'output_fit' => [ 'trim' => null, 'canvas' => 'CONTENT', 'width' => 0, 'height' => 0, 'scale' => 'PLACE', 'anchor' => 'TOP_LEFT', 'padding' => 0 ], 'nine_slice' => null, 'parallax' => [ 'layers' => 5, 'cuts' => [ 0 ], 'loop' => null ], 'color_palette' => [ 'colors' => [ ], 'reference_set_id' => '' ], 'expression' => '', 'target_language' => '', 'audio_sections' => [ ], 'audio_extension' => [ 'before_seconds' => 0, 'after_seconds' => 0 ], 'video_section' => [ 'start_seconds' => 0, 'end_seconds' => 0 ], 'guidance_files' => [ ], 'seed' => -1, 'mask' => [ 'file_id' => '', 'for_transparency' => null, 'for_nontransparency' => null, 'edge_radius' => 0 ], 'session_name' => '', 'session_id' => '', 'webhook' => [ 'url' => '', 'events' => [ 'inference.completed' ], 'metadata' => [ ] ] ]), CURLOPT_HTTPHEADER => [ "Authorization: Bearer ", "Content-Type: application/json" ], ]); $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(); MediaType mediaType = MediaType.parse("application/json"); RequestBody body = RequestBody.create(mediaType, "{\n \"subtitle_preset\": \"\",\n \"subtitle_color\": \"\",\n \"subtitle_secondary_color\": \"\",\n \"subtitle_alignment\": \"top\",\n \"base_model_id\": \"\",\n \"reference_sets\": [],\n \"modality\": \"text\",\n \"prompt\": \"\",\n \"negative_prompt\": \"\",\n \"width\": 0,\n \"height\": 0,\n \"auto_aspect_ratio\": true,\n \"auto_resolution\": \"\",\n \"batch_size\": 4,\n \"num_inference_steps\": 0,\n \"guidance_scale\": 0,\n \"prompt_strength\": 0,\n \"quality\": \"low\",\n \"sharpness\": 0,\n \"prompt_enhancement\": \"off\",\n \"duration_seconds\": 0,\n \"generate_audio\": true,\n \"keep_audio\": true,\n \"draft\": true,\n \"instrumental\": true,\n \"loop\": true,\n \"output_format\": \"mp3\",\n \"lyrics\": \"\",\n \"composition_plan\": {\n \"positive_styles\": [],\n \"negative_styles\": [],\n \"sections\": [\n {\n \"name\": null,\n \"duration_seconds\": null,\n \"positive_styles\": null,\n \"negative_styles\": null,\n \"lines\": null\n }\n ],\n \"respect_section_durations\": true\n },\n \"fps\": 0,\n \"video_effects\": [],\n \"use_ta_pose\": true,\n \"pose_mode\": \"A_POSE\",\n \"include_textures\": true,\n \"detailed_geometry\": true,\n \"remesh_geometry\": true,\n \"texture_resolution\": \"RES_2K\",\n \"remove_lighting\": true,\n \"mesh_density\": \"ULTRA\",\n \"preserve_uvs\": true,\n \"segment_by\": \"AUTO\",\n \"segment_part_names\": [\n \"\"\n ],\n \"segment_target\": \"CHARACTER\",\n \"segment_parts\": 0,\n \"segment_level\": \"LOW\",\n \"segment_strength\": 0,\n \"quad_mesh\": true,\n \"pbr_materials\": true,\n \"low_poly\": true,\n \"generate_parts\": true,\n \"face_limit\": 0,\n \"enable_rigging\": true,\n \"enable_animation\": true,\n \"stability\": 0,\n \"use_speaker_boost\": true,\n \"similarity_boost\": 0,\n \"style_exaggeration\": 0,\n \"speed\": 0,\n \"upscale_ratio\": 0,\n \"creativity\": 0,\n \"resemblance\": 0,\n \"denoise\": 0,\n \"compression_repair\": 0,\n \"halo_reduction\": 0,\n \"recover_detail\": 0,\n \"detail\": 0,\n \"grain\": 0,\n \"refine_strength\": 0,\n \"realism\": 0,\n \"face_enhancement\": true,\n \"face_enhancement_strength\": 0,\n \"face_enhancement_creativity\": 0,\n \"target_region\": \"all\",\n \"color_preservation\": true,\n \"vectorize\": true,\n \"vectorization_mode\": \"spline\",\n \"vectorization_color_mode\": \"color\",\n \"vectorization_layering\": \"stacked\",\n \"vectorization_filter_speckle\": 0,\n \"vectorization_color_precision\": 0,\n \"vectorization_layer_difference\": 0,\n \"vectorization_corner_threshold\": 0,\n \"vectorization_length_threshold\": 0,\n \"vectorization_splice_threshold\": 0,\n \"vectorization_max_iterations\": 0,\n \"vectorization_path_precision\": 0,\n \"transparency\": true,\n \"reframe\": true,\n \"tileability\": true,\n \"projection\": \"EQUIRECTANGULAR\",\n \"projection_strength\": 0,\n \"refill\": true,\n \"camera_transform\": {\n \"distance_delta\": 0,\n \"rotation_delta\": {\n \"pitch_delta\": null,\n \"yaw_delta\": null,\n \"roll_delta\": null\n },\n \"zoom_delta\": {\n \"fov_y_delta\": null\n }\n },\n \"camera_trajectory\": [\n {\n \"time\": 0,\n \"azimuth\": 0,\n \"elevation\": 0,\n \"distance\": 0\n }\n ],\n \"scene_lighting\": {\n \"lights\": []\n },\n \"tile_grid\": {\n \"shape\": \"SQUARE\",\n \"orientation\": \"DIAMOND\",\n \"elevation\": 0,\n \"facing\": 0,\n \"footprint_width\": 1,\n \"footprint_depth\": 1,\n \"height\": 0,\n \"tile_width\": 128,\n \"light_from\": \"left\"\n },\n \"output_fit\": {\n \"trim\": false,\n \"canvas\": \"CONTENT\",\n \"width\": 0,\n \"height\": 0,\n \"scale\": \"PLACE\",\n \"anchor\": \"TOP_LEFT\",\n \"padding\": 0\n },\n \"nine_slice\": true,\n \"parallax\": {\n \"layers\": 5,\n \"cuts\": [\n 0\n ],\n \"loop\": false\n },\n \"color_palette\": {\n \"colors\": [],\n \"reference_set_id\": \"\"\n },\n \"expression\": \"\",\n \"target_language\": \"\",\n \"audio_sections\": [],\n \"audio_extension\": {\n \"before_seconds\": 0,\n \"after_seconds\": 0\n },\n \"video_section\": {\n \"start_seconds\": 0,\n \"end_seconds\": 0\n },\n \"guidance_files\": [],\n \"seed\": -1,\n \"mask\": {\n \"file_id\": \"\",\n \"for_transparency\": true,\n \"for_nontransparency\": true,\n \"edge_radius\": 0\n },\n \"session_name\": \"\",\n \"session_id\": \"\",\n \"webhook\": {\n \"url\": \"\",\n \"events\": [\n \"inference.completed\"\n ],\n \"metadata\": {}\n }\n}"); Request request = new Request.Builder() .url("https://api.app.layer.ai/api/v2/workspaces/:workspace_id/inferences") .post(body) .addHeader("Authorization", "Bearer ") .addHeader("Content-Type", "application/json") .build(); Response response = client.newCall(request).execute(); ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.app.layer.ai/api/v2/workspaces/:workspace_id/inferences") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"subtitle_preset\": \"\",\n \"subtitle_color\": \"\",\n \"subtitle_secondary_color\": \"\",\n \"subtitle_alignment\": \"top\",\n \"base_model_id\": \"\",\n \"reference_sets\": [],\n \"modality\": \"text\",\n \"prompt\": \"\",\n \"negative_prompt\": \"\",\n \"width\": 0,\n \"height\": 0,\n \"auto_aspect_ratio\": true,\n \"auto_resolution\": \"\",\n \"batch_size\": 4,\n \"num_inference_steps\": 0,\n \"guidance_scale\": 0,\n \"prompt_strength\": 0,\n \"quality\": \"low\",\n \"sharpness\": 0,\n \"prompt_enhancement\": \"off\",\n \"duration_seconds\": 0,\n \"generate_audio\": true,\n \"keep_audio\": true,\n \"draft\": true,\n \"instrumental\": true,\n \"loop\": true,\n \"output_format\": \"mp3\",\n \"lyrics\": \"\",\n \"composition_plan\": {\n \"positive_styles\": [],\n \"negative_styles\": [],\n \"sections\": [\n {\n \"name\": null,\n \"duration_seconds\": null,\n \"positive_styles\": null,\n \"negative_styles\": null,\n \"lines\": null\n }\n ],\n \"respect_section_durations\": true\n },\n \"fps\": 0,\n \"video_effects\": [],\n \"use_ta_pose\": true,\n \"pose_mode\": \"A_POSE\",\n \"include_textures\": true,\n \"detailed_geometry\": true,\n \"remesh_geometry\": true,\n \"texture_resolution\": \"RES_2K\",\n \"remove_lighting\": true,\n \"mesh_density\": \"ULTRA\",\n \"preserve_uvs\": true,\n \"segment_by\": \"AUTO\",\n \"segment_part_names\": [\n \"\"\n ],\n \"segment_target\": \"CHARACTER\",\n \"segment_parts\": 0,\n \"segment_level\": \"LOW\",\n \"segment_strength\": 0,\n \"quad_mesh\": true,\n \"pbr_materials\": true,\n \"low_poly\": true,\n \"generate_parts\": true,\n \"face_limit\": 0,\n \"enable_rigging\": true,\n \"enable_animation\": true,\n \"stability\": 0,\n \"use_speaker_boost\": true,\n \"similarity_boost\": 0,\n \"style_exaggeration\": 0,\n \"speed\": 0,\n \"upscale_ratio\": 0,\n \"creativity\": 0,\n \"resemblance\": 0,\n \"denoise\": 0,\n \"compression_repair\": 0,\n \"halo_reduction\": 0,\n \"recover_detail\": 0,\n \"detail\": 0,\n \"grain\": 0,\n \"refine_strength\": 0,\n \"realism\": 0,\n \"face_enhancement\": true,\n \"face_enhancement_strength\": 0,\n \"face_enhancement_creativity\": 0,\n \"target_region\": \"all\",\n \"color_preservation\": true,\n \"vectorize\": true,\n \"vectorization_mode\": \"spline\",\n \"vectorization_color_mode\": \"color\",\n \"vectorization_layering\": \"stacked\",\n \"vectorization_filter_speckle\": 0,\n \"vectorization_color_precision\": 0,\n \"vectorization_layer_difference\": 0,\n \"vectorization_corner_threshold\": 0,\n \"vectorization_length_threshold\": 0,\n \"vectorization_splice_threshold\": 0,\n \"vectorization_max_iterations\": 0,\n \"vectorization_path_precision\": 0,\n \"transparency\": true,\n \"reframe\": true,\n \"tileability\": true,\n \"projection\": \"EQUIRECTANGULAR\",\n \"projection_strength\": 0,\n \"refill\": true,\n \"camera_transform\": {\n \"distance_delta\": 0,\n \"rotation_delta\": {\n \"pitch_delta\": null,\n \"yaw_delta\": null,\n \"roll_delta\": null\n },\n \"zoom_delta\": {\n \"fov_y_delta\": null\n }\n },\n \"camera_trajectory\": [\n {\n \"time\": 0,\n \"azimuth\": 0,\n \"elevation\": 0,\n \"distance\": 0\n }\n ],\n \"scene_lighting\": {\n \"lights\": []\n },\n \"tile_grid\": {\n \"shape\": \"SQUARE\",\n \"orientation\": \"DIAMOND\",\n \"elevation\": 0,\n \"facing\": 0,\n \"footprint_width\": 1,\n \"footprint_depth\": 1,\n \"height\": 0,\n \"tile_width\": 128,\n \"light_from\": \"left\"\n },\n \"output_fit\": {\n \"trim\": false,\n \"canvas\": \"CONTENT\",\n \"width\": 0,\n \"height\": 0,\n \"scale\": \"PLACE\",\n \"anchor\": \"TOP_LEFT\",\n \"padding\": 0\n },\n \"nine_slice\": true,\n \"parallax\": {\n \"layers\": 5,\n \"cuts\": [\n 0\n ],\n \"loop\": false\n },\n \"color_palette\": {\n \"colors\": [],\n \"reference_set_id\": \"\"\n },\n \"expression\": \"\",\n \"target_language\": \"\",\n \"audio_sections\": [],\n \"audio_extension\": {\n \"before_seconds\": 0,\n \"after_seconds\": 0\n },\n \"video_section\": {\n \"start_seconds\": 0,\n \"end_seconds\": 0\n },\n \"guidance_files\": [],\n \"seed\": -1,\n \"mask\": {\n \"file_id\": \"\",\n \"for_transparency\": true,\n \"for_nontransparency\": true,\n \"edge_radius\": 0\n },\n \"session_name\": \"\",\n \"session_id\": \"\",\n \"webhook\": {\n \"url\": \"\",\n \"events\": [\n \"inference.completed\"\n ],\n \"metadata\": {}\n }\n}" response = http.request(request) puts response.read_body ``` ```csharp var client = new RestClient("https://api.app.layer.ai/api/v2/workspaces/:workspace_id/inferences"); var request = new RestRequest("", Method.Post); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"subtitle_preset\": \"\",\n \"subtitle_color\": \"\",\n \"subtitle_secondary_color\": \"\",\n \"subtitle_alignment\": \"top\",\n \"base_model_id\": \"\",\n \"reference_sets\": [],\n \"modality\": \"text\",\n \"prompt\": \"\",\n \"negative_prompt\": \"\",\n \"width\": 0,\n \"height\": 0,\n \"auto_aspect_ratio\": true,\n \"auto_resolution\": \"\",\n \"batch_size\": 4,\n \"num_inference_steps\": 0,\n \"guidance_scale\": 0,\n \"prompt_strength\": 0,\n \"quality\": \"low\",\n \"sharpness\": 0,\n \"prompt_enhancement\": \"off\",\n \"duration_seconds\": 0,\n \"generate_audio\": true,\n \"keep_audio\": true,\n \"draft\": true,\n \"instrumental\": true,\n \"loop\": true,\n \"output_format\": \"mp3\",\n \"lyrics\": \"\",\n \"composition_plan\": {\n \"positive_styles\": [],\n \"negative_styles\": [],\n \"sections\": [\n {\n \"name\": null,\n \"duration_seconds\": null,\n \"positive_styles\": null,\n \"negative_styles\": null,\n \"lines\": null\n }\n ],\n \"respect_section_durations\": true\n },\n \"fps\": 0,\n \"video_effects\": [],\n \"use_ta_pose\": true,\n \"pose_mode\": \"A_POSE\",\n \"include_textures\": true,\n \"detailed_geometry\": true,\n \"remesh_geometry\": true,\n \"texture_resolution\": \"RES_2K\",\n \"remove_lighting\": true,\n \"mesh_density\": \"ULTRA\",\n \"preserve_uvs\": true,\n \"segment_by\": \"AUTO\",\n \"segment_part_names\": [\n \"\"\n ],\n \"segment_target\": \"CHARACTER\",\n \"segment_parts\": 0,\n \"segment_level\": \"LOW\",\n \"segment_strength\": 0,\n \"quad_mesh\": true,\n \"pbr_materials\": true,\n \"low_poly\": true,\n \"generate_parts\": true,\n \"face_limit\": 0,\n \"enable_rigging\": true,\n \"enable_animation\": true,\n \"stability\": 0,\n \"use_speaker_boost\": true,\n \"similarity_boost\": 0,\n \"style_exaggeration\": 0,\n \"speed\": 0,\n \"upscale_ratio\": 0,\n \"creativity\": 0,\n \"resemblance\": 0,\n \"denoise\": 0,\n \"compression_repair\": 0,\n \"halo_reduction\": 0,\n \"recover_detail\": 0,\n \"detail\": 0,\n \"grain\": 0,\n \"refine_strength\": 0,\n \"realism\": 0,\n \"face_enhancement\": true,\n \"face_enhancement_strength\": 0,\n \"face_enhancement_creativity\": 0,\n \"target_region\": \"all\",\n \"color_preservation\": true,\n \"vectorize\": true,\n \"vectorization_mode\": \"spline\",\n \"vectorization_color_mode\": \"color\",\n \"vectorization_layering\": \"stacked\",\n \"vectorization_filter_speckle\": 0,\n \"vectorization_color_precision\": 0,\n \"vectorization_layer_difference\": 0,\n \"vectorization_corner_threshold\": 0,\n \"vectorization_length_threshold\": 0,\n \"vectorization_splice_threshold\": 0,\n \"vectorization_max_iterations\": 0,\n \"vectorization_path_precision\": 0,\n \"transparency\": true,\n \"reframe\": true,\n \"tileability\": true,\n \"projection\": \"EQUIRECTANGULAR\",\n \"projection_strength\": 0,\n \"refill\": true,\n \"camera_transform\": {\n \"distance_delta\": 0,\n \"rotation_delta\": {\n \"pitch_delta\": null,\n \"yaw_delta\": null,\n \"roll_delta\": null\n },\n \"zoom_delta\": {\n \"fov_y_delta\": null\n }\n },\n \"camera_trajectory\": [\n {\n \"time\": 0,\n \"azimuth\": 0,\n \"elevation\": 0,\n \"distance\": 0\n }\n ],\n \"scene_lighting\": {\n \"lights\": []\n },\n \"tile_grid\": {\n \"shape\": \"SQUARE\",\n \"orientation\": \"DIAMOND\",\n \"elevation\": 0,\n \"facing\": 0,\n \"footprint_width\": 1,\n \"footprint_depth\": 1,\n \"height\": 0,\n \"tile_width\": 128,\n \"light_from\": \"left\"\n },\n \"output_fit\": {\n \"trim\": false,\n \"canvas\": \"CONTENT\",\n \"width\": 0,\n \"height\": 0,\n \"scale\": \"PLACE\",\n \"anchor\": \"TOP_LEFT\",\n \"padding\": 0\n },\n \"nine_slice\": true,\n \"parallax\": {\n \"layers\": 5,\n \"cuts\": [\n 0\n ],\n \"loop\": false\n },\n \"color_palette\": {\n \"colors\": [],\n \"reference_set_id\": \"\"\n },\n \"expression\": \"\",\n \"target_language\": \"\",\n \"audio_sections\": [],\n \"audio_extension\": {\n \"before_seconds\": 0,\n \"after_seconds\": 0\n },\n \"video_section\": {\n \"start_seconds\": 0,\n \"end_seconds\": 0\n },\n \"guidance_files\": [],\n \"seed\": -1,\n \"mask\": {\n \"file_id\": \"\",\n \"for_transparency\": true,\n \"for_nontransparency\": true,\n \"edge_radius\": 0\n },\n \"session_name\": \"\",\n \"session_id\": \"\",\n \"webhook\": {\n \"url\": \"\",\n \"events\": [\n \"inference.completed\"\n ],\n \"metadata\": {}\n }\n}", ParameterType.RequestBody); var response = client.Execute(request); ``` * Layer API > **Changed in v2.** This endpoint’s contract differs from v1\. See the [v2 migration guide](/docs/migration) for the request and response changes before you switch. Start an AI inference (image, video, 3D, or audio). Pass a `base_model_id`, at least one entry in `reference_sets`, or both — with reference sets alone a compatible base model is picked from them. Returns immediately with an ID. Poll with GET /v2/workspaces/{workspace\_id}/inferences/{inference\_id} for results. Creative Units are not checked here: an underfunded workspace is still accepted and the run then reports FAILED with error\_code INSUFFICIENT\_BALANCE. Use the estimate endpoint’s has\_sufficient\_creative\_units to check before submitting. Reference-set errors: `REFERENCE_SET_NOT_FOUND` (404 — unknown, deleted, or outside this workspace’s reach), `NO_COMPATIBLE_MODEL` (422 — no enabled base model can apply these sets), `REFERENCE_SET_REQUIRED` (422 — the chosen model needs an applicable set), `REFERENCE_SET_CONFLICT` (422 — two sets supply the same singular adapter), `REFERENCE_SET_LIMIT_EXCEEDED` (422: more sets of one kind than the model takes, e.g. a second ANIMATION set on a 3D animating model), and `INPUT_FILE_REQUIRED` (422 — the sets select an edit-only model with no asset to edit). ## Authorizations * **[bearerAuth](/docs/v2/rest-api#bearerauth)** * **[oauth2](/docs/v2/rest-api#oauth2)** * **[serviceAccount](/docs/v2/rest-api#serviceaccount)** generation:write ## Parameters ### Path Parameters **workspace\_id** required _Workspace Id_ Id of the workspace that owns the resource. string format: uuid Id of the workspace that owns the resource. ### Header Parameters **Idempotency-Key** string <= 255 characters Opaque key making a retry of this request return the first result. A 2xx response is replayed for 24 hours with `Idempotent-Replayed: true`. A 4xx releases the key. A 5xx, or a request still running, holds the key for 120 seconds, during which a retry gets 409; after that a retry executes again. The key covers the method, path, query, and byte-identical body it was first used with; reusing it for a different request is rejected with 422\. Protection is best effort: if the key store is unavailable, or a record is lost early, a retry can execute again even after an earlier 409\. See the Idempotency section of the API description. ## Request Bodyrequired _ExecuteInferenceV2Request_ REST request body for executing an inference. workspace\_id comes from path. object **subtitle\_preset** _Subtitle Preset_ Caption style, spelled exactly as one of the model’s `subtitle_presets`: any other name is quoted at the default style and refused at launch. Its `subtitle_dynamic_presets` animate word by word and bill at a higher rate, so pass the same preset to the estimate. Omit for the model’s default style. string nullable **subtitle\_color** _Subtitle Color_ Caption text colour as hex (`#FFFFFF`), for models whose capabilities report `subtitle_primary_color`. string nullable /^#(\[0-9A-Fa-f\]{3}){1,2}$/ **subtitle\_secondary\_color** _Subtitle Secondary Color_ Colour of the words the model emphasises, as hex, for models whose capabilities report `subtitle_secondary_color`. string nullable /^#(\[0-9A-Fa-f\]{3}){1,2}$/ **subtitle\_alignment** _Subtitle Alignment_ Where the captions sit vertically, for models whose capabilities report `subtitle_alignment`. string nullable Allowed values: top center bottom **base\_model\_id** _Base Model Id_ Base model to run, as an id (e.g. flux-dev), display name, or community alias. string nullable **reference\_sets** _Reference Sets_ Reference sets to apply, up to 25. Array