PixVerse Platform Docs
  1. Learn about PixVerse Platform
PixVerse Platform Docs
  • Learn about PixVerse Platform
    • Introduce to PixVerse Platform
    • Our latest version v5.5/v5.6!
    • Quick Start
  • Getting started
    • How does the API work?
    • How to get API key?
    • How to check account balance?
    • How to subscribe API plans?
    • How to use Text-to-video
    • How to use Image-to-video
    • How to use Effects?
    • How to use Image template?
    • How to use Transition(First-last frame Feature)
    • How to use Speech(Lip sync)?
    • Lip sync TTS speaker list
    • How to use Extend?
    • How to use Sound effects?
    • How to use Fusion(Reference to video)?
    • How to use Restyle?
    • How to use Multi-transition?
    • How to use Swap?
    • How to use Mimic?
    • How to get video generation status?
    • How to use Webhook
  • API Reference
    • API Parameter Description
    • Video Generation
      • Text-to-Video generation
      • Image-to-Video generation
      • Transition(First-last frame) generation
      • Speech(Lipsync) generation
      • Get Speech(Lipsync) tts list
      • Fusion(reference to video) generation
      • Multi-transition video generation
      • Restyle video generation
      • Restyle effect list
      • Swap mask generation
      • Swap video generation
      • Sound effect generation
      • Extend generation
      • Get Video Generation Status
      • Mimic generation
    • Image generation
      • Image template generation
      • Get Image generation
    • Upload Image
      POST
    • Upload Video&audio
      POST
    • Get user credit balance
      GET
  • Trouble Shooting
    • Common errors and Solutions
    • Error codes
    • FAQ
  • Resources
    • Model & Pricing
    • Rate limit
    • Support
    • Change Logs
    • Term of Service
    • Privacy policy
  • PixVerse Tools
    • PixVerse MCP
  • Schemas
    • Schemas
      • controller.ResponseData
      • controller.T2vCreateVideoGenerateTaskReq
      • dto.APIKeyCreateReq
      • dto.APIKeyDefaultResp
      • dto.APIKeyDetail
      • dto.APIKeyList
      • dto.AccountApi
      • dto.AccountCreditsAddReq
      • dto.AddCasbinUserRoleReq
      • dto.AddEffectReq
      • dto.AddRoleReq
      • dto.AddScoringRelationReq
      • dto.AdminAddMusicItem
      • dto.AdminAddMusicRequest
      • dto.AdminAddTemplateItem
      • dto.AdminAddTemplateRequest
      • dto.AdminAddTemplateResponse
      • dto.AdminAddWebTemplateItem
      • dto.AdminAddWebTemplateRequest
      • dto.AdminAddWebTemplateResponse
      • dto.AdminAllUsersResp
      • dto.AdminAppFeedDetail
      • dto.AdminAppListAllFeedsReq
      • dto.AdminAppListAllFeedsResp
      • dto.AdminAppListAllVideosReq
      • dto.AdminAppListAllVideosResp
      • dto.AdminAppVideoDetail
      • dto.AdminFeedsGetFeaturePoolReq
      • dto.AdminFeedsSetFeaturePoolReq
      • dto.AdminGetMusicItem
      • dto.AdminGetMusicRequest
      • dto.AdminGetMusicResponse
      • dto.AdminTemplateListItem
      • dto.AdminTemplateListResponse
      • dto.AdminUpdateMusicRequest
      • dto.AdminUpdateTemplateRequest
      • dto.AdminUpdateWebTemplateRequest
      • dto.AdminUpdateWebTemplateResponse
      • dto.AdminVideos
      • dto.AdminWebTemplateListItem
      • dto.AdminWebTemplateListRequest
      • dto.AdminWebTemplateListResponse
      • dto.AllAdminVideosReq
      • dto.AllAdminVideosResp
      • dto.AppAddTemplateItem
      • dto.AppAddTemplateRequest
      • dto.AppAddTemplateResponse
      • dto.AppCommentCountsRequest
      • dto.AppCommentCountsResponse
      • dto.AppCommentDeleteRequest
      • dto.AppCommentDeleteResponse
      • dto.AppCommentItem
      • dto.AppCommentListRequest
      • dto.AppCommentListResponse
      • dto.AppCommentRequest
      • dto.AppCommentResponse
      • dto.AppExtendReq
      • dto.AppI2VReq
      • dto.AppLikeCountsRequest
      • dto.AppLikeCountsResponse
      • dto.AppLikeDeleteRequest
      • dto.AppLikeDeleteResponse
      • dto.AppLikeRequest
      • dto.AppLikeResponse
      • dto.AppMusicAllListRequest
      • dto.AppMusicAllListResponse
      • dto.AppMusicDetailRequest
      • dto.AppMusicDetailResponse
      • dto.AppMusicRecommendRequest
      • dto.AppMusicRecommendResponse
      • dto.AppMusicTrendingListRequest
      • dto.AppMusicTrendingListResponse
      • dto.AppPublicVideoReq
      • dto.AppPublicVideoResp
      • dto.AppPurchaseReq
      • dto.AppPurchaseResp
      • dto.AppReportRequest
      • dto.AppReportResponse
      • dto.AppRetryVideoReq
      • dto.AppT2VReq
      • dto.AppTemplateDetailListFeedItem
      • dto.AppTemplateDetailListRequest
      • dto.AppTemplateDetailListResponse
      • dto.AppTemplateDetailRequest
      • dto.AppTemplateDetailResponse
      • dto.AppTemplateListItem
      • dto.AppTemplateListRequest
      • dto.AppTemplateListResponse
      • dto.AppUpdateTemplateRequest
      • dto.AppVideoCallbackInfo
      • dto.AppVideoCallbackReq
      • dto.AppVideoCreateReq
      • dto.AppVideoCreateResp
      • dto.AppVideoDetail
      • dto.AppVideoListReq
      • dto.AppVideoListResp
      • dto.AppWebDeleteVideoReq
      • dto.AppWebVideoDetailReq
      • dto.AppWebVideoResp
      • dto.AppleLoginReq
      • dto.AppleLoginResp
      • dto.ApplePayVerifyReceiptReq
      • dto.AssetCreateReq
      • dto.AssetCreateResp
      • dto.AssetDeleteResp
      • dto.Audit
      • dto.AvatarDeleteRequest
      • dto.AvatarDeleteResponse
      • dto.AvatarDetailItem
      • dto.AvatarGenerateMediaRequest
      • dto.AvatarGenerateMediaResponse
      • dto.AvatarItem
      • dto.AvatarMaterialItem
      • dto.AvatarMediaItem
      • dto.AvatarPreviewVoiceRequest
      • dto.AvatarUpdateRequest
      • dto.AvatarUpdateResponse
      • dto.AvatarWhiteListIsExist
      • dto.BatchUploadMediaReq
      • dto.BatchUploadMediaResp
      • dto.BetaTesterMemberReq
      • dto.BetaTesterMemberResp
      • dto.BlockAccountReq
      • dto.BusinessEffectListItem
      • dto.BusinessEffectSelectResponse
      • dto.CallbackInfo
      • dto.CheckAccountRoleReq
      • dto.CheckAccountRoleResp
      • dto.CommonData
      • dto.CorporateReq
      • dto.CreateCateReq
      • dto.CreateCateResp
      • dto.CreateImg2VideoGenerateTaskReq
      • dto.CreateImgGenerateTaskReq
      • dto.CreateLabelingJobReq
      • dto.CreateLabelingJobResp
      • dto.CreateTxt2VideoGenerateTaskReq
      • dto.CreateVideo2VideoGenerateTaskReq
      • dto.CreditsPurchaseResp
      • dto.DeleteAccountReq
      • dto.DeleteCategoryReq
      • dto.DeleteEffectReq
      • dto.DeleteFeedsReq
      • dto.DeleteLabelingJobReq
      • dto.DeleteLabelingJobResp
      • dto.DeleteMediaReq
      • dto.DeviceTokenReq
      • dto.DiscordCallbackReq
      • dto.DiscordImg2VideoReq
      • dto.DiscordLoginReq
      • dto.DiscordLoginResp
      • dto.DiscordTxt2VideoReq
      • dto.DislikeMediaReq
      • dto.EditMediaReq
      • dto.ExportLabelingJobReq
      • dto.ExportLabelingJobResp
      • dto.ExportMediaScoreReq
      • dto.ExportMediaScoreResp
      • dto.ExportMediaVideoReq
      • dto.ExportMediaVideoResp
      • dto.FeConfigs
      • dto.FeConfigsReq
      • dto.FeedCreateReq
      • dto.FeedDataResp
      • dto.FeiShuAuthReq
      • dto.FeiShuAuthResp
      • dto.FeiShuLoginReq
      • dto.FeiShuLoginResp
      • dto.FirebasePushReq
      • dto.GetAccountMediaHistoryReq
      • dto.GetAccountMediaHistoryResp
      • dto.GetAdminAllUsersResp
      • dto.GetAdminUserInfoResp
      • dto.GetAllJobsReq
      • dto.GetAllJobsResp
      • dto.GetAllMediasReq
      • dto.GetAllUmodelsReq
      • dto.GetAllUmodelsResp
      • dto.GetAllVersionsReq
      • dto.GetAllVersionsResp
      • dto.GetAllVideoModelsResp
      • dto.GetAllVideoUmodelsReq
      • dto.GetAllVideoUmodelsResp
      • dto.GetAllVideosReq
      • dto.GetAuditResultReq
      • dto.GetAuditResultResp
      • dto.GetAvatarDetailResponse
      • dto.GetAvatarListResponse
      • dto.GetAvatarOrMaterialOrMediaDetailRequest
      • dto.GetAvatarOrMaterialOrMediaLibraryListRequest
      • dto.GetAvatarOrMaterialOrMediaListRequest
      • dto.GetCategoryIdByNameReq
      • dto.GetCategoryIdByNameResp
      • dto.GetFeCfgReq
      • dto.GetFeCfgResp
      • dto.GetFeConfigsReq
      • dto.GetFeConfigsResp
      • dto.GetGenerateCreditsRequest
      • dto.GetGenerateCreditsResponse
      • dto.GetLikedVideoReq
      • dto.GetMediaDetailReq
      • dto.GetMediaDetailResp
      • dto.GetMembersInfoReq
      • dto.GetMusicItem
      • dto.GetOpenAPICreditsRecordReq
      • dto.GetOpenAPICreditsRecordV2Req
      • dto.GetOpenapiMediaDetailResp
      • dto.GetPhoneCodeReq
      • dto.GetTasksByJobIdReq
      • dto.GetTasksByJobIdResp
      • dto.GetTraceLogByTraceIdReq
      • dto.GetTraceLogByTraceIdResp
      • dto.GetUploadTokenResp
      • dto.GetUserCreditsByIDResp
      • dto.GetUserCreditsRecordItem
      • dto.GetUserCreditsRecordReq
      • dto.GetUserCreditsRecordResp
      • dto.GetUserCreditsResp
      • dto.GetUserInfoByTokenResp
      • dto.GetV3AccountMediaHistoryReq
      • dto.GetV3AccountMediaHistoryResp
      • dto.GetV3AllVideosResp
      • dto.GetV3LikedVideoReq
      • dto.GetV3VideoDetailReq
      • dto.GetVideoDetailByDiscordCmdIdReq
      • dto.GetVideoLastFrameReq
      • dto.GetVideoLastFrameResp
      • dto.GetVideoTTSListResp
      • dto.GoogleLoginResp
      • dto.GooglePayVerifyReq
      • dto.Img2VideoDebugReq
      • dto.Img2VideoDebugResp
      • dto.IndividualReq
      • dto.LabelingJobApi
      • dto.LabelingTaskApiWithStatus
      • dto.LikeMediaReq
      • dto.LipSync
      • dto.ListVisionaries
      • dto.ListWebAppVideoReq
      • dto.ListWebVideos
      • dto.LoginPhoneWithCodeReq
      • dto.LoginPhoneWithCodeResp
      • dto.LoginPhoneWithPasswordReq
      • dto.LoginPhoneWithPasswordResp
      • dto.LoginReq
      • dto.LoginResp
      • dto.LoraCheckMediaReq
      • dto.MaterialDetailItem
      • dto.MediaDetailItem
      • dto.MembersChangeReq
      • dto.MembersChangeResp
      • dto.MembersPlanDetailsResp
      • dto.MembersProductsReq
      • dto.MembersProductsResp
      • dto.MessagePushReq
      • dto.MotionBrushSegmentationReq
      • dto.MotionBrushSegmentationResp
      • dto.NewGoogleLoginReq
      • dto.OpenAPIAccountBenefitsBalanceResp
      • dto.OpenAPICreditsRecordItem
      • dto.OpenAPICreditsRecordResp
      • dto.OpenAPIGetAccountInfoResp
      • dto.OpenAPIListOrdersReq
      • dto.OpenAPIListProductsReq
      • dto.OpenAPIListProductsResp
      • dto.OpenAPILoginReq
      • dto.OpenAPILoginResp
      • dto.OpenAPIMembersChangeResp
      • dto.OpenAPIOrderDetailsReq
      • dto.OpenAPIOrdersDetailsResp
      • dto.OpenAPIPlanDetailsReq
      • dto.OpenAPIPlanDetailsResp
      • dto.OpenAPIPurchaseReq
      • dto.OpenAPIPurchaseResp
      • dto.OpenAPIT2VReq
      • dto.OpenAPIT2VResp
      • dto.OpenAPIUnsubscribeReq
      • dto.OpenAPIV2CreditsRecordItem
      • dto.OpenAPIV2CreditsRecordResp
      • dto.OpenAPIWithdrawUnsubscribeReq
      • dto.OpenAPIit2vReq
      • dto.OrdersDetailsReq
      • dto.OrdersDetailsResp
      • dto.OrdersListResp
      • dto.PaymentConfirmReq
      • dto.PaymentConfirmResp
      • dto.QueryAccountReq
      • dto.RegisterAccountReq
      • dto.RegisterWithPhoneReq
      • dto.RegisterWithPhoneResp
      • dto.RemoveMediaReq
      • dto.ResetPasswordAccountReq
      • dto.ResetPasswordAccountResponse
      • dto.ResponseData500
      • dto.SearchCategoriesReq
      • dto.SearchCategoriesResp
      • dto.SearchMediasReq
      • dto.SearchMediasResp
      • dto.SendMailReq
      • dto.ShowCaseVideoVideo
      • dto.SockPuppetAddRequest
      • dto.SockPuppetAddResponse
      • dto.SubmitAvatarOrMaterialReq
      • dto.SubmitAvatarOrMaterialResponse
      • dto.SubmitJobReq
      • dto.SubmitJobResp
      • dto.SubmitTasksReq
      • dto.SubmitTasksResp
      • dto.TTS
      • dto.TensorSet
      • dto.Txt2ImgReq
      • dto.Txt2ImgResp
      • dto.UmodelApi
      • dto.UpdateAccountInfoReq
      • dto.UploadFileReq
      • dto.UploadFileResp
      • dto.UploadImageReq
      • dto.UploadImageResp
      • dto.UploadImgResp
      • dto.UploadMediaReq
      • dto.UploadMediaResp
      • dto.UserPermissions
      • dto.V2OpenAPII2VReq
      • dto.V2OpenAPII2VResp
      • dto.V2OpenAPIT2VReq
      • dto.V2OpenAPIT2VResp
      • dto.VideoDebugReq
      • dto.VideoDebugResp
      • dto.VideoDeleteReq
      • dto.VideoModelInfo
      • dto.VideoResp
      • dto.VideoUpscaleReq
      • dto.VisionaryCallbackInfo
      • dto.VisionaryCallbackReq
      • dto.VisionaryCreateReq
      • dto.VisionaryCreateResp
      • dto.VisionaryDetailReq
      • dto.VisionaryDetailResp
      • dto.VisionaryListReq
      • dto.VisionaryListResp
      • dto.WaitlistReq
      • dto.WebDeleteVideoReq
      • dto.WebExtendVideoReq
      • dto.WebExtendVideoResp
      • dto.WebF2VReq
      • dto.WebF2VResp
      • dto.WebTemplateListItem
      • dto.WebTemplateListReq
      • dto.WebTemplateListResponse
      • dto.WebVideoCallbackInfo
      • dto.WebVideoCallbackReq
      • dto.WebVideoCreateReq
      • dto.WebVideoCreateResp
      • dto.WebVideoListReq
      • dto.WebVideoListResp
      • model.AppleLoginApi
      • model.AssetData
      • model.AssetDetailOrDeleteReq
      • model.AssetImg
      • model.AssetListReq
      • model.AssetListResp
      • model.ClipInfo
      • model.DiscordLoginApi
      • model.FeishuLoginApi
      • model.GoogleLoginApi
      • model.LoginApi
  1. Learn about PixVerse Platform

