v1

latestOpenAPI 3.1.02026-07-26590116.2 KB
Video2Video

Generate Video

post/api/v1/video2video/generate

Headers

Authorizationstring

Request body

modelinteger required

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

durationinteger required

The duration of the video conversion, in seconds

reference_video_urlstring required

Max - 50M(mp4/mov) https url

seedinteger

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

video_refer1 | 2 | 3

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

promptstring

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

subject_onlyboolean

Keep only the main subject, remove the background

subject_promptstring

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'PERSON' | 'CUSTOM'

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

bg_customboolean

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

bg_colorstring

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

resolution'540p' | '720p'

v5 only (default 720p)

custom_callback_urlstring 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 request

{
  "custom_callback_url": "https://your-server.com/goenhance/callback"
}

Response

codeinteger required
msgstring required