Submit a Hidream-Q Series Video Generation Task

1. Endpoint

/api/maas/gw/v1/videos/generations

 

2. Method

POST

 

3. Request Parameters

Header

Parameter Type Required Description
Authorization string Yes Bearer API key, for example sk-xxxxxxxx
Content-Type string Yes application/json

Body (by model)

model_id is required and must match the corresponding model.

Video-6bj3i4u2 hidream-Q3-pro-Video
Parameter Type Required Description
model_id string Yes Fixed value: Video-6bj3i4u2
prompt string No Text prompt. Recommended length: no more than 2500 characters
aspect_ratio string No Aspect ratio. Options: 16:9/9:16/1:1. Default: 16:9
duration int No Video duration in seconds. Range: 3~15. Default: 5
element_list array No Subject reference list. For the element structure, see ElementSchema
image_list array No Reference image list. For the element structure, see ImageListSchema; can be used for image-to-video, first/last frame, or reference image scenarios
multi_prompt array No Multi-shot descriptions. For the element structure, see MultiPromptSchema; up to 6 segments are recommended
multi_shot bool No Whether to use multi-shot generation. Values: true/false. Default: false
shot_type string No Shot-splitting method. Currently customize is recommended
video_list array No Reference video list. For the element structure, see VideoSchema
mode string No Mode. Options: std/pro. Default: pro
sound string No Whether to enable sound. Options: off/on. Default: off
notify_url string No Callback URL. Not yet available
request_id string No Request ID

Constraints:

  • When video_list is not empty, duration must be <=10.
  • Combined size limits for image_list and element_list:
    • <=7 when video_list is not provided
    • <=4 when video_list is provided
Video-jkpfq9r0 hidream-Q3-std-Video
Parameter Type Required Description
model_id string Yes Fixed value: Video-jkpfq9r0
prompt string No Positive text prompt, up to 2500 characters
negative_prompt string No Negative text prompt, up to 2500 characters
aspect_ratio string No Aspect ratio. Options: 16:9/9:16/1:1. Default: 16:9
duration int No Video duration in seconds. Range: 3~15. Default: 5
image string No Reference image URL. When provided, the request enters image-to-video mode. Image size must not exceed 10MB, minimum width and height 300px, and aspect ratio must be between 1:2.5 and 2.5:1
image_tail string No Last-frame reference image URL. When used with image, it can generate a video with specified first and last frames
multi_prompt array No Multi-shot descriptions. For the element structure, see MultiPromptSchema; up to 6 segments are recommended
multi_shot bool No Whether to generate a multi-shot video. Values: true/false. Default: false. When set to true, the prompt parameter is ignored and first/last frames cannot be set
shot_type string No Shot-splitting method. Options: customize/intelligence. Default: customize
mode string No Mode. Options: std/pro. Default: pro
sound string No Whether to enable sound. Options: off/on. Default: off
notify_url string No Callback URL. Not yet available
request_id string No Request ID

Constraints:

  • image_tail is not supported when mode=std.
Video-7flw327g hidream-Q2.6-Video
Parameter Type Required Description
model_id string Yes Fixed value: Video-7flw327g
prompt string No Positive text prompt, up to 2500 characters
negative_prompt string No Negative text prompt, up to 2500 characters
aspect_ratio string No Aspect ratio. Options: 16:9/9:16/1:1. Default: 16:9
duration int No Video duration. Options: 5/10. Default: 5
image string No Reference image URL. One image is typically required for image-to-video scenarios
image_tail string No Last-frame reference image URL. Recommended to use with image for first/last-frame video generation
sound string No Whether to enable sound: on/off. Default: off; this capability is supported only by kling-v2-6
mode string No Mode. Options: std/pro. Default: pro
notify_url string No Callback URL. Not yet available
request_id string No Request ID
Video-idegmbam hidream-Q2.5-pro-Video
Parameter Type Required Description
model_id string Yes Fixed value: Video-idegmbam
prompt string No Positive text prompt, up to 2500 characters
negative_prompt string No Negative text prompt, up to 2500 characters
aspect_ratio string No Aspect ratio. Options: 16:9/9:16/1:1. Default: 16:9
duration int No Video duration. Options: 5/10. Default: 5
image string No Reference image URL. One image is typically required for image-to-video scenarios
image_tail string No Last-frame reference image URL. When used with image, it can generate a video with specified first and last frames
sound string No Whether to enable sound: on/off. Default: off; if the gateway does not expose this capability, the actual response prevails
mode string No Mode. Options: std/pro. Default: pro
notify_url string No Callback URL. Not yet available
request_id string No Request ID
Video-3o4t26br hidream-Q1-video
Parameter Type Required Description
model_id string Yes Fixed value: Video-3o4t26br
prompt string Yes Text prompt (including positive and negative descriptions), up to 2500 characters
video_list array Yes Reference video list. For the element structure, see VideoSchema; used for scenarios with reference-video generation or editing
aspect_ratio string No Aspect ratio. Options: 16:9/9:16/1:1
duration int No Video duration. Default: 5. It is recommended to pass a value supported by the gateway
element_list array No Subject reference list. For the element structure, see ElementSchema
image_list array No Reference image list. For the element structure, see ImageListSchema; supports first/last-frame image control
mode string No Mode. Options: std/pro. Default: pro
notify_url string No Callback URL. Not yet available
request_id string No Request ID

Object Structure

MultiPromptSchema

Parameter Type Required Description
index int Yes Shot sequence number
prompt string Yes Shot description. Each segment must not exceed 512 characters
duration int Yes Shot duration as a positive integer. In multi-shot mode, the sum of all shot durations must equal the total duration

ImageListSchema

Parameter Type Required Description
image_url string No Image URL
type string No Image type. Use first_frame/end_frame to specify first and last frames. This field is not required for images that are neither first nor last frames. You cannot set only the last frame

ElementSchema

Parameter Type Required Description
element_id string Yes Subject element ID

VideoSchema

Parameter Type Required Description
video_url string Yes Reference video URL. Only MP4/MOV is supported; video duration must be at least 3s; width and height must be within 720px to 2160px; size must be < 200MB
refer_type string Yes Reference type: base indicates the video to be edited, and feature indicates a feature reference video
keep_original_sound string Yes Whether to keep the original audio: yes/no

Response

Parameter Type Required Description
code int Yes Response code. 0 means success; any non-zero value indicates an error. See message for details
message string Yes Response message
result dict Yes Returned result

result

Parameter Type Required Description
task_id str Yes Task ID

results matching ""

    No results matching ""

    results matching ""

      No results matching ""