Our latest version v5.5/v5.6!

What's new in v5.5/v5.6 model#

1. Audio-Visual Synchronization#

A complete sound field including BGM, SFX, and character dialogues, making the video richer and more comprehensive in terms of audio.

2. Multi-Shot Camera Control#

1 image + 1 description + Multi-shot enabled
= More abundant lens language design, including push-in, switching, and shot scale changes.

Example#

promptimageresult
The video shows A close-up shot shows a man with reddish-brown hair and a beard, wearing a black shirt and a red earpiece in his left ear. He looks slightly off-camera to the right. He says, "i didn't have any choices.". Cut to the next scene, a close-up shot of a blonde woman looking directly ahead. The back of the man's head is visible in the foreground on the left. The woman says angrily, "Sorry, you gotta tell the judge." Cut to the next scene, a close-up shot of the man with reddish-brown hair and a beard. The back of the woman's head is visible in the foreground on the left. The man says sadly, "you are my sunshine". Cut to the next scene, a close-up shot of the blonde woman looking directly ahead. The back of the man's head is visible in the foreground on the left. The woman says calmly,"fine".upload_9b1a4037-d14f-4f3b-a5c9-127e6b7e2b4e.jpg
Shot 1: Wide shot of the predator sprinting.
Shot 2: Close-up of the prey darting across the grass.
Shot 3: Aerial shot of the chase. Sounds of rapid footsteps, predator growling, prey’s frantic breathing.
-
She can not stand her work and she is going to quit and yell in the office.-

