> ## 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. # videoGenerate (API) > Use this endpoint to call the provider-compatible videogenerate (api) operation through MaxAPI. ## OpenAPI ````yaml /en/api-reference/openapi.json post /hailuo/v1/video_generation openapi: 3.0.1 info: title: MaxAPI Model API description: >- APIs for text, image, video, audio, and music models available through MaxAPI. version: 1.0.0 servers: - url: https://api.maxapi.ai description: MaxAPI production 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: - MaxAPI endpoints summary: videoGenerate (API) description: >- Use this endpoint to call the provider-compatible videogenerate (api) operation through MaxAPI. 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: Request succeeded. content: application/json: schema: $ref: '#/components/schemas/VideoGenerationResponse' example: task_id: task_1234567890abcdef base_resp: status_code: 0 status_msg: success headers: {} '400': description: Request failed. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: base_resp: status_code: 1001 status_msg: 'Invalid parameter: prompt is required' headers: {} '401': description: Request failed. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: base_resp: status_code: 1002 status_msg: Invalid API key headers: {} '500': description: Request failed. 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 properties: model: type: string 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 maxLength: 2000 example: 一只可爱的小猫在阳光下玩耍[推进],然后跳跃[跟随] first_frame_image: type: string example: https://example.com/image.jpg last_frame_image: type: string example: https://example.com/last.jpg subject_image: type: string example: https://example.com/subject.jpg duration: type: integer enum: - 6 - 10 default: 6 example: 6 resolution: type: string enum: - 720P - 768P - 1080P example: 1080P prompt_optimizer: type: boolean default: true example: true fast_pretreatment: type: boolean default: false example: false callback_url: type: string format: uri example: https://your-domain.com/callback aigc_watermark: type: boolean default: false example: false VideoGenerationResponse: type: object properties: task_id: type: string 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 example: 0 status_msg: type: string example: success securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: API Key ````