Vizard automatically creates the post caption and relevant hashtags for you. You can publish the video immediately or schedule it for a future time.

Supported platforms

TikTok
YouTube
Instagram
Facebook
Twitter(X)
LinkedIn

This endpoint corresponds to the Auto Schedule feature in the Vizard web app, which appears when you submit a long video for clipping.

Example Request

curl -X POST "https://elb-api.vizard.ai/hvizard-server-front/open-api/v1/project/publish-video" \
  -H "Content-Type: application/json" \
  -H "VIZARDAI_API_KEY: YOUR_API_KEY" \
  -d '{
    "finalVideoId": 14015572,
    "publishTime": 1767605047792,
    "socialAccountId": "123456",
    "post": "Your post content here",
    "title": "Your YouTube title here"
  }'

If publishTime is not provided, the video will be published immediately. title is only used when publishing to YouTube and can be omitted for other platforms.

Parameter Values and Meanings

Field	Type	Required	Description
`finalVideoId`	long	✅	The ID of the generated video returned from Retrieve Output Videos endpoint.
`publishTime`	long	❌	Unix timestamp for scheduled publishing. If not set, the video is published immediately.
`socialAccountId`	String	✅	The ID of the connected social account returned by the Retrieve Social Accounts endpoint.
`post`	String	❌	Video description for the social post. Empty string is allowed — AI will generate content automatically. Character limits vary by platform.
`title`	String	❌	YouTube video title. Only used for YouTube. If empty, an AI-generated title will be used.

Example Response

{
  "code": 2000
}

Parameter Values and Meanings

Field	Type	Description
`code`	int	Status code of the request.
`errMsg`	string	Error message, shown only when `code` is not `2000`

Status Codes

Code	Meaning
`2000`	Publish succeeded
`-1000`	Invalid request parameters
`4001`	Invalid API key
`4004`	Feature requires upgrade
`4006`	Illegal parameter
`4011`	Invalid social account ID

Video Post Character Limits

Platform	Character limit
TikTok	2,200
YouTube	5,000 (post), 100 (title)
Instagram	2,200
Facebook	2,200
Twitter (X)	280
LinkedIn	3,000