用途：通过 MiniMax 第一方 Hailuo 视频 API 安全、可复现地生成视频，覆盖全球与中国大陆两个独立服务区域，默认先干跑（dry-run），经人工审批成本后再创建付费任务并留证。
服务区域：全球用 platform.minimax.io，API 主机 https://api.minimax.io，计费 USD；中国大陆用 platform.minimaxi.com，API 主机 https://api.minimaxi.com，计费 CNY。两区账号、密钥、计费与主机不可混用，401 可能是区域选错。应以按量付费 API Key 调用，Token Plan/订阅密钥配额与模型访问不同。消费级产品 hailuoai.video、Video Agent 模板 API、图像/语音/音乐/文本端点、网关与转售商均不属本流程。
模式与模型：创建使用 POST /v1/video_generation。文生视频需 prompt，模型 MiniMax-Hailuo-2.3、MiniMax-Hailuo-02（端点另列 T2V-01-Director、T2V-01）；图生视频需 first_frame_image，模型含 MiniMax-Hailuo-2.3、2.3-Fast、02（另列 I2V-01 系列，2.3-Fast 仅支持图生视频）；首尾帧需 first_frame_image 与 last_frame_image，仅 02，512P 不支持；主体参考需 subject_reference 数组，仅 S2V-01，其时长、分辨率与当前价格未提供。
价格（按量付费，2026-07-10 核对）：2.3-Fast 768P 6 秒 $0.19/¥1.35，10 秒 $0.32/¥2.25，1080P 6 秒 $0.33/¥2.31；2.3 或 02 768P 6 秒 $0.28/¥2.00，10 秒 $0.56/¥4.00，1080P 6 秒 $0.49/¥3.50；02 图生视频 512P 6 秒 $0.10/¥0.60，10 秒 $0.15/¥1.00。价格按次生成计，非永久常量，审批前须重新核对官方定价页。
用法要点：先建立请求档案，记录区域、账号、密钥类型、模型、模式、分辨率、时长、数量、币种、单价与定价页获取时间，以及完整 prompt、prompt_optimizer、fast_pretreatment、源文件 SHA-256、MIME、尺寸等。图片须为 JPG/JPEG、PNG 或 WebP，小于 20 MB，短边大于 300 px，宽高比 2:5 至 5:2，可用公开 URL 或 Base64。prompt 上限 2,000 字符，支持 [Truck left]、[Push in]、[Static shot] 等镜头指令，官方建议单组括号内不超过三条组合指令。模型为必填；文生视频必须提供 prompt，图生视频与首尾帧的文字 prompt 可选；callback_url 可选。中国大陆文生视频端点另提供 aigc_watermark 布尔参数，默认 false，全球端点未提供。
限制与一致性：创建无幂等键，authenticated GET/轮询/下载可带界限退避重试，创建 POST 不得自动重试；创建超时或连接中断须标记 create-outcome-unknown，先对账再决定是否重发。HTTP 成功不等于提供方成功，需 base_resp.status_code == 0 且 task_id 非空。常见错误码含 1001 超时、1002 限流、1004 认证、1008 余额不足、1026 输入敏感、1027 输出敏感、2013 参数无效、2049 密钥无效、2056 用量限制。默认全球视频限额约 5 请求/分钟，轮询建议 10 秒间隔；生成结果应校验 MP4 后再交付。
适用场景：需要可审计、可重现且成本受控的 Hailuo 视频生成工作流。资料未提供的功能（如种子、负向提示、任意宽高比参数、音频输入输出）不得假定存在。