Skip to main content
POST

Headers

Authorization
string

Body

application/json
model
enum<string>
required

Model name. Must be minimax-h3-flex.

Available options:
minimax-h3-flex
prompt
string
required

Text prompt describing the video. Required. Max 7000 characters.

Maximum string length: 7000
image_url
string<uri>

Optional first-frame image. JPG/PNG/WEBP/AVIF, ≤10MB, shortest side ≥300px. When provided, runs image-to-video and the output ratio follows the image.

image_end_url
string<uri>

Optional last-frame image (same limits as image_url). Must be used together with image_url.

resolution
enum<string>
default:2K

Output resolution. Also sets the price — see the pricing table above. 2K takes longer than 720p.

Available options:
480p,
720p,
2K
duration
integer
default:5

Video duration in seconds. Any integer from 5 to 15.

Required range: 5 <= x <= 15
ratio
enum<string>
default:16:9

Aspect ratio. Text-to-video only; ignored when image_url is provided (the ratio then follows the input image).

Available options:
21:9,
16:9,
4:3,
1:1,
3:4,
9:16
audio_url
string<uri>

Optional. Drives the video with this audio: the characters lip-sync to it, and the output's soundtrack is the audio clip from audio_start to audio_start + duration. Pass the whole song or speech track; it does not need to be pre-cut. MP3/WAV/M4A/AAC/FLAC/OGG, ≤50MB. Works with text-to-video, image-to-video and first/last frame. No extra charge.

audio_start
number
default:0

Optional. Where to start reading audio_url, in seconds (decimals allowed). Must be used together with audio_url. The audio left after audio_start must cover duration: a shortfall of less than one second is accepted (the video then ends with the audio); anything more is rejected before tokens are charged.

Required range: x >= 0
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