Model Invocation Examples
This page lists complete invocation information for the multimodal queue API by model ID. All models use /v1/queue/{endpoint}. The request body is the model parameter object itself and does not need an input wrapper.
Request steps
Section titled “Request steps”Every model uses the same invocation steps. Only replace ENDPOINT and the request-body fields.
export BASE_URL="https://cloud.seaart.ai/model"export API_KEY="YOUR_API_KEY"export ENDPOINT="nano_banana_2"
COMMON_HEADERS=( -H "Authorization: Key ${API_KEY}" -H "Content-Type: application/json")
SUBMIT_RESPONSE="$(curl -sS -X POST "${BASE_URL}/v1/queue/${ENDPOINT}" \ "${COMMON_HEADERS[@]}" \ -d '{ "prompt": "a cinematic photo of a cat astronaut" }')"
REQUEST_ID="$(echo "${SUBMIT_RESPONSE}" | jq -r '.request_id')"STATUS_URL="$(echo "${SUBMIT_RESPONSE}" | jq -r '.status_url')"RESPONSE_URL="$(echo "${SUBMIT_RESPONSE}" | jq -r '.response_url')"
while true; do STATUS_RESPONSE="$(curl -sS "${STATUS_URL}" "${COMMON_HEADERS[@]}")" STATUS="$(echo "${STATUS_RESPONSE}" | jq -r '.status')" ERROR="$(echo "${STATUS_RESPONSE}" | jq -r '.error // empty')"
if [ "${STATUS}" = "COMPLETED" ]; then if [ -n "${ERROR}" ]; then echo "task failed: ${ERROR}" exit 1 fi break fi
sleep 3done
curl -sS "${RESPONSE_URL}" "${COMMON_HEADERS[@]}" | jq .Unified response structure
Section titled “Unified response structure”After a task succeeds, the result endpoint always returns request_id, outputs, and metadata. Multiple result URLs are returned as multiple outputs records in order.
{ "request_id": "mmsu_01hxyz...", "outputs": [ { "type": "image", "url": "https://example.com/output.png", "content_type": "image/png", "file_name": "output.png", "width": 1024, "height": 1024 } ], "metadata": { "prompt": "a cinematic photo of a cat astronaut" }}Supported models
Image, 22 total
wan25_i2i_previewwan25_i2i_preview_intlwan26_image_intlwan27_imagewan27_image_promidjourney_diffusionwan26_i2iqwen_image_edit_plusgpt_image_2gpt_image_2_editgpt_image_1_editgpt_image_1_5gpt_image_1_5_editgpt_image_1flux_pro_11flux_kontext_proflux_kontext_maxflux_2_maxflux_2_pronano_banana_2nano_banana_pronano_banana
Video, 13 total
happyhorse_1.0_i2vminimax_hailuo_23_i2vminimax_hailuo_02_i2vminimax_hailuo_23_fast_i2vtencent_mps_super_resolutionpixverse_v6_i2vminimax_i2v_01_directorminimax_i2v_01_liveminimax_i2v_01wan22_i2v_flashwan22_i2v_pluswan25_t2v_previewwan26_i2v
Audio, 10 total
minimax_speech_28_hdminimax_speech_28_turbominimax_speech_26_hdminimax_speech_26_turbominimax_speech_02_hdminimax_speech_02_turbominimax_speech_01_hdminimax_speech_01_turbomureka_lyrics_generatormureka_song_generator
3D, 3 total
tencent_hunyuan_3dtencent_hunyuan_3d_protencent_hunyuan_3d_rapid
Model parameter matrix
The table below lists request paths, full parameter lists, copyable request-body examples, and successful response structures by model ID. Fields marked required must be provided; undeclared fields are rejected.
| Model ID | Request path | Request-body parameters | Request-body example | Success response shape |
|---|---|---|---|---|
wan25_i2i_preview Image | | prompt string, required images string[], required negative_prompt string, optional n int, optional watermark bool, optional seed int, optional | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
wan25_i2i_preview_intl Image | | prompt string, required images string[], required negative_prompt string, optional n int, optional watermark bool, optional seed int, optional | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
wan26_image_intl Image | | role string, optional
, default user prompt string, required image string, optional image_url string, optional image_2 string, optional image_3 string, optional image_4 string, optional enable_interleave bool, optional
, default true negative_prompt string, optional size string, optional n int, optional prompt_extend bool, optional watermark bool, optional seed int, optional | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
wan27_image Image | | role string, optional
, default user prompt string, required negative_prompt string, optional size string, optional n int, optional prompt_extend bool, optional watermark bool, optional seed int, optional | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
wan27_image_pro Image | | role string, optional
, default user prompt string, required negative_prompt string, optional size string, optional n int, optional prompt_extend bool, optional watermark bool, optional seed int, optional | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
midjourney_diffusion Image | | text string, required | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
wan26_i2i Image | | prompt string, required images string[], required negative_prompt string, optional size string, optional enable_interleave bool, optional n int, optional max_images int, optional prompt_extend bool, optional watermark bool, optional seed int, optional | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
qwen_image_edit_plus Image | | prompt string, required images string[], required negative_prompt string, optional size string, optional enable_interleave bool, optional n int, optional max_images int, optional prompt_extend bool, optional watermark bool, optional seed int, optional | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
gpt_image_2 Image | | prompt string, required n int, optional size string, optional quality string, optional background string, optional output_format string, optional output_compression int, optional moderation string, optional user string, optional | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
gpt_image_2_edit Image | | prompt string, required image any, required mask any, optional n int, optional size string, optional quality string, optional background string, optional output_format string, optional output_compression int, optional response_format string, optional user string, optional watermark bool, optional | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
gpt_image_1_edit Image | | prompt string, required image any, required mask any, optional n int, optional size string, optional quality string, optional background string, optional output_format string, optional output_compression int, optional response_format string, optional user string, optional | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
gpt_image_1_5 Image | | prompt string, required n int, optional size string, optional quality string, optional output_format string, optional output_compression int, optional user string, optional | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
gpt_image_1_5_edit Image | | prompt string, required image any, required mask any, optional background string, optional input_fidelity string, optional n int, optional output_compression int, optional output_format string, optional partial_images int, optional quality string, optional size string, optional stream bool, optional user string, optional | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
gpt_image_1 Image | | prompt string, required n int, optional size string, optional quality string, optional background string, optional output_format string, optional output_compression int, optional moderation string, optional user string, optional | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
flux_pro_11 Image | | prompt string, required image_prompt string, optional width int, optional height int, optional prompt_upsampling bool, optional seed int, optional safety_tolerance int, optional output_format string, optional | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
flux_kontext_pro Image | | prompt string, required input_image string, optional input_image_2 string, optional input_image_3 string, optional input_image_4 string, optional seed int, optional aspect_ratio string, optional output_format string, optional prompt_upsampling bool, optional safety_tolerance any, optional | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
flux_kontext_max Image | | prompt string, required input_image string, optional input_image_2 string, optional input_image_3 string, optional input_image_4 string, optional image any, optional seed int, optional aspect_ratio string, optional steps int, optional guidance_scale number, optional negative_prompt string, optional output_format string, optional prompt_upsampling bool, optional safety_tolerance int, optional n int, optional quality string, optional size string, optional | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
flux_2_max Image | | prompt string, required image_urls string[], optional seed int, optional width int, optional height int, optional safety_tolerance int, optional output_format string, optional | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
flux_2_pro Image | | prompt string, required input_image string, optional image_urls string[], optional seed int, optional width int, optional height int, optional safety_tolerance int, optional output_format string, optional guidance_scale number, optional num_inference_steps int, optional | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
nano_banana_2 Image | | prompt string, required image_urls string[], optional aspect_ratio string, optional image_size string, optional resolution string, optional response_modalities string[], optional watermark bool, optional reference_image_urls string[], optional reference_items array, optional quality string, optional n int, optional | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
nano_banana_pro Image | | prompt string, required image_urls string[], optional aspect_ratio string, optional image_size string, optional resolution string, optional response_modalities string[], optional watermark bool, optional moderation bool, optional quality string, optional n int, optional | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
nano_banana Image | | prompt string, required image_urls string[], optional aspect_ratio string, optional image_size string, optional resolution string, optional response_modalities string[], optional watermark bool, optional moderation bool, optional n int, optional | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
happyhorse_1.0_i2v Video | | prompt string, required media any, required duration int, optional resolution string, optional prompt_extend bool, optional seed int, optional watermark bool, optional | | {request_id, outputs:[{type:"video", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
minimax_hailuo_23_i2v Video | | first_frame_image string, required prompt string, optional duration int, optional resolution string, optional prompt_optimizer bool, optional fast_pretreatment bool, optional | | {request_id, outputs:[{type:"video", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
minimax_hailuo_02_i2v Video | | first_frame_image string, required prompt string, optional duration int, optional resolution string, optional prompt_optimizer bool, optional fast_pretreatment bool, optional | | {request_id, outputs:[{type:"video", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
minimax_hailuo_23_fast_i2v Video | | first_frame_image string, required prompt string, optional duration int, optional resolution string, optional prompt_optimizer bool, optional fast_pretreatment bool, optional | | {request_id, outputs:[{type:"video", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
tencent_mps_super_resolution Video | | input_url string, required input_type string, optional
, default URL output_bucket string, optional
, default top-rank-cos-1350346443 output_region string, optional
, default na-siliconvalley output_storage_type string, optional
, default COS output_dir string, optional
, default /super_resolution definition any, optional
, default 1560242 short int, optional session_id string, optional session_context string, optional task_notify_config object, optional task_priority int, optional | | {request_id, outputs:[{type:"video", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
pixverse_v6_i2v Video | | image string, required img_id string, optional prompt string, optional negative_prompt string, optional duration number, optional quality string, optional seed int, optional style string, optional template_id int, optional sound_effect_switch bool, optional sound_effect_content string, optional lip_sync_switch bool, optional lip_sync_tts_content string, optional lip_sync_tts_speaker_id string, optional generate_audio_switch bool, optional generate_multi_clip_switch bool, optional thinking_type string, optional | | {request_id, outputs:[{type:"video", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
minimax_i2v_01_director Video | | first_frame_image string, required prompt string, optional prompt_optimizer bool, optional | | {request_id, outputs:[{type:"video", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
minimax_i2v_01_live Video | | first_frame_image string, required prompt string, optional duration int, optional resolution string, optional prompt_optimizer bool, optional | | {request_id, outputs:[{type:"video", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
minimax_i2v_01 Video | | first_frame_image string, required prompt string, optional duration int, optional resolution string, optional prompt_optimizer bool, optional | | {request_id, outputs:[{type:"video", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
wan22_i2v_flash Video | | prompt string, required img_url string, required duration int, optional resolution string, optional prompt_extend bool, optional seed int, optional watermark bool, optional | | {request_id, outputs:[{type:"video", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
wan22_i2v_plus Video | | prompt string, required img_url string, required duration int, optional resolution string, optional prompt_extend bool, optional seed int, optional watermark bool, optional | | {request_id, outputs:[{type:"video", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
wan25_t2v_preview Video | | prompt string, required duration int, optional resolution string, optional prompt_extend bool, optional seed int, optional watermark bool, optional | | {request_id, outputs:[{type:"video", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
wan26_i2v Video | | prompt string, required img_url string, required duration int, optional resolution string, optional prompt_extend bool, optional seed int, optional watermark bool, optional | | {request_id, outputs:[{type:"video", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
minimax_speech_28_hd Audio | | text string, required stream bool, optional output_format string, optional voice_setting object, optional audio_setting object, optional language_boost string, optional pronunciation_dict object, optional voice_modify object, optional subtitle_enable bool, optional stream_options object, optional aigc_watermark bool, optional | | {request_id, outputs:[{type:"audio", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
minimax_speech_28_turbo Audio | | text string, required stream bool, optional output_format string, optional voice_setting object, optional audio_setting object, optional language_boost string, optional pronunciation_dict object, optional voice_modify object, optional subtitle_enable bool, optional stream_options object, optional aigc_watermark bool, optional | | {request_id, outputs:[{type:"audio", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
minimax_speech_26_hd Audio | | text string, required stream bool, optional output_format string, optional voice_setting object, optional audio_setting object, optional language_boost string, optional pronunciation_dict object, optional voice_modify object, optional subtitle_enable bool, optional stream_options object, optional aigc_watermark bool, optional | | {request_id, outputs:[{type:"audio", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
minimax_speech_26_turbo Audio | | text string, required stream bool, optional output_format string, optional voice_setting object, optional audio_setting object, optional language_boost string, optional pronunciation_dict object, optional voice_modify object, optional subtitle_enable bool, optional stream_options object, optional aigc_watermark bool, optional | | {request_id, outputs:[{type:"audio", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
minimax_speech_02_hd Audio | | text string, required stream bool, optional output_format string, optional voice_setting object, optional audio_setting object, optional language_boost string, optional pronunciation_dict object, optional voice_modify object, optional subtitle_enable bool, optional stream_options object, optional aigc_watermark bool, optional | | {request_id, outputs:[{type:"audio", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
minimax_speech_02_turbo Audio | | text string, required stream bool, optional output_format string, optional voice_setting object, optional audio_setting object, optional language_boost string, optional pronunciation_dict object, optional voice_modify object, optional subtitle_enable bool, optional stream_options object, optional aigc_watermark bool, optional | | {request_id, outputs:[{type:"audio", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
minimax_speech_01_hd Audio | | text string, required stream bool, optional output_format string, optional voice_setting object, optional audio_setting object, optional language_boost string, optional pronunciation_dict object, optional voice_modify object, optional subtitle_enable bool, optional stream_options object, optional aigc_watermark bool, optional | | {request_id, outputs:[{type:"audio", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
minimax_speech_01_turbo Audio | | text string, required stream bool, optional output_format string, optional voice_setting object, optional audio_setting object, optional language_boost string, optional pronunciation_dict object, optional voice_modify object, optional subtitle_enable bool, optional stream_options object, optional aigc_watermark bool, optional | | {request_id, outputs:[{type:"audio", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
mureka_lyrics_generator Audio | | prompt string, required | | {request_id, outputs:[{type:"text", text}], metadata} |
mureka_song_generator Audio | | lyrics string, required n int, optional prompt string, optional reference_id string, optional vocal_id string, optional melody_id string, optional stream bool, optional | | {request_id, outputs:[{type:"audio", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
tencent_hunyuan_3d 3D | | prompt string, optional image_base64 string, optional image_url string, optional result_format string, optional enable_pbr bool, optional multi_view_images array, optional | | {request_id, outputs:[{type:"model3d", url, content_type, file_name, file_size, metadata?}], metadata} |
tencent_hunyuan_3d_pro 3D | | prompt string, optional image_base64 string, optional image_url string, optional face_count int, optional generate_type string, optional polygon_type string, optional enable_pbr bool, optional multi_view_images array, optional | | {request_id, outputs:[{type:"model3d", url, content_type, file_name, file_size, metadata?}], metadata} |
tencent_hunyuan_3d_rapid 3D | | prompt string, optional image_base64 string, optional image_url string, optional result_format string, optional enable_pbr bool, optional multi_view_images array, optional | | {request_id, outputs:[{type:"model3d", url, content_type, file_name, file_size, metadata?}], metadata} |