进阶 docs.leonardo.ai 2026-11-22 15:11:20 · 0 阅读

第47章 MiniMax Hailuo 03 视频生成 API 接入指南

MiniMax Hailuo 03本文介绍如何通过 Leonardo.AI REST API 使用 MiniMax Hailuo 03 模型生成视频。请求示例 curl --request POST \ --url https://cloud.leonardo.ai/api/rest/v2/generations \ --header 'accept: application/json' \ --header 'authorization: Bearer ' \ --header 'content-type: application/json' \ --data ' { "model": "hailuo-03", "public": false, "parameters": { "prompt": "一只考拉和一只猫在阳光洒落的草地上玩耍", "quantity": 1, "width": 1376, "height": 768, "duration": 6, "quality": "TURBO", "motion_has_audio": true } } ' API 请求端点、请求头、参数 端点 https://cloud.leonardo.ai/api/rest/v2/generations 请求头 --header "accept: application/json" \ --header "authorization: Bearer " \ --header "content-type: application/json" 请求体参数

参数类型说明durationinteger可选。视频时长(秒)。可选值:5、6、7、8、9、10、11、12、13、14、15。默认为 6。guidancesobject可选。定义影响生成结果的引导输入(如起始/结束帧、参考图、参考视频、音频)。guidances.audio_referencearray可选。用作生成参考的音频片段,最多 3 个。每项包含 audio.id 和 audio.type(UPLOADED、GENERATED)。需要设置 guidances.image_reference 或 guidances.video_reference_base(起始帧或结束帧不算)。quality 为 TURBO 时不可用。guidances.end_framearray可选。基于参考图像对氛围或结构进行创意重绘,最多 1 项。每项包含 image.id 和 image.type(UPLOADED、GENERATED、VARIATION、URL、BASE64)。guidances.image_referencearray可选。用于引导视频生成的参考图像,最多 9 项。每项包含 image.id 和 image.type(UPLOADED、GENERATED、VARIATION、URL、BASE64),以及可选的 order。guidances.start_framearray可选。基于参考图像对氛围或结构进行创意重绘,最多 1 项。每项包含 image.id 和 image.type(UPLOADED、GENERATED、VARIATION、URL、BASE64)。guidances.video_reference_basearray可选。待编辑的基础视频,最多 3 项。每项包含 video.id、video.type(UPLOADED、GENERATED)和 video.duration。heightinteger可选。输出高度(像素)。可选值:480、640、768、856、1024、1376、1440、1920、2160、2560、2880、3840、0。默认为 768。有效的宽高组合请参见"尺寸说明"。modelstring必填。指定生成所用的模型。设为 hailuo-03。motion_has_audioboolean可选。MiniMax Hailuo 03 始终生成原生音频,无法关闭。默认为 true。promptstring必填。生成所用的提示词,最多 7000 个字符。publicboolean可选。控制生成结果是公开(true)还是私有(false)。qualitystring可选。生成速度档位。可选值:STANDARD、ACCELERATED、TURBO。默认为 TURBO。quantityinteger必填。生成数量。默认为 1,范围 1-1。resolutionstring可选。当 width 和 height 为 0(自动)时使用的输出分辨率。显式指定的宽高优先。可选值:480p、768p、2k、4k。默认为 768p。widthinteger可选。输出宽度(像素)。可选值:480、640、768、856、1024、1120、1376、1440、1792、1920、2160、2560、2880、3360、3840、5040、0。默认为 1376。有效的宽高组合请参见"尺寸说明"。 尺寸说明 API 支持以下 width 和 height 参数组合:

分辨率宽高比像素值(宽 x 高)480p21:9(横屏)1120 x 48016:9(横屏)856 x 4804:3(横屏)640 x 4801:1(方形)480 x 4803:4(竖屏)480 x 6409:16(竖屏)480 x 856768p21:9(横屏)1792 x 76816:9(横屏)1376 x 7684:3(横屏)1024 x 7681:1(方形)768 x 7683:4(竖屏)768 x 10249:16(竖屏)768 x 13762K21:9(横屏)3360 x 144016:9(横屏)2560 x 14404:3(横屏)1920 x 14401:1(方形)1440 x 14403:4(竖屏)1440 x 19209:16(竖屏)1440 x 25604K21:9(横屏)5040 x 216016:9(横屏)3840 x 21604:3(横屏)2880 x 21601:1(方形)2160 x 21603:4(竖屏)2160 x 28809:16(竖屏)2160 x 3840自动自动0 x 0 默认为 1376 x 768。将 width 和 height 都设为 0 即启用自动模式,此时输出分辨率由 resolution 参数决定。更新于约 2 个月前 本页对您有帮助吗?

评论 (0)