How to use?#

Request body#

Image to video as a example
{
    "duration": 10,
    "img_id": 0,
    "model": "v5.5",
    "motion_mode": "normal",
    "negative_prompt": "people",
    "prompt": "The video shows A close-up shot shows a man with reddish-brown hair and a beard, wearing a black shirt and a red earpiece in his left ear. He looks slightly off-camera to the right. He says, \"i didn't have any choices.\".  Cut to the next scene, a close-up shot of a blonde woman looking directly ahead. The back of the man's head is visible in the foreground on the left. The woman says angrily, \"Sorry, you gotta tell the judge.\" Cut to the next scene, a close-up shot of the man with reddish-brown hair and a beard. The back of the woman's head is visible in the foreground on the left. The man says sadly, \"you are my sunshine\". Cut to the next scene, a close-up shot of the blonde woman looking directly ahead. The back of the man's head is visible in the foreground on the left. The woman says calmly,\"fine\".",
    "quality": "360p",
    "generate_audio_switch":true,
    "generate_multi_clip_switch":true,
    "thinking_type":"disabled",
    "seed": 0
}

Parameter#

Parameter NameRequiredTypeDescription
generate_audio_switchOptionalbooleanAudio switch. Controls whether the video has multiple clips or a single clip. true: Audio on , false: Audio off
generate_multi_clip_switchOptionalbooleanSingle or multi-clip switch. controls single-clip and multi-clip generation modes. true: Multi-clip , false: Single-clip
thinking_typeOptionalstringPrompt reasoning enhancement. Controls whether the system should enhance your prompt with internal reasoning and optimization. "enabled" : Turn on system-level optimization. "disabled" : Turn off system-level optimization. "auto" or omitted: Let the model decide automatically

