View as Markdown
Visibot icon

Visibot ACTION

Create Video

Process a video from a URL with custom caption settings. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Visibot account once, then configure and run Create Video from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "visibot-create-video",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    visibot: { authProvisionId: "apn_xxxxxxx" },
    videoUrl: "Video URL",
    captions: ["Captions"],
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Video inputs
Property Type Description
videoUrl Video URL string
The URL of the video to process
Required
captions Captions string[]

Array of objects with the following properties:

  • start (number) - The start time of the caption in seconds
  • end (number) - The end time of the caption in seconds
  • text (string) - The text of the caption
  • emoji (string) - The emoji of the caption

Example:

[
  {
    "start": 0,
    "end": 1,
    "text": "Hello, world!",
    "emoji": "✉️"
  }
]
Optional
language Language string
Language code (ISO-639-1) for subtitles (e.g. en, es, fr)
Optional
resizeForSocialMedia Resize for Social Media boolean
Resize the video to 9:16 vertical format for social media
Optional
captionsFontColor Captions Font Color string
Caption font color as a hex code (e.g. #FF5733)
Optional
captionsHighlightColor Captions Highlight Color string
Highlight color for spoken words as a hex code (e.g. #FF5733)
Optional
captionsOutlineColor Captions Outline Color string
Caption outline color as a hex code (e.g. #FF5733)
Optional
captionsPosition Captions Position string
Position of the captions. Use top, middle, bottom, or a value between 0.1 and 0.9
Optional
captionsFontSize Captions Font Size integer
Font size for captions, between 18 and 65
Optional
captionsFontFamily Captions Font Family string
Font family for captions
Optional
captionsAddEmojis Add Emojis to Captions boolean
Whether to add emojis to captions
Optional
captionsOutlineThickness Captions Outline Thickness integer
Thickness of the caption outline, between 0 and 20
Optional
callback Callback URL string
URL to notify when video processing is complete
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
visibot-create-video
Version
0.0.1
App
Visibot
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes