模型调用示例
本页按模型 ID 列出多模态 queue 接口的完整调用信息。所有模型都使用 /v1/queue/{endpoint},请求体是模型参数根对象,不需要 input 包装。
每个模型的调用步骤完全一致,只需要替换 ENDPOINT 和请求体字段。
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 .统一响应结构
Section titled “统一响应结构”任务成功后,结果接口固定返回 request_id、outputs 和 metadata。多个结果 URL 会按顺序返回多条 outputs 记录。
{ "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" }}支持模型
Image,共 22 个
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 个
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 个
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 个
tencent_hunyuan_3dtencent_hunyuan_3d_protencent_hunyuan_3d_rapid
模型参数矩阵
下表按模型 ID 维度列出请求链路、完整参数清单、可复制请求体示例和成功响应结构。带“必填”的字段必须传;未声明字段会被拒绝。
| 模型 ID | 请求链路 | 请求体参数 | 请求体示例 | 成功响应结构 |
|---|---|---|---|---|
wan25_i2i_preview Image | | prompt string, 必填 images string[], 必填 negative_prompt string, 可选 n int, 可选 watermark bool, 可选 seed int, 可选 | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
wan25_i2i_preview_intl Image | | prompt string, 必填 images string[], 必填 negative_prompt string, 可选 n int, 可选 watermark bool, 可选 seed int, 可选 | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
wan26_image_intl Image | | role string, 可选
, 默认 user prompt string, 必填 image string, 可选 image_url string, 可选 image_2 string, 可选 image_3 string, 可选 image_4 string, 可选 enable_interleave bool, 可选
, 默认 true negative_prompt string, 可选 size string, 可选 n int, 可选 prompt_extend bool, 可选 watermark bool, 可选 seed int, 可选 | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
wan27_image Image | | role string, 可选
, 默认 user prompt string, 必填 negative_prompt string, 可选 size string, 可选 n int, 可选 prompt_extend bool, 可选 watermark bool, 可选 seed int, 可选 | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
wan27_image_pro Image | | role string, 可选
, 默认 user prompt string, 必填 negative_prompt string, 可选 size string, 可选 n int, 可选 prompt_extend bool, 可选 watermark bool, 可选 seed int, 可选 | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
midjourney_diffusion Image | | text string, 必填 | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
wan26_i2i Image | | prompt string, 必填 images string[], 必填 negative_prompt string, 可选 size string, 可选 enable_interleave bool, 可选 n int, 可选 max_images int, 可选 prompt_extend bool, 可选 watermark bool, 可选 seed int, 可选 | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
qwen_image_edit_plus Image | | prompt string, 必填 images string[], 必填 negative_prompt string, 可选 size string, 可选 enable_interleave bool, 可选 n int, 可选 max_images int, 可选 prompt_extend bool, 可选 watermark bool, 可选 seed int, 可选 | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
gpt_image_2 Image | | prompt string, 必填 n int, 可选 size string, 可选 quality string, 可选 background string, 可选 output_format string, 可选 output_compression int, 可选 moderation string, 可选 user string, 可选 | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
gpt_image_2_edit Image | | prompt string, 必填 image any, 必填 mask any, 可选 n int, 可选 size string, 可选 quality string, 可选 background string, 可选 output_format string, 可选 output_compression int, 可选 response_format string, 可选 user string, 可选 watermark bool, 可选 | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
gpt_image_1_edit Image | | prompt string, 必填 image any, 必填 mask any, 可选 n int, 可选 size string, 可选 quality string, 可选 background string, 可选 output_format string, 可选 output_compression int, 可选 response_format string, 可选 user string, 可选 | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
gpt_image_1_5 Image | | prompt string, 必填 n int, 可选 size string, 可选 quality string, 可选 output_format string, 可选 output_compression int, 可选 user string, 可选 | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
gpt_image_1_5_edit Image | | prompt string, 必填 image any, 必填 mask any, 可选 background string, 可选 input_fidelity string, 可选 n int, 可选 output_compression int, 可选 output_format string, 可选 partial_images int, 可选 quality string, 可选 size string, 可选 stream bool, 可选 user string, 可选 | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
gpt_image_1 Image | | prompt string, 必填 n int, 可选 size string, 可选 quality string, 可选 background string, 可选 output_format string, 可选 output_compression int, 可选 moderation string, 可选 user string, 可选 | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
flux_pro_11 Image | | prompt string, 必填 image_prompt string, 可选 width int, 可选 height int, 可选 prompt_upsampling bool, 可选 seed int, 可选 safety_tolerance int, 可选 output_format string, 可选 | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
flux_kontext_pro Image | | prompt string, 必填 input_image string, 可选 input_image_2 string, 可选 input_image_3 string, 可选 input_image_4 string, 可选 seed int, 可选 aspect_ratio string, 可选 output_format string, 可选 prompt_upsampling bool, 可选 safety_tolerance any, 可选 | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
flux_kontext_max Image | | prompt string, 必填 input_image string, 可选 input_image_2 string, 可选 input_image_3 string, 可选 input_image_4 string, 可选 image any, 可选 seed int, 可选 aspect_ratio string, 可选 steps int, 可选 guidance_scale number, 可选 negative_prompt string, 可选 output_format string, 可选 prompt_upsampling bool, 可选 safety_tolerance int, 可选 n int, 可选 quality string, 可选 size string, 可选 | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
flux_2_max Image | | prompt string, 必填 image_urls string[], 可选 seed int, 可选 width int, 可选 height int, 可选 safety_tolerance int, 可选 output_format string, 可选 | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
flux_2_pro Image | | prompt string, 必填 input_image string, 可选 image_urls string[], 可选 seed int, 可选 width int, 可选 height int, 可选 safety_tolerance int, 可选 output_format string, 可选 guidance_scale number, 可选 num_inference_steps int, 可选 | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
nano_banana_2 Image | | prompt string, 必填 image_urls string[], 可选 aspect_ratio string, 可选 image_size string, 可选 resolution string, 可选 response_modalities string[], 可选 watermark bool, 可选 reference_image_urls string[], 可选 reference_items array, 可选 quality string, 可选 n int, 可选 | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
nano_banana_pro Image | | prompt string, 必填 image_urls string[], 可选 aspect_ratio string, 可选 image_size string, 可选 resolution string, 可选 response_modalities string[], 可选 watermark bool, 可选 moderation bool, 可选 quality string, 可选 n int, 可选 | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
nano_banana Image | | prompt string, 必填 image_urls string[], 可选 aspect_ratio string, 可选 image_size string, 可选 resolution string, 可选 response_modalities string[], 可选 watermark bool, 可选 moderation bool, 可选 n int, 可选 | | {request_id, outputs:[{type:"image", url, content_type, file_name, width, height, metadata?}], metadata} |
happyhorse_1.0_i2v Video | | prompt string, 必填 media any, 必填 duration int, 可选 resolution string, 可选 prompt_extend bool, 可选 seed int, 可选 watermark bool, 可选 | | {request_id, outputs:[{type:"video", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
minimax_hailuo_23_i2v Video | | first_frame_image string, 必填 prompt string, 可选 duration int, 可选 resolution string, 可选 prompt_optimizer bool, 可选 fast_pretreatment bool, 可选 | | {request_id, outputs:[{type:"video", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
minimax_hailuo_02_i2v Video | | first_frame_image string, 必填 prompt string, 可选 duration int, 可选 resolution string, 可选 prompt_optimizer bool, 可选 fast_pretreatment bool, 可选 | | {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, 必填 prompt string, 可选 duration int, 可选 resolution string, 可选 prompt_optimizer bool, 可选 fast_pretreatment bool, 可选 | | {request_id, outputs:[{type:"video", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
tencent_mps_super_resolution Video | | input_url string, 必填 input_type string, 可选
, 默认 URL output_bucket string, 可选
, 默认 top-rank-cos-1350346443 output_region string, 可选
, 默认 na-siliconvalley output_storage_type string, 可选
, 默认 COS output_dir string, 可选
, 默认 /super_resolution definition any, 可选
, 默认 1560242 short int, 可选 session_id string, 可选 session_context string, 可选 task_notify_config object, 可选 task_priority int, 可选 | | {request_id, outputs:[{type:"video", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
pixverse_v6_i2v Video | | image string, 必填 img_id string, 可选 prompt string, 可选 negative_prompt string, 可选 duration number, 可选 quality string, 可选 seed int, 可选 style string, 可选 template_id int, 可选 sound_effect_switch bool, 可选 sound_effect_content string, 可选 lip_sync_switch bool, 可选 lip_sync_tts_content string, 可选 lip_sync_tts_speaker_id string, 可选 generate_audio_switch bool, 可选 generate_multi_clip_switch bool, 可选 thinking_type string, 可选 | | {request_id, outputs:[{type:"video", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
minimax_i2v_01_director Video | | first_frame_image string, 必填 prompt string, 可选 prompt_optimizer bool, 可选 | | {request_id, outputs:[{type:"video", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
minimax_i2v_01_live Video | | first_frame_image string, 必填 prompt string, 可选 duration int, 可选 resolution string, 可选 prompt_optimizer bool, 可选 | | {request_id, outputs:[{type:"video", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
minimax_i2v_01 Video | | first_frame_image string, 必填 prompt string, 可选 duration int, 可选 resolution string, 可选 prompt_optimizer bool, 可选 | | {request_id, outputs:[{type:"video", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
wan22_i2v_flash Video | | prompt string, 必填 img_url string, 必填 duration int, 可选 resolution string, 可选 prompt_extend bool, 可选 seed int, 可选 watermark bool, 可选 | | {request_id, outputs:[{type:"video", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
wan22_i2v_plus Video | | prompt string, 必填 img_url string, 必填 duration int, 可选 resolution string, 可选 prompt_extend bool, 可选 seed int, 可选 watermark bool, 可选 | | {request_id, outputs:[{type:"video", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
wan25_t2v_preview Video | | prompt string, 必填 duration int, 可选 resolution string, 可选 prompt_extend bool, 可选 seed int, 可选 watermark bool, 可选 | | {request_id, outputs:[{type:"video", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
wan26_i2v Video | | prompt string, 必填 img_url string, 必填 duration int, 可选 resolution string, 可选 prompt_extend bool, 可选 seed int, 可选 watermark bool, 可选 | | {request_id, outputs:[{type:"video", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
minimax_speech_28_hd Audio | | text string, 必填 stream bool, 可选 output_format string, 可选 voice_setting object, 可选 audio_setting object, 可选 language_boost string, 可选 pronunciation_dict object, 可选 voice_modify object, 可选 subtitle_enable bool, 可选 stream_options object, 可选 aigc_watermark bool, 可选 | | {request_id, outputs:[{type:"audio", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
minimax_speech_28_turbo Audio | | text string, 必填 stream bool, 可选 output_format string, 可选 voice_setting object, 可选 audio_setting object, 可选 language_boost string, 可选 pronunciation_dict object, 可选 voice_modify object, 可选 subtitle_enable bool, 可选 stream_options object, 可选 aigc_watermark bool, 可选 | | {request_id, outputs:[{type:"audio", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
minimax_speech_26_hd Audio | | text string, 必填 stream bool, 可选 output_format string, 可选 voice_setting object, 可选 audio_setting object, 可选 language_boost string, 可选 pronunciation_dict object, 可选 voice_modify object, 可选 subtitle_enable bool, 可选 stream_options object, 可选 aigc_watermark bool, 可选 | | {request_id, outputs:[{type:"audio", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
minimax_speech_26_turbo Audio | | text string, 必填 stream bool, 可选 output_format string, 可选 voice_setting object, 可选 audio_setting object, 可选 language_boost string, 可选 pronunciation_dict object, 可选 voice_modify object, 可选 subtitle_enable bool, 可选 stream_options object, 可选 aigc_watermark bool, 可选 | | {request_id, outputs:[{type:"audio", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
minimax_speech_02_hd Audio | | text string, 必填 stream bool, 可选 output_format string, 可选 voice_setting object, 可选 audio_setting object, 可选 language_boost string, 可选 pronunciation_dict object, 可选 voice_modify object, 可选 subtitle_enable bool, 可选 stream_options object, 可选 aigc_watermark bool, 可选 | | {request_id, outputs:[{type:"audio", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
minimax_speech_02_turbo Audio | | text string, 必填 stream bool, 可选 output_format string, 可选 voice_setting object, 可选 audio_setting object, 可选 language_boost string, 可选 pronunciation_dict object, 可选 voice_modify object, 可选 subtitle_enable bool, 可选 stream_options object, 可选 aigc_watermark bool, 可选 | | {request_id, outputs:[{type:"audio", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
minimax_speech_01_hd Audio | | text string, 必填 stream bool, 可选 output_format string, 可选 voice_setting object, 可选 audio_setting object, 可选 language_boost string, 可选 pronunciation_dict object, 可选 voice_modify object, 可选 subtitle_enable bool, 可选 stream_options object, 可选 aigc_watermark bool, 可选 | | {request_id, outputs:[{type:"audio", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
minimax_speech_01_turbo Audio | | text string, 必填 stream bool, 可选 output_format string, 可选 voice_setting object, 可选 audio_setting object, 可选 language_boost string, 可选 pronunciation_dict object, 可选 voice_modify object, 可选 subtitle_enable bool, 可选 stream_options object, 可选 aigc_watermark bool, 可选 | | {request_id, outputs:[{type:"audio", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
mureka_lyrics_generator Audio | | prompt string, 必填 | | {request_id, outputs:[{type:"text", text}], metadata} |
mureka_song_generator Audio | | lyrics string, 必填 n int, 可选 prompt string, 可选 reference_id string, 可选 vocal_id string, 可选 melody_id string, 可选 stream bool, 可选 | | {request_id, outputs:[{type:"audio", url, content_type, file_name, file_size, duration, metadata?}], metadata} |
tencent_hunyuan_3d 3D | | prompt string, 可选 image_base64 string, 可选 image_url string, 可选 result_format string, 可选 enable_pbr bool, 可选 multi_view_images array, 可选 | | {request_id, outputs:[{type:"model3d", url, content_type, file_name, file_size, metadata?}], metadata} |
tencent_hunyuan_3d_pro 3D | | prompt string, 可选 image_base64 string, 可选 image_url string, 可选 face_count int, 可选 generate_type string, 可选 polygon_type string, 可选 enable_pbr bool, 可选 multi_view_images array, 可选 | | {request_id, outputs:[{type:"model3d", url, content_type, file_name, file_size, metadata?}], metadata} |
tencent_hunyuan_3d_rapid 3D | | prompt string, 可选 image_base64 string, 可选 image_url string, 可选 result_format string, 可选 enable_pbr bool, 可选 multi_view_images array, 可选 | | {request_id, outputs:[{type:"model3d", url, content_type, file_name, file_size, metadata?}], metadata} |