Create MiniMax H3 video

Create MiniMax H3 video tasks via unified POST /v1/videos. Model capabilities are subject to the actual callable range of the current Tikway gateway.

Model	Resolution	Duration	Supported Modes	Audio	Reference Limitations
minimax-h3	768p / 2K	4–15 seconds	Vincent, first frame, last frame, first and last frame, full-modal reference	Native audio output; no generate_audio switch	9 images / 3 video / 3 audio

Source: MiniMax H3 Video Generation V2 API. The difference between the official website capabilities and the current unopened capabilities of the gateway can be found in this audit report.

POST https://api.tikway.ai/v1/videos

cURL

Text to video

curl --request POST \
  --url https://api.tikway.ai/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "minimax-h3",
  "prompt": "A golden retriever runs on the beach at sunset. The camera follows smoothly, and the picture has a natural and delicate film quality.",
  "duration": 5,
  "resolution": "2K",
  "aspect_ratio": "16:9"
}
'

202

{
  "id": "9552de3d-171f-4cca-b492-7baa56523239",
  "status": "pending",
  "polling_url": "https://api.tikway.ai/v1/videos/9552de3d-171f-4cca-b492-7baa56523239"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Create a MiniMax H3 video job. Parameters are narrowed according to the current Tikway gateway capabilities; for differences between models, see operation description and x-model-capabilities.

model · enum<string> · required

MiniMax H3 Model ID.

Available options: minimax-h3

prompt · string · required

Video generation or editing prompt words.

Minimum string length: 1

duration · integer · required

Required. MiniMax H3 supports integer durations of 4–15 seconds.

Required range: 4 <= x <= 15

resolution · enum<string> · required

Output resolution. Available values ​​for different models or modes are shown in the model capabilities table.

Available options: 768p, 2K

aspect_ratio · enum<string>

Video aspect ratio. When producing videos, some models will automatically determine the proportions based on the input material.

Available options: adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16

frame_images · object[]

The first frame or the last frame reference picture; at most one of the same type.

Maximum array length: 2

Hide child attributes

frame_images. type · enum<string> · required

Reference frame position.

Available options: first_frame, last_frame

frame_images. image_url · string<uri> · required

Reference image URL string.

Minimum string length: 1

input_references · object[]

Full-modal reference material: up to 9 images, 3 videos, and 3 audios. Reference mode and first/last frame mode are mutually exclusive.

Maximum array length: 15

Option 1

Option 2

Option 3

Hide child attributes

input_references. image_url · string<uri> · required

Image URL string.

Minimum string length: 1

input_references. type · enum<string>

Optional. Material type; if provided, must be consistent with the corresponding URL field.

Available options: image_url, video_url, audio_url

input_references. role · enum<string>

Material usage. When omitted, normal reference material is inferred from the URL field.

Available options: reference_image, reference_video, reference_audio

input_references. video_url · string<uri>

Video URL string.

Minimum string length: 1

input_references. audio_url · string<uri>

Audio URL string.

Minimum string length: 1

input_references. reference_voice · string

Preset patch ID; only used by some models that support patch references.

Minimum string length: 1

callback_url · string<uri>

User task callback address. Called by Tikway after the task status changes, it is not directly passed to the model upstream.

Pattern: ^https://

extra_body · object

MiniMax H3 extended parameters.

Hide child attributes

extra_body. watermark · boolean

Whether to add watermark.

Response

202 - application/json

POST /v1/videos Response parameters after the video task is successfully created. The interface returns HTTP 202.

id · string · required

The unique identifier of the video generation task, used for subsequent query of task status.

Minimum string length: 1

Example:

"9552de3d-171f-4cca-b492-7baa56523239"

status · enum<string> · required

Task creation status. pending means that the task has been created and is waiting for submission; queue means that the task has entered the generation queue.

Available options: pending, queue

Example:

"queue"

polling_url · string<uri> · required

Video task query address, the client can poll the task status through GET request.

Pattern: ^https://

Example:

"https://api.example.com/v1/videos/9552de3d-171f-4cca-b492-7baa56523239"