Arcads

Adjust the camera angle of an image with horizontal, vertical, and zoom controls. Processing typically takes ~30 seconds.

arcads_camera_angle

Add cinematic camera movements to your avatar videos with AI-powered motion presets. Call `arcads_list_situations` with contentType='camera_movement' to find available situationIds. Processing typically takes ~4 minutes.

arcads_camera_movement

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

Create a named folder in a brand. A folder groups projects; create a project inside it with arcads_create_project to hold assets. Folders sit directly under a brand and contain projects. When the user asks for sub-folders, create a folder for the top level and a project for each sub-folder inside it. Args: - brandId (string, optional): Brand UUID — auto-selected if the workspace has one brand - name (string): Folder name Returns: The created folder's id and name.

arcads_create_folder

Create a named project inside a folder. Projects hold generated assets: file assets into one with arcads_add_assets_to_project. Args: - folderId (string): UUID of the folder, from arcads_list_folders or arcads_create_folder - name (string): Project name Returns: The created project's id and name.

arcads_create_project

Compose an original music track from a written description, at a chosen length. Use lyrics written or owned by the user; do not copy existing songs or imitate an artist's voice. 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. Two models: - elevenlabs (default): writes exactly the requested length, 3–600s. The one for a bed laid under a video, so the track ends on the last frame. Credits scale with duration; ready in ~10–15 seconds. - suno_v6: full songs, and the one that sings your own lyrics. Its length is a target (20–360s) that the track can overshoot, so reach for it when the user asks for Suno, a standalone song, or sung lyrics. A flat 10 credits for up to two tracks; ready in ~1–2 minutes. 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 - model (string, optional): elevenlabs (default) or suno_v6 - duration (integer, optional): Track length in seconds (default 60) — exact with elevenlabs, a target with suno_v6 - instrumentalOnly (boolean, optional, default true): Keep the track wordless; false allows vocals - lyrics (string, optional): Words to sing, with suno_v6 and instrumentalOnly false Returns: Audio asset id. The inline widget polls and displays the result automatically.

arcads_create_music

Signed link that downloads one asset's file from the Arcads library.

library_download

Edit an existing video itself with Seedance 2.5: its shots, cuts, camera moves, timing and sound carry over, and only what the prompt names changes — swap the person or the product, restyle a scene. Name the video @video1 and the reference images @image1, @image2… in the prompt ("replace the woman in @video1 with the woman in @image1"). Reference videos bring in a motion, a person or a scene to copy into it and are named @video2, @video3… ("make the woman in @video1 dance like the man in @video2"). The result keeps the source's aspect ratio and about its length (up to 30s), and its own sound, voice included — a swap to someone who should sound different takes a voice change on the result. Processing typically takes ~7 minutes.

arcads_edit_video_seedance_25

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 a video by generating additional continuation footage using the Arcads API. The local files are uploaded automatically. Two models continue the video: - omni_flash (default): Omni Flash 1.1, the continuation to use for a plain extend. Adds 3–10s. Processing typically takes ~2 minutes. - seedance_25: Seedance 2.5, for a continuation that brings in a product, a character or a place from reference images, or that runs 4–30s. It keeps the source's shape and delivers a silent video. Processing typically takes ~5 minutes. 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 - model ('omni_flash'|'seedance_25', optional): Model that continues the video - aspectRatio ('16:9'|'9:16'|'auto', optional): Output aspect ratio (omni_flash) - referenceImages (string[], optional): Images the continuation keeps consistent (seedance_25) - duration (4–30, optional): Seconds of new footage (seedance_25) - resolution ('480p'|'720p'|'1080p', optional): Output resolution (seedance_25) Returns: Asset id. The inline widget polls and displays the result automatically.

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

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, create, produce or make an image from a text description. Covers any request for a new image, picture, visual or illustration. 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', 'nano-banana-2', or 'nano-banana-2-1' — fast, general purpose; nano-banana-2-1 is Nano Banana 2.1, the strongest editor '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 - 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) - referenceVideos (array of strings, optional, nano-banana-2-1 only): Up to 10 local video files, S3 paths, or public YouTube URLs. Combined length up to 25 minutes. The model reads frames and ignores audio. - 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-1' (Nano Banana 2.1) for the strongest edits (up to 14 reference images, 1K–4K, thinking level, optional search grounding). model='nano-banana-2' is the previous generation. Processing typically takes ~1 minute.

arcads_generate_image_nano_banana

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

