Arcads

Change the playback speed of an audio file — slow it down or speed it up. Supports speeds from 0.5× (half speed) to 2× (double speed). Max input: 500 MB, 30 minutes. Args: - productId (string, optional) - audioPath (string, required): S3 path or URL of the source audio - speed (number, required): Speed multiplier between 0.5 and 2.0 (e.g. 0.5 = slow-mo, 2 = 2× speed) Returns: Audio asset id. The inline widget polls and displays the result automatically. Processing typically takes ~5–10 seconds.

arcads_change_speed_audio

Change the playback speed of a video — slow it down or speed it up. Supports speeds from 0.5× (half speed) to 2× (double speed). Max input: 500 MB, 30 minutes. Args: - productId (string, optional) - videoPath (string, required): S3 path or URL of the source video - speed (number, required): Speed multiplier between 0.5 and 2.0 (e.g. 0.5 = slow-mo, 2 = 2× speed) Returns: Video asset id. The inline widget polls and displays the result automatically. Processing typically takes ~5–15 seconds.

arcads_change_speed_video

Replace the voice track in a video with a different voice using the Arcads API. The local file is uploaded automatically. Args: - productId (string, required) - videoPath (string, required): S3 path - voiceId (string, required): Target voice ID Returns: Video asset id. The inline widget polls and displays the result automatically. Processing typically takes ~30 seconds.

arcads_change_voice

Place one or more videos or images on top of a background using the Arcads API. Supports picture-in-picture, watermarks, app screen inserts, b-roll cutaways, and any overlay composition. All local file paths are uploaded automatically — no need to call arcads_upload_media first. Args: - productId (string, required): UUID of the product to associate with - backgroundPath (string, required): Local or S3 path of the background (video or image). A video background sets the composition's TOTAL DURATION and overlays are clipped to it, so make it the full-length element. - backgroundVolume (number 0–1, default 1.0): Audio volume of the background - layers (array, required): Ordered list of overlays (rendered bottom-to-top) Each layer has: path (string, required): Local or S3 path of the overlay media mediaType ('video'|'image', required): Type of the overlay file startSeconds (number, default 0): When the layer appears (seconds from start) durationSeconds (number, required): How long the layer is visible volume (number 0–1, default 0): Audio volume of the overlay (0 = muted) objectFit ('contain'|'cover', default 'contain'): How a FULL-CANVAS layer (one with no rect) fills the frame — 'cover' crops the overflow, 'contain' keeps the whole frame visible. A layer WITH a rect always covers its rect. rect (object, optional): Position and size as fractions of canvas (0.0–1.0) x, y, width, height — omit rect entirely to fill the full canvas height is OPTIONAL when BOTH the background and this overlay are local files: it is then computed from the overlay's aspect ratio so the layer is never distorted. Pass height explicitly when either file is an S3 path. Common rect presets (height auto-computed when omitted for local files): Full screen: omit rect entirely PiP bottom-right: { x: 0.60, y: 0.72, width: 0.36 } PiP bottom-left: { x: 0.04, y: 0.72, width: 0.36 } Center insert (80%): { x: 0.10, y: 0.20, width: 0.80 } Small watermark: { x: 0.75, y: 0.88, width: 0.20 } Returns: Asset id and status. The inline widget polls and displays the result automatically. Processing typically takes ~1 minute.

arcads_layer_videos

Create a new brand in your Arcads workspace. Users may still call a brand a product — treat that as the same account. The returned id is the productId generation tools expect. Args: - name (string, required): Brand name, at least 2 characters - description (string, optional) - targetAudience (string, optional) - mainFeatures (string[], optional) - painPoint (string, optional) - perceived (string, optional) Returns: The created brand: id, name, and any provided fields.

arcads_create_brand

