Skip to main content
POST
Generate Video

Overview

The Video to Video Generate API allows you to transform source videos using advanced AI models. This powerful API enables you to apply various styles, effects, and transformations to your videos, creating entirely new content while preserving the core motion and structure of the original.

Headers

Authorization
string

Body

application/json
model
integer
required

Model ID , From /api/v1/video2video/modellist , use the value in item

duration
integer
required

The duration of the video conversion, in seconds

Required range: 3 <= x <= 30
reference_video_url
string
required

Max - 50M(mp4/mov) https url

seed
integer

Random seed value, used to fix the video conversion, generally -1 is used

Required range: -1 <= x <= 2147483647
video_refer
enum<integer>

V2 Only, the V2 model is used to convert videos to different conversion intensities. The options are More prompt, balance, and More video.

Available options:
1,
2,
3
prompt
string

V2 Only, the V2 version of the model can change the content of the video, such as putting on a hat.

Maximum string length: 500
subject_only
boolean

Keep only the main subject, remove the background

subject_prompt
string

Only valid when subject_type = CUSTOM.Prompt used to retain the subject. For example, if you write dog, only the dog in the video will be converted into anime style, and the rest will retain the real state.

subject_type
enum<string>

Used to select whether you want the system default retention principal or a custom retention principal.

Available options:
PERSON,
CUSTOM
bg_custom
boolean

While keeping the subject, the background is replaced with a solid color background.

bg_color
string

This takes effect when bg_custom = true.must be hash color, such as #000000

resolution
enum<string>

v5 only (default 720p)

Available options:
540p,
720p
custom_callback_url
string<uri>

Optional. A publicly accessible HTTPS URL. When the task status changes (processing / success / failed), GoEnhance sends a POST request to this URL. The request body is identical to the response of GET /api/v1/jobs/detail. If your server does not respond with HTTP 200, the notification is retried up to 3 times, with a 3-second timeout per attempt.

Example:

"https://your-server.com/goenhance/callback"

Response

code
integer
required
msg
string
required
data
object
required