Primary tool for talking-head UGC from Arcads situations (catalog actors). **Default model is `arcads_1.0`** — same as Studio — for maximum fidelity to the selected situation's reference performance. Use `audio_driven` or `omnihuman` only when the user asks for those models or for STS. If the user wants a talking actor but does not name a model, ask which they prefer — Arcads 1.0 (Studio default), audio_driven, or omnihuman — before calling. If they have no preference, use arcads_1.0. ## Audio vs script (pick exactly one) - **script** — text-to-video (TTV). Works with all models (`arcads_1.0`, `audio_driven`, `omnihuman`). - **referenceAudios** — speech-to-speech (STS), one audio file. **Only** `audio_driven` or `omnihuman` — never `arcads_1.0`. ## Args - model (default `arcads_1.0`) - productId (optional — auto-selected when the workspace has one brand) - actors — array of { situationId, voiceId? } (one entry per actor; same script for all) - autoAddScriptEmotion (optional, TTV only) - projectId (optional — omit to use a dedicated API project) For a **custom actor from an image or existing asset** (not a situation), use `arcads_audio_driven` or `arcads_omnihuman` instead. Processing time varies by model (~minutes). The inline widget polls and shows the video when ready.

arcads_generate_talking_actor

Legacy talking-head tool (audio_driven model). Do NOT use for catalog situation + script — use arcads_generate_talking_actor (default arcads_1.0) instead. Use this tool for custom actor sources (referenceImages, sourceVideoAssetId), STS with uploaded audio, or when the user chose audio_driven over Arcads 1.0 / omnihuman. Only use footage, photos or voices of people who have consented to this use, such as the user themselves, their own actors, or Arcads stock actors. 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

Legacy talking-head tool (omnihuman model). Do NOT use for catalog situation + script — use arcads_generate_talking_actor (default arcads_1.0) instead. Use for custom actor sources (referenceImages, sourceVideoAssetId), STS with uploaded audio, or when the user chose omnihuman over Arcads 1.0 / audio_driven. Same args as arcads_audio_driven. Only use footage, photos or voices of people who have consented to this use, such as the user themselves, their own actors, or Arcads stock actors. 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

Black Forest Labs FLUX 3 Max — a post-trained FLUX 3 Video tuned for prompt adherence and visual quality, with native synchronized audio inside the clip (dialogue plus ambient sound and effects). 5–20 seconds at 720p or 1080p. Use it when the user asks for FLUX 3 Max (or FLUX) by name; arcads_generate_video_seedance_25 stays the video model for every other request, and is the one to use to carry reference images, video or audio into the shot. Takes a text prompt alone, or a start frame with an optional end frame for keyframe control. With a start frame, aspectRatio 'auto' follows the frame's shape. Local files and HTTP/HTTPS image URLs for startFrame / endFrame are uploaded automatically. Processing typically takes about a minute and a half.

arcads_generate_video_flux_3_max

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 Grok Imagine 1.5 — image-to-video from exactly one reference image plus a prompt (not the same as arcads_generate_video_grok text-to-video). Pass that image as referenceImages with a single path. Duration 1–15 seconds at 480p or 720p. Processing typically takes ~4 minutes.

arcads_generate_video_grok_imagine_15

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

Kling 3.0 Pro Turbo — fast, high-fidelity text-to-video or image-to-video (optional start frame). Distinct from arcads_generate_video_kling_30_pro (standard Kling 3.0 Pro tier). Prompt up to 3072 characters. Duration 3–15 seconds. Processing typically takes ~3 minutes.

arcads_generate_video_kling_30_pro_turbo

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

Kling 3.0 — text-to-video or image-to-video with an optional start and end frame, 3–15 seconds. Aspect ratios: '9:16' (TikTok, Reels, Shorts), '16:9' (YouTube), '1:1' (Instagram). Local file paths and HTTP/HTTPS URLs for startFrame / endFrame are uploaded automatically. Distinct from arcads_generate_video_kling_30_pro (higher-fidelity Pro tier). Processing typically takes ~3 minutes.

arcads_generate_video_kling_30

Kling clips at 720p or 1080p from 3 to 30 seconds in 9:16, 16:9, 1:1 or 21:9. Animates between a start frame and an optional end frame (image-to-video), or carries up to 10 reference images, 5 reference videos and 7 elements into the shot, named @Image1, @Video1, @Element1 and so on in the prompt. An element is a character or product shown from several angles, kept consistent across the clip. Frames and references are separate modes, so pick one per generation. Local files uploaded automatically. Processing typically takes ~2 minutes.

arcads_generate_video_kling_40

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 reference images, video or audio into the shot at the lowest price; stay on H3 Max for those references with the post-trained look, 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. Only use footage, photos or voices of people who have consented to this use, such as the user themselves, their own actors, or Arcads stock actors. Reach for it over H3 when the look matters more than the cost and 720p is enough. H3 (arcads_generate_video_minimax_h3) takes the same references at the lowest price; use this one when references need the post-trained look. 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 — any mix works, reference audio alone with just a prompt included; references and startFrame are separate modes, so pick one per generation. Generates native synchronized audio inside the clip — dialogue plus ambient sound and effects. Local files uploaded automatically. Processing typically takes ~1 minute.

arcads_generate_video_minimax_h3_max