The Runway connector lets your AI agent act in each user's Runway account. Each user connects their own Runway access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 27 tools.
- Tools
- 27
- What they doRead · write · destructive
- 8 · 17 · 28 read17 write2 destructive
- Users sign in with
- Access token
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Runway connection
In AgentKit > Connections, create a Runway connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'runway'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Runway:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'runway_organization_get',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "runway"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Runway:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="runway_organization_get",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Runway credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolrunway_organization_getGet the API organization's credit balance, usage tier and rate limits.Read-onlyGet Organization
Get the API organization's credit balance, usage tier and rate limits. Returns creditBalance, tier (maxMonthlyCreditSpend and per-model limits) and usage (per-model daily generations). Use this to check credits before starting jobs. Use runway_organization_usage_get for credit usage by day and model.
Inputs
This tool takes no inputs.
runway_organization_usage_getGet credit usage for the organization broken down by day and model, for up to 90 days.Read-onlyGet Credit Usage
Get credit usage for the organization broken down by day and model, for up to 90 days. Returns results (each date with used credits per model) and the list of models. Use this to report spend. Use runway_organization_get for the current balance.
Inputs
beforeDatestring- Day after the last day to include (exclusive), YYYY-MM-DD. Default: today. Example: 2026-11-15
startDatestring- First day to include, YYYY-MM-DD. Default: 30 days before beforeDate. Example: 2026-10-15
runway_task_getGet the status and output of a Runway generation task.Read-onlyGet Task
Get the status and output of a Runway generation task. Returns id, status (PENDING, THROTTLED, RUNNING, SUCCEEDED, FAILED or CANCELLED), createdAt, progress, failure details, and output URLs when it succeeded. Output URLs expire, so download them soon. Use this after any runway_*_create tool to wait for the result. Poll no more than every 5 seconds.
Inputs
idstringrequired- Task ID returned by any Runway generation tool. Example: 17f20503-6c24-4c16-946b-35dbbce2af2f
runway_voice_getGet one custom voice by ID.Read-onlyGet Voice
Get one custom voice by ID. Returns id, name, description, status, createdAt and a preview URL when available. Use this to check whether a new voice is ready. Use runway_voices_list to find IDs.
Inputs
idstringrequired- Custom voice ID. Get it from runway_voices_list or runway_voice_create. Example: 6f4d5f4a-2b1c-4a39-9b55-2c9d0e9a8f31
runway_voices_listList the organization's custom voices.Read-onlyList Voices
List the organization's custom voices. Returns data (voices with id, name, description, status and createdAt) and nextCursor. Use this to find a custom voice ID for runway_text_to_speech_create. Preset voices are not listed; pass them by presetId.
Inputs
cursorstring- Cursor from the previous response, to get the next page. Example: eyJpZCI6IjZmNGQ1ZjRhIn0
limitinteger- Voices per page, 1 to 100. Default: 50. Example: 50default
50
runway_workflow_getGet a published workflow, including its graph of nodes.Read-onlyGet Workflow
Get a published workflow, including its graph of nodes. Returns id, name, description and the graph with node IDs and their outputs. Use this to find the node IDs and output keys to override in runway_workflow_run.
Inputs
idstringrequired- Published workflow ID. Get it from runway_workflows_list or copy it from the Runway developer portal. Example: 0d6c1d1f-7b0a-4b8b-8c41-9a3c5d2e7f10
runway_workflow_invocation_getGet the status and outputs of a workflow run.Read-onlyGet Workflow Invocation
Get the status and outputs of a workflow run. Returns id, status, progress, failure details and the output of each node when finished. Use this after runway_workflow_run to wait for the result.
Inputs
idstringrequired- Workflow invocation ID returned by runway_workflow_run. Example: 9b2f3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d
runway_workflows_listList the published workflows the organization can run through the API.Read-onlyList Workflows
List the published workflows the organization can run through the API. Returns workflows with id, name, description and version details. Use this to find a workflow ID for runway_workflow_run.
Inputs
This tool takes no inputs.
runway_character_performance_createStart a Runway Act-Two job that drives a character image or video with the motion and expressions of a performance video, spending credits.WriteAnimate Character Performance
Start a Runway Act-Two job that drives a character image or video with the motion and expressions of a performance video, spending credits. Returns the task id. Generation runs asynchronously; poll runway_task_get with the id until status is SUCCEEDED, then read the output URLs. Use this for performance capture. Use runway_image_to_video_create for prompt-driven animation.
Inputs
characterobjectrequired- Character to animate: {"type": "image", "uri": ...} or {"type": "video", "uri": ...}, where uri is an HTTPS URL, a data URI, or a runway:// URI. Example: {"type": "image", "uri": "https://example.com/images/character.png"}
referenceobjectrequired- Driving performance video whose motion and expressions are transferred: {"type": "video", "uri": ...}. Example: {"type": "video", "uri": "https://example.com/videos/performance.mp4"}
bodyControlboolean- If true, transfer body motion as well as facial expression. Example: true
expressionIntensityinteger- Strength of facial expressions, 1 to 5. Default: 3. Example: 3
ratiostring- Output resolution: 1280:720, 720:1280, 960:960, 1104:832, 832:1104 or 1584:672. Example: 1280:720one of
1280:720720:1280960:9601104:832832:11041584:672 seedinteger- Random seed, 0 to 4294967295. Reuse a seed with identical inputs to get similar results; leave empty for a random seed. Not every model accepts a seed. Example: 42
runway_image_to_video_createStart a Runway job that animates an image into a video with the chosen model, spending credits.WriteGenerate Video from Image
Start a Runway job that animates an image into a video with the chosen model, spending credits. Returns the task id. Generation runs asynchronously; poll runway_task_get with the id until status is SUCCEEDED, then read the output URLs. Use this when you have a starting image. Use runway_text_to_video_create for a prompt only and runway_video_to_video_create to edit an existing video.
Inputs
modelstringrequired- Video model to use, for example gen4.5, gen4_turbo, veo3.1, veo3.1_fast, kling3.0_pro or seedance2. Accepted ratio, duration and other fields differ by model. Example: gen4.5one of
gen4.5gen4_turboveo3.1veo3.1_fastklingO3_4khailuo3kling3.0_4khappyhorse_1_0kling2.5_turbo_prokling3.0_prokling3.0_standardklingO3_proklingO3_standardseedance2seedance2_fastseedance2_minigemini_omni_flashgrok_imagine_1_5wan3gemini_omni_flash_1.1wan3_primeh3_maxseedance2_5grok_imagine_1_5_litekling_4gemini_omni_flash_1.2kling_4_flashhailuo3_highspeedhailuo3_lite promptImagestringrequired- Image to animate as the first frame: an HTTPS URL, a data URI, or a runway:// URI. Some models also accept an array of {"uri", "position"} objects for first and last frames, which can be passed in options instead. Example: https://example.com/images/storefront.jpg
durationinteger- Video length in seconds; required by some models, including gen4.5, and allowed values depend on the model (gen4.5 accepts 2 to 10). Example: 5
optionsobject- Extra model-specific body fields merged into the request as-is, for settings this tool has no input for (for example contentModeration, outputFormat, audio, resolution or references). Field names are Runway's camelCase names and depend on the model; see https://docs.dev.runwayml.com/api/. Example: {"contentModeration": {"publicFigureThreshold": "auto"}}
promptTextstring- Text prompt describing what should appear in the output. Required by some models. Maximum length depends on the model (1000 characters for the example model). Example: A slow dolly shot through a neon-lit alley in the rain
ratiostring- Output resolution as width:height in pixels; required by some models, including gen4.5, and allowed values depend on the model (gen4.5 accepts 1280:720, 720:1280, 1104:832, 960:960, 832:1104 and 1584:672). Example: 1280:720
seedinteger- Random seed, 0 to 4294967295. Reuse a seed with identical inputs to get similar results; leave empty for a random seed. Not every model accepts a seed. Example: 42
runway_image_upscale_createStart a Runway job that upscales an image with the Magnific Precision Upscaler, spending credits.WriteUpscale Image
Start a Runway job that upscales an image with the Magnific Precision Upscaler, spending credits. Returns the task id. Generation runs asynchronously; poll runway_task_get with the id until status is SUCCEEDED, then read the output URLs. Use this to enlarge an image. Use runway_video_upscale_create for video.
Inputs
imageUristringrequired- Image to upscale: an HTTPS URL, a data URI, or a runway:// URI. Example: https://example.com/images/portrait.png
flavorstring- Upscaling style: sublime, photo or photo_denoiser. Example: photoone of
sublimephotophoto_denoiser scaleFactorinteger- Upscale factor: 2, 4, 8 or 16. Example: 4one of
24816 sharpeninteger- Sharpening strength, 0 to 100. Example: 20
smartGraininteger- Film grain added to hide artifacts, 0 to 100. Example: 10
ultraDetailinteger- Amount of fine detail added, 0 to 100. Example: 30
runway_music_createStart a Runway job that composes music from a text description, spending credits.WriteGenerate Music
Start a Runway job that composes music from a text description, spending credits. Returns the task id. Generation runs asynchronously; poll runway_task_get with the id until status is SUCCEEDED, then read the output URLs. Use this for soundtracks. Use runway_sound_effect_create for sound effects.
Inputs
promptTextstringrequired- Description of the music: genre, mood, instruments, tempo, and lyrics if wanted. Up to 4100 characters. Example: Upbeat lo-fi hip hop with warm piano and vinyl crackle
durationinteger- Length in seconds, 3 to 600. Default: 30. Example: 60
instrumentalboolean- If true, generate music without vocals. Example: true
runway_sound_effect_createStart a Runway job that generates a sound effect from a text description, spending credits.WriteGenerate Sound Effect
Start a Runway job that generates a sound effect from a text description, spending credits. Returns the task id. Generation runs asynchronously; poll runway_task_get with the id until status is SUCCEEDED, then read the output URLs. Use this for effects and ambience. Use runway_music_create for music and runway_text_to_speech_create for speech.
Inputs
modelstringrequired- Sound model: eleven_text_to_sound_v2, mirelo_sfx_2_0 (requires duration) or seed_audio. Example: eleven_text_to_sound_v2one of
seed_audiomirelo_sfx_2_0eleven_text_to_sound_v2 promptTextstringrequired- Description of the sound. Example: Heavy rain on a tin roof with distant thunder
durationnumber- Length in seconds. eleven_text_to_sound_v2 accepts 0.5 to 30; mirelo_sfx_2_0 requires it (0.1 to 600); seed_audio does not take it. Example: 5
optionsobject- Extra model-specific body fields merged into the request as-is, for settings this tool has no input for (for example contentModeration, outputFormat, audio, resolution or references). Field names are Runway's camelCase names and depend on the model; see https://docs.dev.runwayml.com/api/. Example: {"loop": true}
runway_speech_to_speech_createStart a Runway job that re-speaks the speech in an audio or video file with a different voice, spending credits.WriteConvert Speech to Another Voice
Start a Runway job that re-speaks the speech in an audio or video file with a different voice, spending credits. Returns the task id. Generation runs asynchronously; poll runway_task_get with the id until status is SUCCEEDED, then read the output URLs. Use this to swap a voice and keep the delivery. Use runway_text_to_speech_create to speak new text.
Inputs
mediaobjectrequired- Audio or video whose speech is re-voiced: {"type": "audio", "uri": ...} or {"type": "video", "uri": ...}, where uri is an HTTPS URL, a data URI, or a runway:// URI. Example: {"type": "audio", "uri": "https://example.com/audio/voiceover.mp3"}
voiceobjectrequired- Voice to speak with. Either a Runway preset, {"type": "runway-preset", "presetId": "Maya"} (presets include Maya, Arjun, Serene, Bernard, Leslie, Eleanor, Noah, James, Rachel and others), or a custom voice created with runway_voice_create, {"type": "custom", "id": "<voice id>"}. Example: {"type": "runway-preset", "presetId": "Maya"}
removeBackgroundNoiseboolean- If true, remove background noise from the source first. Example: true
runway_text_to_image_createStart a Runway job that generates an image from a prompt and optional reference images, spending credits.WriteGenerate Image
Start a Runway job that generates an image from a prompt and optional reference images, spending credits. Returns the task id. Generation runs asynchronously; poll runway_task_get with the id until status is SUCCEEDED, then read the output URLs. Use this for still images. Use runway_image_upscale_create to upscale an existing image.
Inputs
modelstringrequired- Image model, for example gen4_image, gen4_image_turbo, gpt_image_2, gemini_image3_pro, seedream5_pro or ideogram_4_5. Accepted ratios and fields differ by model. Example: gen4_imageone of
gen4_image_turbogen4_imagegpt_image_2gemini_image3.1_flashmuse_imageseedream5_proseedream5_litegrok_imagine_image_2gemini_image3.1_flash_litegemini_image3_progpt_image_2_5_flaregpt_image_2_5_sunburstbria_fibo_1_5bria_fibo_edit_1_5ideogram_4_0ideogram_4_5seedream5_flashnano_banana_2.1recraft_v4_1_flashrecraft_v4_1_vectorideogram_vectorgpt_image_2_6_sunburstgpt_image_2_6_flareseedream5_pro_layersgemini_2.5_flash promptTextstringrequired- Text describing the image. Maximum length depends on the model (1000 characters for gen4_image). Reference images can be named in the prompt with @tag. Example: A product photo of @shoe on a marble pedestal, soft studio light
optionsobject- Extra model-specific body fields merged into the request as-is, for settings this tool has no input for (for example contentModeration, outputFormat, audio, resolution or references). Field names are Runway's camelCase names and depend on the model; see https://docs.dev.runwayml.com/api/. Example: {"contentModeration": {"publicFigureThreshold": "auto"}}
ratiostring- Output resolution as width:height in pixels; required by some models, including gen4_image, and allowed values depend on the model (gen4_image accepts 1024:1024, 1920:1080, 1080:1920, 1280:720, 720:1280 and others). Example: 1920:1080
referenceImagesarray- Reference images to guide the output, each with a uri (an HTTPS URL, a data URI, or a runway:// URI) and an optional tag (up to 16 characters) that the prompt can cite as @tag. gen4_image accepts up to 3. Example: [{"uri": "https://example.com/images/shoe.png", "tag": "shoe"}]
seedinteger- Random seed, 0 to 4294967295. Reuse a seed with identical inputs to get similar results; leave empty for a random seed. Not every model accepts a seed. Example: 42
runway_text_to_speech_createStart a Runway job that turns text into speech with a preset or custom voice, spending credits.WriteGenerate Speech
Start a Runway job that turns text into speech with a preset or custom voice, spending credits. Returns the task id. Generation runs asynchronously; poll runway_task_get with the id until status is SUCCEEDED, then read the output URLs. Use this for narration. Use runway_speech_to_speech_create to re-voice existing audio and runway_voice_dubbing_create to translate it.
Inputs
modelstringrequired- Speech model: eleven_v3, eleven_v4, eleven_multilingual_v2 or seed_audio. ElevenLabs models need a voice. Example: eleven_v3one of
seed_audioeleven_v4eleven_multilingual_v2eleven_v3 promptTextstringrequired- Text to speak. Maximum length depends on the model (eleven_v3: 5000 characters). Example: Welcome back! Your order has shipped and will arrive Tuesday.
optionsobject- Extra model-specific body fields merged into the request as-is, for settings this tool has no input for (for example contentModeration, outputFormat, audio, resolution or references). Field names are Runway's camelCase names and depend on the model; see https://docs.dev.runwayml.com/api/. Example: {"speed": 1.0, "languageCode": "en"}
voiceobject- Voice to speak with; required for the ElevenLabs models (seed_audio takes a reference-audio voice instead). Either a Runway preset, {"type": "runway-preset", "presetId": "Maya"} (presets include Maya, Arjun, Serene, Bernard, Leslie, Eleanor, Noah, James, Rachel and others), or a custom voice created with runway_voice_create, {"type": "custom", "id": "<voice id>"}. Example: {"type": "runway-preset", "presetId": "Maya"}
runway_text_to_video_createStart a Runway job that generates a video from a text prompt with the chosen model, spending credits.WriteGenerate Video from Text
Start a Runway job that generates a video from a text prompt with the chosen model, spending credits. Returns the task id. Generation runs asynchronously; poll runway_task_get with the id until status is SUCCEEDED, then read the output URLs. Use this for prompt-only video. Use runway_image_to_video_create to start from an image.
Inputs
modelstringrequired- Video model to use, for example gen4.5, veo3.1, veo3.1_fast, kling3.0_pro or seedance2. Accepted ratio, duration and other fields differ by model. Example: gen4.5one of
gen4.5veo3.1veo3.1_fastklingO3_4khailuo3kling3.0_4khappyhorse_1_0kling2.5_turbo_prokling3.0_prokling3.0_standardklingO3_proklingO3_standardseedance2seedance2_fastseedance2_minigemini_omni_flashgrok_imagine_1_5wan3gemini_omni_flash_1.1wan3_primeh3_maxseedance2_5grok_imagine_1_5_litekling_4gemini_omni_flash_1.2kling_4_flashhailuo3_highspeedhailuo3_lite promptTextstringrequired- Text prompt describing what should appear in the output. Maximum length depends on the model (1000 characters for the example model). Example: A slow dolly shot through a neon-lit alley in the rain
durationinteger- Video length in seconds; required by some models, including gen4.5, and allowed values depend on the model (gen4.5 accepts 2 to 10). Example: 5
optionsobject- Extra model-specific body fields merged into the request as-is, for settings this tool has no input for (for example contentModeration, outputFormat, audio, resolution or references). Field names are Runway's camelCase names and depend on the model; see https://docs.dev.runwayml.com/api/. Example: {"contentModeration": {"publicFigureThreshold": "auto"}}
ratiostring- Output resolution as width:height in pixels; required by some models, including gen4.5, and allowed values depend on the model (gen4.5 accepts 1280:720 and 720:1280). Example: 1280:720
seedinteger- Random seed, 0 to 4294967295. Reuse a seed with identical inputs to get similar results; leave empty for a random seed. Not every model accepts a seed. Example: 42
runway_video_frame_rate_enhanceStart a Runway job that interpolates a video to a higher or standard frame rate, spending credits.WriteEnhance Video Frame Rate
Start a Runway job that interpolates a video to a higher or standard frame rate, spending credits. Returns the task id. Generation runs asynchronously; poll runway_task_get with the id until status is SUCCEEDED, then read the output URLs. Use this for smoother motion or a delivery frame rate. Use runway_video_upscale_create to raise resolution.
Inputs
targetFrameratestringrequired- Target frame rate: 24, 25, 30, 48, 50, 60, 120, 23_98, 29_97 or 59_94 (underscores stand for decimals, so 29_97 is 29.97 fps). Example: 60one of
24253048506012023_9829_9759_94 videoUristringrequired- Video to convert: an HTTPS URL, a data URI, or a runway:// URI. Example: https://example.com/videos/clip.mp4
runway_video_to_video_createStart a Runway job that edits or restyles an existing video from a prompt, spending credits.WriteEdit Video
Start a Runway job that edits or restyles an existing video from a prompt, spending credits. Returns the task id. Generation runs asynchronously; poll runway_task_get with the id until status is SUCCEEDED, then read the output URLs. Use this to transform footage you already have. Use runway_text_to_video_create to generate new footage.
Inputs
modelstringrequired- Video-to-video model, for example aleph2, klingO3_pro or seedance2. Accepted fields differ by model. Example: aleph2one of
aleph2klingO3_4khailuo3klingO3_proklingO3_standardseedance2seedance2_fastseedance2_minigemini_omni_flashgemini_omni_flash_1.1seedance2_5kling_4gemini_omni_flash_1.2kling_4_flashhailuo3_highspeedhailuo3_lite videoUristringrequired- Input video to transform: an HTTPS URL, a data URI, or a runway:// URI. Length limits depend on the model (aleph2: 30 seconds or less). Example: https://example.com/videos/clip.mp4
optionsobject- Extra model-specific body fields merged into the request as-is, for settings this tool has no input for (for example contentModeration, outputFormat, audio, resolution or references). Field names are Runway's camelCase names and depend on the model; see https://docs.dev.runwayml.com/api/. Example: {"targetAspectRatio": "16:9"}
promptTextstring- Text describing the change to make or what should appear in the output. Example: Turn the scene into a snowy winter evening
seedinteger- Random seed, 0 to 4294967295. Reuse a seed with identical inputs to get similar results; leave empty for a random seed. Not every model accepts a seed. Example: 42
runway_video_upscale_createStart a Runway job that upscales a video with the Magnific creative video upscaler, spending credits.WriteUpscale Video
Start a Runway job that upscales a video with the Magnific creative video upscaler, spending credits. Returns the task id. Generation runs asynchronously; poll runway_task_get with the id until status is SUCCEEDED, then read the output URLs. Use this to raise resolution. Use runway_video_frame_rate_enhance to change only the frame rate.
Inputs
videoUristringrequired- Video to upscale: an HTTPS URL, a data URI, or a runway:// URI. Example: https://example.com/videos/clip.mp4
creativityinteger- How much new detail the upscaler may invent, 0 to 100. Example: 20
flavorstring- Look of the result: vivid or natural. Example: naturalone of
vividnatural fpsBoostboolean- If true, also raise the frame rate. Example: false
resolutionstring- Target resolution: 720p, 1k, 2k or 4k. Example: 4kone of
720p1k2k4k sharpeninteger- Sharpening strength, 0 to 100. Example: 20
smartGraininteger- Film grain added to hide artifacts, 0 to 100. Example: 10
runway_voice_createCreate a custom voice by cloning an audio sample or designing one from a text description.WriteCreate Voice
Create a custom voice by cloning an audio sample or designing one from a text description. Returns the voice with id, name and status; it becomes usable when status is READY. Use this before runway_text_to_speech_create with a custom voice. Use runway_voices_list to find existing voices.
Inputs
fromobjectrequired- Source of the voice. Clone from audio: {"type": "audio", "audio": "<uri>"} with a 10-second to 5-minute sample (an HTTPS URL, a data URI, or a runway:// URI). Or design from text: {"type": "text", "prompt": "<description>", "model": "eleven_ttv_v3" or "eleven_multilingual_ttv_v2"}. Example: {"type": "text", "prompt": "A warm, calm, middle-aged British male narrator", "model": "eleven_ttv_v3"}
namestringrequired- Voice name, up to 100 characters. Example: Brand Narrator
descriptionstring- Optional description, up to 1024 characters. Example: Voice for product explainer videos
runway_voice_dubbing_createStart a Runway job that dubs spoken audio into another language, spending credits.WriteDub Audio
Start a Runway job that dubs spoken audio into another language, spending credits. Returns the task id. Generation runs asynchronously; poll runway_task_get with the id until status is SUCCEEDED, then read the output URLs. Use this to translate speech. Use runway_speech_to_speech_create to change the voice in the same language.
Inputs
audioUristringrequired- Audio to dub: an HTTPS URL, a data URI, or a runway:// URI. Example: https://example.com/audio/interview.mp3
targetLangstringrequired- Target language code, such as en, es, fr, de, ja, hi, pt or zh. Example: esone of
enhiptzhesfrdejaarrukoiditnltrplsvfilmsroukelcsdafibghrskta disableVoiceCloningboolean- If true, use a generic voice instead of cloning the original speaker. Example: false
dropBackgroundAudioboolean- If true, leave out the background audio in the output. Example: false
numSpeakersinteger- Number of speakers in the audio, if known. Example: 2
runway_voice_isolation_createStart a Runway job that separates the voice from background noise and music in an audio file, spending credits.WriteIsolate Voice
Start a Runway job that separates the voice from background noise and music in an audio file, spending credits. Returns the task id. Generation runs asynchronously; poll runway_task_get with the id until status is SUCCEEDED, then read the output URLs. Use this to clean up recordings.
Inputs
audioUristringrequired- Audio to clean up: an HTTPS URL, a data URI, or a runway:// URI. Example: https://example.com/audio/noisy-call.mp3
runway_voice_updateRename a custom voice or change its description.WriteUpdate Voice
Rename a custom voice or change its description. Returns the updated voice. Use this to tidy voice names. Use runway_voice_delete to remove it.
- Idempotent
Inputs
idstringrequired- Custom voice ID. Get it from runway_voices_list or runway_voice_create. Example: 6f4d5f4a-2b1c-4a39-9b55-2c9d0e9a8f31
descriptionstring- New description, up to 1024 characters. Example: Updated voice for explainer videos
namestring- New voice name, up to 100 characters. Example: Brand Narrator v2
runway_workflow_runRun a published Runway workflow, optionally overriding node outputs such as prompts or input media, spending credits.WriteRun Workflow
Run a published Runway workflow, optionally overriding node outputs such as prompts or input media, spending credits. Returns the workflow invocation id. Poll runway_workflow_invocation_get with it for the result. Use this for multi-step pipelines built in Runway. Use the runway_*_create tools for a single model call.
Inputs
idstringrequired- Published workflow ID. Get it from runway_workflows_list or copy it from the Runway developer portal. Example: 0d6c1d1f-7b0a-4b8b-8c41-9a3c5d2e7f10
nodeOutputsobject- Optional overrides for node outputs. Keys are node IDs from runway_workflow_get; each value maps an output key to a typed value. Example: {"5a1c2e3f-4b6d-4e8f-9a0b-1c2d3e4f5a6b": {"prompt": {"type": "primitive", "value": "A red bicycle in the snow"}}}
runway_task_cancelCancel a running Runway task, or delete a finished task and its outputs.DestructiveCancel or Delete Task
Cancel a running Runway task, or delete a finished task and its outputs. Returns no content on success. Use this to stop a job you no longer need. Use runway_task_get to check its status first.
- Idempotent
Inputs
idstringrequired- Task ID returned by any Runway generation tool. Example: 17f20503-6c24-4c16-946b-35dbbce2af2f
runway_voice_deleteDelete a custom voice.DestructiveDelete Voice
Delete a custom voice. Returns no content on success. Use this to remove a voice you no longer need.
- Idempotent
Inputs
idstringrequired- Custom voice ID. Get it from runway_voices_list or runway_voice_create. Example: 6f4d5f4a-2b1c-4a39-9b55-2c9d0e9a8f31
No tools match.