This API helps you automatically generate a social media post caption for any final video clip using AI. The caption is short, engaging, and tailored for platforms like TikTok, Instagram, YouTube Shorts, and more. It’s best suited for users who want more control or are building custom automation workflows using tools like make.com or n8n.

If you’re using the API in Publish Clips to Social Media workflow, you don’t need to call this endpoint manually—Vizard will generate a social caption for you automatically before publishing to TikTok.

🔍 What This API Does

After you’ve retrieved clip from previous step, you can call this API to generate an AI-written social caption.

The AI-generated caption will reflect the tone, platform style, and voice you specify, making your video post-ready with minimal effort.

You can:

Get platform-specific copy (e.g., TikTok-style vs. LinkedIn-style)
Choose a tone: interesting, catchy, serious, or even question-based
Specify voice: first-person or third-person

The result is a short caption designed to boost engagement on social.

Note: This API only works for videos with spoken dialogue. Silent or voiceless videos are not supported.

Example Request

curl -X POST "https://elb-api.vizard.ai/hvizard-server-front/open-api/v1/project/ai-social" \
  -H "Content-Type: application/json" \
  -H "VIZARDAI_API_KEY: YOUR_API_KEY" \
  -d '{
        "finalVideoId": 14015572,
        "aiSocialPlatform": 2,
        "tone": 2,
        "voice": 0
      }'

🔢 Parameter Values and Meanings:

Field	Type	Required	Description
`finalVideoId`	long	✅	The exported video ID from previous step (`videoId`). Please refer to Example Response
`aiSocialPlatform`	int	❌	Target platform style:1 = All (default), 2 = TikTok, 3 = Instagram, 4 = YouTube, 5 = Facebook, 6 = LinkedIn, 7 = Twitter
`tone`	int	❌	Caption tone:0 = Neutral (default), 1 = Interesting, 2 = Catchy, 3 = Serious, 4 = Question
`voice`	int	❌	Voice style:0 = First person (default), 1 = Third person

Example Response

{
  "code": 2000,
  "aiSocialContent": "Unlock your creativity and elevate your video-making skills with Spark 1.0! \uD83D\uDE80✨ Whether you're a seasoned creator or just starting out, this next-gen video understanding model simplifies the way you edit and share your content. With just a prompt, you can clip your videos like a pro! \uD83C\uDFA5\uD83D\uDCA1\n\nDiscover how to easily transform your video links from platforms like YouTube, Google Drive, and Vimeo, or simply drag and drop your files. The Clip It Your Way feature opens up endless possibilities for customization—just input any prompt and watch the magic unfold! \uD83C\uDF1F\n\nJoin our amazing community on Discord, filled with fellow creators, marketers, and industry experts who are all here to exchange ideas and help you refine your craft. \uD83C\uDF89 Plus, learn how to format your videos for social media in just seconds—making them perfectly ready for TikTok, Instagram Reels, and more!\n\nReady to take the leap? Streamline your workflow and share your brilliance directly on platforms like Facebook, Twitter, and LinkedIn in no time! \uD83C\uDF10\uD83D\uDD25 \n\n#VideoEditing #AI #ContentCreation #Vizard #Spark1.0 #SocialMediaMarketing #VideoEditingTips #TikTok #InstagramReels #YouTubeShorts #ContentCreators #JoinUs #VideoOptimization #CreatorCommunity"
}

🔢 Parameter Values and Meanings:

Field	Type	Description
`code`	int	Status code: 2000 = Success-1000 = Invalid request4001 = Invalid API key4002 = No speech/dialogue detected4006 = Illegal parameter
`errMsg`	string	Error message (only appears if the request fails)
`aiSocialContent`	string	The generated social post text (only returned when code = 2000)

Note: The response may take anywhere from a few seconds to a couple of minutes.