Addtional points#

lip_sync_switch is not supported in v5.5
sound_effect_switch is not supported in v5.5
generate_audio_switch is supported in v5.5/v5.6
generate_multi_clip_switch is supported in v5.5
thinking_type is supported in v5.5
template_id cannot be used with generate_audio_switch or generate_multi_clip_switch

V5.5 Capability#

ParameterText to videoImage to videoExtendTransition(not multi-transition)Fusion(Reference to video)
generate_audio_switch✅✅-✅-
generate_multi_clip_switch✅✅---
thinking_type✅✅---
quality & duration360p: 5,8,10
540p: 5,8,10
720p:5,8,10
1080p:5,8
360p: 5,8,10
540p: 5,8,10
720p:5,8,10
1080p:5,8
360p: 5,8,10
540p: 5,8,10
720p:5,8,10
1080p:5,8
360p: 5,8,10
540p: 5,8,10
720p:5,8,10
1080p:5,8
360p: 5,8,10
540p: 5,8,10
720p:5,8,10
1080p:5,8

Credits#

V5.5#

QualityDurationV5.5 single clip with no audioV5.5 single clip with audioV5.5 Multi clip with no audioV5.5 Multi clip with audio
360p545557585
360p890100120130
360p1099109129139
540p545557585
540p890100120130
540p1099109129139
720p5607090100
720p8120130150160
720p10132142162172
1080p5120130150160
1080p8240250270280

V5.6 Capability#

ParameterText to videoImage to videoTransition(not multi-transition)Fusion(Reference to video)
generate_audio_switch✅✅-✅
generate_multi_clip_switch----
thinking_type✅✅--
quality & duration360p: 5,8,10
540p: 5,8,10
720p:5,8,10
1080p:5,8
360p: 5,8,10
540p: 5,8,10
720p:5,8,10
1080p:5,8
360p: 5,8,10
540p: 5,8,10
720p:5,8,10
1080p:5,8
360p: 5,8,10
540p: 5,8,10
720p:5,8,10
1080p:5,8

V5.6#

QualityDurationV5.6 single clip with no audioV5.6 single clip with audio
360p53580
360p870115
360p1077122
540p53580
540p870115
540p1077122
720p54580
720p890135
720p1099144
1080p575150
1080p8150195
Previous
Introduce to PixVerse Platform
Next
Quick Start