Compose an original music track from a written description, at a chosen length. Use it for the background bed of an ad, a hook sting, or any soundtrack the workspace does not already have. Instrumental by default, which is what a track sitting under a voiceover wants; set instrumentalOnly to false to let it sing. Describe the music itself — genre, mood, instrumentation, tempo, key, energy and how it evolves ("warm lo-fi hip-hop, mellow Rhodes and soft vinyl crackle, 80 BPM, lifting slightly in the last third"). Name the sound rather than its source: "blockbuster superhero score" carries the brief that "Marvel-style" does, and "gritty analog synthwave" the one that "like Stranger Things" does. Musical terms are what get through — the upstream provider rejects a prompt that asks for the sound of a named work, artist, band, film, franchise, game or brand, and the whole call fails. Match duration to the video the track plays under, so the bed runs to the last frame. When a generation comes back rejected, rewrite the prompt in purely musical terms — drop the named reference first, then any "sounds like" or "in the style of" phrasing — and re-run with the new wording. To put the finished track under a video, pass the video as the background to arcads_layer_videos with backgroundVolume set for the mix, and the music as a layer. Args: - productId (string, optional): UUID of the brand — auto-selected if you only have one - prompt (string, required): Description of the music to compose - duration (integer, optional): Track length in seconds, 3–600 (default 60) - instrumentalOnly (boolean, optional, default true): Keep the track wordless; false allows vocals Returns: Audio asset id. The inline widget polls and displays the result automatically. Credits scale with duration. Processing typically takes ~10–15 seconds.

arcads_create_music

Edit a video using Grok's video editing model via the Arcads API. Max input: 100 MB, 8 seconds. The local file is uploaded automatically. Args: - productId (string, required) - videoPath (string, required): S3 path — OR use sourceVideoAssetId - sourceVideoAssetId (string, optional): UUID of an existing Arcads video asset - prompt (string, required, max 4096): Instruction for the edit - resolution ('480p'|'720p', default '720p') Returns: Video asset id. The inline widget polls and displays the result automatically. Processing typically takes ~1–2 minutes.

arcads_grok_video_edit

Extend the duration of a previously generated Sora2 video using the same model. This tool appends more content to an existing Sora2 asset, guided by a new prompt. The source video must have been generated with arcads_generate_video_sora2. Args: - productId (string, optional) - sourceVideoAssetId (string, required): ID of the existing Sora2 video asset to extend - prompt (string, required): Description of what should happen in the extended portion - duration (number, required): Duration to ADD in seconds — must be one of: 4, 8, 12, 16, 20 Returns: Video asset id. The inline widget polls and displays the result automatically. Processing typically takes ~60–120 seconds.

arcads_extend_sora2

Extend a video by generating additional continuation footage using the Arcads API. The local file is uploaded automatically. Args: - productId (string, required) - videoPath (string, required): S3 path of the video to extend - prompt (string, required, min 10 chars): Description of how to extend the video - aspectRatio ('16:9'|'9:16'|'auto', optional): Output aspect ratio Returns: Asset id. The inline widget polls and displays the result automatically. Processing typically takes ~2 minutes.

arcads_extend_video

Extract the audio track from a video file using the Arcads API. The local file is uploaded automatically. Args: - productId (string, required) - videoPath (string, required): S3 path Returns: Audio asset id. The inline widget polls and displays the result automatically. Processing typically takes ~5 seconds.

arcads_extract_audio

Extract a specific time segment from a video as a new clip. Use this to cut a precise portion of a video by specifying start and end timestamps. Max input: 200 MB. Args: - productId (string, optional) - videoPath (string, required): S3 path or URL of the source video (max 200 MB) - startSeconds (number, required): Start time of the segment in seconds (e.g. 5.5) - endSeconds (number, optional): End time in seconds. If omitted, extracts to the end of the video. Returns: Video asset id. The inline widget polls and displays the result automatically. Processing typically takes ~5–15 seconds.

arcads_extract_scene

Extract a single frame from a video as an image using the Arcads API. The local file is uploaded automatically. Args: - productId (string, required) - videoPath (string, required): S3 path - frame ('first'|'last'|'select', default 'first'): Which frame to extract - framePosition (number, optional): Position in seconds — required when frame='select' Returns: Image asset id. The inline widget polls and displays the result automatically. Processing typically takes ~5–10 seconds.

arcads_extract_frame

