> ## Documentation Index > Fetch the complete documentation index at: https://docs.maxapi.ai/llms.txt > Use this file to discover all available pages before exploring further. # 视频生成 (统一接口) > 海螺视频生成统一接口,支持多种生成模式 **注意**: 所有视频生成功能(文生视频、图生视频、首尾帧、主体参考)都使用同一个接口,通过不同的参数组合来实现不同功能。 ## 支持的模型: ### 文生视频 (Text to Video) - MiniMax-Hailuo-02: 海螺02,支持512P/768P/1080P - MiniMax-Hailuo-2.3: 海螺2.3,支持768P/1080P - MiniMax-Hailuo-2.3-Fast: 海螺2.3快速版,支持768P/1080P - T2V-01-Director: 导演版,支持镜头控制 - T2V-01: 基础版 ### 图生视频 (Image to Video) - I2V-01-Director: 导演版 - I2V-01-live: 实况版 - I2V-01: 基础版 ### 首尾帧生视频 - 所有 Hailuo 系列模型 ### 主体参考生视频 - S2V-01: 主体参考生视频模型 ## OpenAPI ````yaml /api-reference/openapi.json post /hailuo/v1/video_generation openapi: 3.0.1 info: title: MaxAPI 模型 API description: MaxAPI 文本、图像、视频、音频和音乐模型接口。 version: 1.0.0 servers: - url: https://api.maxapi.ai description: MaxAPI 生产环境 security: [] tags: - name: 模型接口 - name: 模型接口/绘图模型 - name: 模型接口/绘图模型/OpenAI Dall-e 格式 - name: 模型接口/绘图模型/Flux系列 - name: 模型接口/绘图模型/Flux系列/OpenAI Dalle 格式 - name: 模型接口/绘图模型/Z-image - name: 模型接口/绘图模型/Banana生图异步格式(未来可能兼容其他模型) - name: 模型接口/聊天接口（Chat） - name: 模型接口/视频模型 - name: 模型接口/视频模型/谷歌veo - name: 模型接口/视频模型/谷歌veo/VertexAI-VEO官方格式 - name: 模型接口/视频模型/谷歌veo/VertexAI-VEO官方格式/视频生成 - name: 模型接口/视频模型/谷歌veo/VertexAI-VEO官方格式/任务查询 - name: 模型接口/视频模型/谷歌veo/AIStudio-VEO官方格式 - name: 模型接口/视频模型/谷歌veo/AIStudio-VEO官方格式/视频生成 - name: 模型接口/视频模型/谷歌veo/AIStudio-VEO官方格式/任务查询 - name: 模型接口/视频模型/谷歌veo/AIStudio-VEO官方格式/下载视频(只有aistudio有这个动作) - name: 模型接口/视频模型/谷歌veo/GCP异步任务接口 - name: 模型接口/视频模型/谷歌veo/官网逆向接口格式 - name: 模型接口/视频模型/谷歌veo/官网逆向接口格式/视频生成 - name: 模型接口/视频模型/谷歌veo/官网逆向接口格式/OpenAI官方视频格式(适配 newapi) - name: 模型接口/视频模型/Wan阿里万象(官方格式) - name: 模型接口/视频模型/豆包seedance(官方格式) - name: 模型接口/视频模型/Vidu官方格式 - name: 模型接口/视频模型/Vidu官方格式/视频生成 - name: 模型接口/视频模型/Vidu官方格式/图像生成 - name: 模型接口/视频模型/Vidu官方格式/音频生成 - name: 模型接口/视频模型/Vidu官方格式/其他功能 - name: 模型接口/视频模型/Vidu官方格式/任务管理 - name: 模型接口/视频模型/MiniMax-Hailuo官方格式 - name: 模型接口/视频模型/MiniMax-Hailuo官方格式/视频生成 - name: 模型接口/视频模型/MiniMax-Hailuo官方格式/任务管理 - name: 模型接口/视频模型/MiniMax-Hailuo-OpenAI-Sora兼容格式 - name: 模型接口/视频模型/MiniMax-Hailuo-OpenAI-Sora兼容格式/视频生成 - name: 模型接口/视频模型/Sora-2-官方格式 - name: 模型接口/视频模型/Sora-2-官方格式/创建角色接口 - name: 模型接口/视频模型/Sora-2026-01-07新格式 - name: 模型接口/自动补全接口（Completions） - name: 模型接口/图像接口（Images） - name: 模型接口/向量生成接口（Embeddings） - name: 模型接口/音频接口（Audio） - name: 模型接口/MJ图像(视频)接口 - name: 模型接口/MJ图像(视频)接口/InsightFace任务提交 - name: 模型接口/MJ图像(视频)接口/任务提交 - name: 模型接口/MJ图像(视频)接口/任务查询 - name: 模型接口/MJ图像(视频)接口/MJ视频相关 - name: 模型接口/Suno音乐接口 - name: 模型接口/Suno音乐接口/GoAmzAI格式 - name: 模型接口/Suno音乐接口/GoAmzAI格式/v3.5 - name: 模型接口/Suno音乐接口/GoAmzAI格式/v3.0 - name: 模型接口/Suno音乐接口/官网原生格式(v2) - name: 模型接口/Suno音乐接口/官网原生格式(v2)/所有接口 - name: 模型接口/Suno音乐接口/官网原生格式(v2)/场景1 生成自定义音乐(带歌词) - name: 模型接口/Suno音乐接口/官网原生格式(v2)/场景 2 通过提示词直接生成音乐(带歌词) - name: 模型接口/Suno音乐接口/官网原生格式(v2)/场景 4 通过提示词直接生成音乐(纯音乐) - name: 模型接口/Suno音乐接口/官网原生格式(v2)/场景3 生成自定义音乐(纯音乐) - name: 模型接口/Suno音乐接口/官网原生格式(v2)/场景 5 上传自定义音频并续写 - name: 模型接口/Suno音乐接口/生成歌词 - name: 模型接口/Suno音乐接口/NewAPI兼容格式 - name: 模型接口/Luma视频接口 - name: 模型接口/Luma视频接口/GoAmzAI格式 - name: 模型接口/Luma视频接口/GoAmzAI格式/付费版 - name: 模型接口/Luma视频接口/GoAmzAI格式/免费版 - name: 模型接口/Luma视频接口/官网原生格式(v2) - name: 模型接口/SD图像接口 - name: 模型接口/SD图像接口/SD3 - name: 模型接口/SD图像接口/SDXL - name: 模型接口/Fish Audio - name: 模型接口/统一视频接口 - name: 模型接口/统一视频接口/阿里Wan(万相视频 - name: 模型接口/统一视频接口/Sora2视频 - name: 模型接口/统一视频接口/Seedance(即梦视频 - name: 模型接口/统一视频接口/Google-Veo - name: 历史接口 - name: 历史接口/PPT类接入 - name: 历史接口/请求示例 - name: 历史接口/原始接口（参数需要定义后才能发送请求） - name: 佐糖API - name: MewXAI星月熊开放API - name: MewXAI星月熊开放API/开放API接口 - name: MewXAI星月熊开放API/示例 - name: Ideogram（绘画） - name: 可灵API - name: RunWay官方API - name: 视频生成 - name: 任务查询 - name: Wan官方格式 - name: 图像生成 - name: 音频生成 - name: 其他功能 - name: 任务管理 - name: InsightFace任务提交 - name: 任务提交 - name: Generate - name: SDXL & SD1.6 paths: /hailuo/v1/video_generation: post: tags: - 模型接口/视频模型/MiniMax-Hailuo官方格式/视频生成 - 视频生成 summary: 视频生成 (统一接口) description: |- 海螺视频生成统一接口,支持多种生成模式 **注意**: 所有视频生成功能(文生视频、图生视频、首尾帧、主体参考)都使用同一个接口,通过不同的参数组合来实现不同功能。 ## 支持的模型: ### 文生视频 (Text to Video) - MiniMax-Hailuo-02: 海螺02,支持512P/768P/1080P - MiniMax-Hailuo-2.3: 海螺2.3,支持768P/1080P - MiniMax-Hailuo-2.3-Fast: 海螺2.3快速版,支持768P/1080P - T2V-01-Director: 导演版,支持镜头控制 - T2V-01: 基础版 ### 图生视频 (Image to Video) - I2V-01-Director: 导演版 - I2V-01-live: 实况版 - I2V-01: 基础版 ### 首尾帧生视频 - 所有 Hailuo 系列模型 ### 主体参考生视频 - S2V-01: 主体参考生视频模型 operationId: videoGeneration parameters: - name: Authorization in: header description: '' required: true example: YOUR_API_KEY schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/VideoGenerationRequest' examples: textToVideo: value: model: MiniMax-Hailuo-2.3 prompt: 一只可爱的小猫在阳光下玩耍,画面温馨治愈 duration: 6 resolution: 1080P prompt_optimizer: true summary: 文生视频 (Text to Video) imageToVideo: value: model: I2V-01 first_frame_image: https://example.com/image.jpg prompt: 图片中的场景开始动起来,微风吹过 duration: 6 summary: 图生视频 (Image to Video) startEndToVideo: value: model: MiniMax-Hailuo-2.3 first_frame_image: https://example.com/first.jpg last_frame_image: https://example.com/last.jpg prompt: 从第一帧平滑过渡到最后一帧 duration: 6 summary: 首尾帧生视频 subjectReference: value: model: S2V-01 subject_image: https://example.com/subject.jpg prompt: 主体在森林中奔跑,阳光透过树叶洒下 duration: 6 summary: 主体参考生视频 required: true responses: '200': description: 任务创建成功 content: application/json: schema: $ref: '#/components/schemas/VideoGenerationResponse' example: task_id: task_1234567890abcdef base_resp: status_code: 0 status_msg: success headers: {} '400': description: 请求参数错误 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: base_resp: status_code: 1001 status_msg: 'Invalid parameter: prompt is required' headers: {} '401': description: 认证失败 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: base_resp: status_code: 1002 status_msg: Invalid API key headers: {} '500': description: 服务器内部错误 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: base_resp: status_code: 5000 status_msg: Internal server error headers: {} deprecated: false security: - BearerAuth: [] components: schemas: VideoGenerationRequest: type: object required: - model description: 视频生成请求参数。根据不同的模型和参数组合,可实现文生视频、图生视频、首尾帧生视频、主体参考生视频等功能。 properties: model: type: string description: >- 模型名称。不同模型支持不同的功能: - 文生视频: MiniMax-Hailuo-02, MiniMax-Hailuo-2.3, MiniMax-Hailuo-2.3-Fast, T2V-01-Director, T2V-01 - 图生视频: I2V-01-Director, I2V-01-live, I2V-01 - 首尾帧: 所有Hailuo系列 - 主体参考: S2V-01 enum: - MiniMax-Hailuo-02 - MiniMax-Hailuo-2.3 - MiniMax-Hailuo-2.3-Fast - T2V-01-Director - T2V-01 - I2V-01-Director - I2V-01-live - I2V-01 - S2V-01 example: MiniMax-Hailuo-2.3 prompt: type: string description: >- 视频的文本描述,最大2000字符。对于Hailuo-2.3、Hailuo-02和*-Director系列模型,支持使用[指令]语法进行运镜控制。 支持15种运镜指令: - 左右移: [左移], [右移] - 左右摇: [左摇], [右摇] - 推拉: [推进], [拉远] - 升降: [上升], [下降] - 上下摇: [上摇], [下摇] - 变焦: [变焦推近], [变焦拉远] - 其他: [晃动], [跟随], [固定] maxLength: 2000 example: 一只可爱的小猫在阳光下玩耍[推进],然后跳跃[跟随] first_frame_image: type: string description: 首帧图片URL或base64编码。用于图生视频或首尾帧生视频。 example: https://example.com/image.jpg last_frame_image: type: string description: 尾帧图片URL或base64编码。用于首尾帧生视频,需要同时提供first_frame_image。 example: https://example.com/last.jpg subject_image: type: string description: 主体参考图片URL或base64编码。用于主体参考生视频(S2V-01模型)。 example: https://example.com/subject.jpg duration: type: integer description: |- 视频时长(秒),默认值为6。可用值与模型和分辨率相关: - MiniMax-Hailuo-2.3: 768P支持6或10秒,1080P仅支持6秒 - MiniMax-Hailuo-02: 768P支持6或10秒,1080P仅支持6秒 - 其他模型: 仅支持6秒 enum: - 6 - 10 default: 6 example: 6 resolution: type: string description: |- 视频分辨率。可用值与模型相关: - MiniMax-Hailuo-2.3: 768P(默认), 1080P - MiniMax-Hailuo-02: 768P(默认), 1080P - 其他模型: 720P(默认) enum: - 720P - 768P - 1080P example: 1080P prompt_optimizer: type: boolean description: 是否自动优化prompt,默认为true。设为false可进行更精确的控制。 default: true example: true fast_pretreatment: type: boolean description: >- 是否缩短prompt_optimizer的优化耗时,默认为false。仅对MiniMax-Hailuo-2.3和MiniMax-Hailuo-02模型生效。 default: false example: false callback_url: type: string description: 接收任务状态更新通知的回调URL。配置后,MiniMax会在任务状态变更时推送通知。 format: uri example: https://your-domain.com/callback aigc_watermark: type: boolean description: 是否在生成的视频中添加水印,默认为false。 default: false example: false VideoGenerationResponse: type: object properties: task_id: type: string description: 任务ID example: task_1234567890abcdef base_resp: $ref: '#/components/schemas/BaseResponse' ErrorResponse: type: object properties: base_resp: type: object properties: status_code: type: integer example: 1001 status_msg: type: string example: Invalid parameter BaseResponse: type: object properties: status_code: type: integer description: 状态码,0表示成功 example: 0 status_msg: type: string description: 状态消息 example: success securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: API Key description: 使用 MiniMax API Key 进行认证 ````