Generate Video - GoEnhance API

Request

Header Params

Authorization

string

optional

Example:

Bearer xxx

Body Params application/json

args

object

required

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

>= 3<= 30

reference_video_url

string

required

Max - 50M(mp4/mov) https url

seed

integer

optional

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

>= -1<= 2147483647

video_refer

enum<integer>

optional

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

Allowed values:

123

prompt

string

optional

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

>= 0 characters<= 500 characters

subject_only

boolean

optional

Keep only the main subject, remove the background

subject_prompt

string

optional

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>

optional

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

Allowed values:

PERSONCUSTOM

bg_custom

boolean

optional

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

bg_color

string

optional

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

type

enum<string>

required

mx-v2v

Allowed value:

mx-v2v

Example

{
  "args": {
    "model": 2,
    "duration": 10,
    "reference_video_url": "https://cdn.goenhance.ai/user/goenhance/0dc5cb142ed43e0616881942c920d4fc.mp4"
  },
  "type": "mx-v2v"
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.goenhance.ai/api/v1/video2video/generate' \
--header 'Authorization: Bearer xxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "args": {
        "model": 2,
        "duration": 10,
        "reference_video_url": "https://cdn.goenhance.ai/user/goenhance/0dc5cb142ed43e0616881942c920d4fc.mp4"
    },
    "type": "mx-v2v"
}'

Responses

🟢200成功

application/json

Body

code

integer

required

msg

string

required

data

object

required

img_uuid

string

required

Examples

Successfail

{
  "code": 0,
  "msg": "Success",
  "data": {
    "img_uuid": "c12b656c-747a-44fd-9c80-add79b0c52d5"
  }
}

🟠401Unauthorized

🔴500Server Error