Showcase your clothing on virtual models with realistic try-on videos. Accepts 1–14 clothing images. Call `arcads_list_situations` with contentType='fashion_tryon' to find available situationIds. Processing typically takes ~17 minutes.

arcads_fashion_tryon

Create engaging gameplay ad videos with AI actors overlaid on your gameplay footage. Requires an Arcads situationId (actor). Call `arcads_list_situations` with contentType='talking_actor' to find available situationIds. Processing typically takes ~16 minutes.

arcads_gameplay_ad

Generate an image using a textual description. IMPORTANT: Use ALWAYS this tool when the user ask to create/generate/produce an image. Args: - productId (string, required): UUID of the product to associate with - prompt (string, required): Description of the image to generate - model (string, default 'nano-banana'): Image model to use 'nano-banana' or 'nano-banana-2' — fast, general purpose 'gpt-image' or 'gpt-image-2' — OpenAI GPT image (supports reference images, up to 5) 'gpt-image-2-5-flare' or 'gpt-image-2-5-sunburst' — GPT Image 2.5; edits change only what the prompt names. Flare is the fast default, Sunburst trades speed for tighter control across successive edits 'seedream', 'seedream_5_lite' or 'seedream_5_pro' — Seedream (5 Pro = highest quality, slower) 'grok_image' — Grok image 'reve_2_1' — Reve 2.1 (text-to-image, edit, and remix up to 8 references) - aspectRatio ('1:1'|'16:9'|'9:16', default '1:1'): Output aspect ratio - referenceImages (array of strings, optional): Local file paths or S3 paths (up to 14; gpt-image supports up to 5) - nbGenerations (integer 1–10, default 1): Number of variants Returns: Asset id(s) and status. The inline widget polls each id and displays the results automatically. Processing typically takes ~1 minute.

arcads_generate_image

OpenAI's image model with precise control, preserved details, and ultra-fast speed. Use model='gpt-image-2-5-flare' for the latest generation, where an edit changes only what the prompt names, or 'gpt-image-2-5-sunburst' for tighter control across successive edits. Processing typically takes 1–3 minutes.

arcads_generate_image_gpt

Generate images with xAI Grok. Supports text-to-image and editing with one reference image. Processing typically takes ~15 seconds.

arcads_generate_image_grok

Outstanding and realistic images from prompt and references; also works for image editing. Use model='nano-banana-2' for up to 14 reference images. Processing typically takes ~1 minute.

arcads_generate_image_nano_banana

Generate images with Reve 2.1. Uses text-to-image with no references, edit mode with one reference image, and remix mode when multiple references are provided (up to 8). Processing typically takes ~15 seconds.

arcads_generate_image_reve

High-resolution visuals with strong character and product consistency. Use model='seedream_5_lite' for up to 4 references and faster generation, or model='seedream_5_pro' for the highest-quality Seedream 5 (slower). Processing typically takes ~1 minute.

arcads_generate_image_seedream

Generate high-quality influencer-style images with AI. Text-to-image only — no reference images supported. Processing typically takes ~1 minute.

arcads_generate_image_ugc_studio

Generate a talking-head video by driving an actor with a script (TTV) or an audio file (STS). Local file paths and HTTP/HTTPS URLs for referenceAudios and referenceImages are handled automatically. If the MCP runs remotely (Docker/cloud), local paths will fail — use a public URL instead (upload with: curl -s -F "reqtype=fileupload" -F "fileToUpload=@/path" https://catbox.moe/user/api.php). ## Actor source — pick exactly one: - situationId: Use a predefined Arcads actor/situation - sourceVideoAssetId: Use an actor from an existing video asset (UUID) - referenceImages: Use a custom actor sourced from an image (1 image) ## Audio source — pick exactly one: - script: Text-to-video (TTV) — Arcads synthesises the voice from the script - referenceAudios: Speech-to-speech (STS) — drives the actor with the provided audio (1 file) ## Valid combinations: | Actor source | Audio source | Notes | |--------------------|-----------------------|------------------------------------| | situationId | script (TTV) | voiceId optional | | situationId | referenceAudios (STS) | voiceId optional | | sourceVideoAssetId | script (TTV) | voiceId required | | sourceVideoAssetId | referenceAudios (STS) | voiceId required | | referenceImages | script (TTV) | voiceId required | | referenceImages | referenceAudios (STS) | voiceId required | Args: - productId (string, required) - situationId (string, optional): Predefined actor/situation ID — call `arcads_list_situations` first to find one - sourceVideoAssetId (string, optional): Existing video asset UUID to source the actor from - referenceImages (array of 1 string, optional): S3 path of the actor image - script (string, optional): Script for TTV mode - referenceAudios (array of 1 string, optional): S3 path of the audio for STS mode - autoAddScriptEmotion (boolean, optional): Let Arcads inject emotions into the script (TTV only) - voiceId (string, optional): Voice ID — required when using sourceVideoAssetId or referenceImages - audioSettings (object, optional): Fine-grained voice settings (speed, stability, similarityBoost, style, useSpeakerBoost) Returns: Asset id and status. The inline widget polls and displays the result automatically. Processing typically takes ~7 minutes.

arcads_audio_driven

Generate a talking-head video using the OmniHuman model via the Arcads API. Identical interface to arcads_audio_driven but uses a different underlying AI model. Local files are uploaded automatically. ## Actor source — pick exactly one: - situationId: Use a predefined Arcads actor/situation - sourceVideoAssetId: Use an actor from an existing video asset (UUID) - referenceImages (1 image): Use a custom actor from an image ## Audio source — pick exactly one: - script (TTV): Arcads synthesises the voice from the script - referenceAudios (1 audio file, STS): Drives the actor with the provided audio Args: same as arcads_audio_driven — productId, situationId/sourceVideoAssetId/referenceImages, script/referenceAudios, autoAddScriptEmotion, voiceId, audioSettings Call `arcads_list_situations` to discover available situationId values. Returns: Asset id. The inline widget polls and displays the result automatically. Processing typically takes ~11 minutes.

arcads_omnihuman

Generate, create, produce, make, or render a video from a text prompt. Covers any request to create a new video clip, movie, animation, short, reel, ad, or motion content from a description — including text-to-video and image-to-video (with optional start/end frame images for transitions). Supports aspect ratios for every social format: '9:16' (TikTok, Reels, Shorts, portrait), '16:9' (YouTube, landscape), '1:1' (Instagram, square). Generates 3–15 second clips, up to 10 variants per call. Uses the Kling 3.0 model by default. Local file paths and HTTP/HTTPS URLs for startFrame / endFrame are uploaded automatically. Args: - productId (string, optional): UUID of the product to associate with — auto-selected if you only have one - prompt (string, required): Description of the video to generate - aspectRatio ('16:9'|'9:16'|'1:1', default '16:9'): Output aspect ratio - duration (integer 3–15, default 5): Video length in seconds - startFrame (string, optional): Path or URL of the first frame (image-to-video) - endFrame (string, optional): Path or URL of the last frame (requires startFrame) - nbGenerations (integer 1–10, default 1): Number of variants to generate - enhance (boolean, optional): Let the prompt be auto-enhanced before generation Returns asset id(s) and status. The inline widget polls each id and displays the results automatically. Processing typically takes ~3 minutes.

arcads_generate_video

Create or edit video through a single prompt with Gemini Omni Flash. Text-to-video, image-to-video (pass referenceImages, up to 3), reference-to-video, conversational editing of existing clips (pass referenceVideos, up to 3), or first/last-frame conditioning (pass startFrame, optionally with endFrame). Optionally set aspectRatio, resolution and duration — omit for the model to auto-pick. Processing typically takes ~2 minutes.

arcads_generate_video_omni_flash

xAI's Grok model with text-to-video and image-to-video modes. Processing typically takes ~2 minutes.

arcads_generate_video_grok

Alibaba's unified model with native joint audio-video synthesis and multilingual lip-sync. Processing typically takes ~4 minutes.

arcads_generate_video_happy_horse

Create high-fidelity video clips with complex movement and realistic transitions. Processing typically takes ~3 minutes.

arcads_generate_video_kling_26_pro

Generate 4K Kling videos with configurable audio and style scale control. Processing typically takes ~4 minutes.

arcads_generate_video_kling_30_4k

Create high-fidelity video clips with complex movement and realistic transitions. Local files uploaded automatically. Processing typically takes ~3 minutes.

arcads_generate_video_kling_30_pro

A post-trained MiniMax H3, the same family as H3 Max: stronger prompt adherence and better aesthetics than H3, generated at higher throughput and priced below H3 Max. Renders natively only, so it stops at 720p and takes no reference images. Use it only when the user names H3 Max Turbo (or MiniMax Turbo) — it is not the default video model. Stay on H3 for the cheapest clip, for 1080p or 4K, or to carry a subject from reference images; stay on H3 Max to carry a reference video or reference audio into the shot, or when they name that one. Takes a start frame (and an optional end frame) for keyframe control. Generates native synchronized audio inside the clip. Always generates at 720p. Local files uploaded automatically. Processing typically takes under a minute.

arcads_generate_video_minimax_h3_max_turbo

A post-trained MiniMax H3, tuned for stronger prompt adherence and better aesthetics and generated faster — and priced above H3 for it. Renders natively only, so it stops at 720p. Reach for it over H3 when the look matters more than the cost and 720p is enough. Use H3 Max Turbo (arcads_generate_video_minimax_h3_max_turbo) when they name Turbo — same look, cheaper and faster, but no reference support. Takes a start frame (and an optional end frame) for keyframe control, or reference images/videos/audio (up to 12 combined) to carry a subject, motion and voice into the shot — cannot be combined with startFrame. Generates no speech. Local files uploaded automatically. Processing typically takes ~1 minute.

arcads_generate_video_minimax_h3_max

The cheapest video model here per second, with stylised cinematic motion and strong prompt adherence, up to 15 seconds and up to 4K. Takes a start frame (and an optional end frame) for keyframe control, or up to 9 reference images to carry a subject, product or style into the shot. H3 Max and H3 Max Turbo both stop at 720p; H3 Max costs more, Turbo is faster and cheaper. Generates no speech. Local files uploaded automatically. Processing typically takes ~2 minutes.

arcads_generate_video_minimax_h3

ByteDance's fast video model with 4–12 second duration and audio support. Processing typically takes ~4 minutes.

arcads_generate_video_seedance_15

ByteDance's fast video model with 4–15 second duration, audio support, and multi-reference inputs. Processing typically takes ~7 minutes.

arcads_generate_video_seedance_20

ByteDance's most natural video model: creator-style realism, spoken dialogue rendered in-video, and a character kept consistent across clips. The only model here that reaches 30 seconds in a single clip, and the only one that conditions on a reference video or a reference audio — so use it to make a specific actor say a line (from the prompt, by lip-syncing a provided voice, or from a reference video plus a prompt for a new line). Processing typically takes ~7 minutes.

arcads_generate_video_seedance_25

Generate hyper-realistic video scenes with complex physics and vivid details. Use model='sora2_pro' for superior detail and smoother motion. Processing typically takes ~12 minutes.

arcads_generate_video_sora2

Create broadcast-ready footage with cinematic understanding and consistency. Pass referenceImages (up to 3) OR startFrame/endFrame — not both. Processing typically takes ~3 minutes.

arcads_generate_video_veo31

Animate avatars with expressive gestures and emotions using AI-powered motion. Call `arcads_list_situations` with contentType='gestures' to find available situationIds. Processing typically takes ~5 minutes.

arcads_gestures

Return the current state of an Arcads asset and, when ready, its signed download URL. Use this when the user explicitly asks for the status or download URL of an existing asset. For generation tools, the inline widget already shows the result — you do not need to call this after a generation. Asset statuses: created → pending → generated (success) or failed. Uploaded media sits at 'uploaded', which is also ready. Args: - assetId (string): UUID of the asset Returns: - id, type, status, productId, createdAt, updatedAt - downloadUrl (string, present once status is 'generated' or 'uploaded' AND the asset is a media asset) — signed S3 URL of the file. - data (object, optional) — for LLM (text) assets, the response text lives in data.generatedText.

arcads_get_asset