海螺 Hailuo API 怎么调用?Fast 版和标准版怎么选、一条能用的视频到底花多少(2026)
海螺(MiniMax Hailuo)视频 API 的完整用法:异步任务怎么提交和轮询、Fast 版和标准版按什么场景分工、按条计费下怎么算「一条能用的成片」的真实成本,以及失败、超时、链接过期的排查顺序。
1. 先弄懂调用流程:它是排队任务,不是一次请求
所有正经的视频模型都一样,海螺也不例外:生成一条视频要花的时间远超一次 HTTP 请求该等的时长,所以接口被设计成任务队列。第一步,POST 提交型号、分辨率、时长和提示词(图生视频再带一张首帧图);第二步,接口立刻返回一个任务 ID;第三步,每隔几秒查一次任务状态,直到它落到终态;第四步,成功就读出文件链接、把视频下载下来。第一次接入踩的坑,几乎都是没吃透这个流程:把提交成功当成生成成功、轮询频率过高、忘了最终链接是临时的。把轮询器写一次 —— 带合理间隔、带超时 —— 以后接任何一家视频模型都能复用。
2. 标准版和 Fast 版:按活选,不按价格选
标准版接受纯文字或图片输入,运动连贯性和画面细节更好,用在最后要进成片的镜头,以及只有文字、没有画面的创意上。Fast 版只负责把你给的图片动起来,快、适合批量,最适合「两段式」流水线:先用图片模型出关键帧(构图、人脸、商品外观、品牌色在图片阶段远比在视频阶段好控制),再把关键帧成批交给 Fast 版转视频。很多团队最后落在这样的分工上:Fast 版做探索和分镜预演,标准版出最终交付的那几条。如果你发现自己总在为构图问题反复重跑标准版,说明问题应该在图片阶段解决,而不是在视频阶段花钱试。
3. 一条能用的成片到底花多少:留用率公式
按条计费很诚实,但它藏了一个变量:你要扔掉多少条。AI 视频本质上是抽卡,大多数创作场景里只有一部分结果能直接用。所以做预算请用这个公式:一条能用的成片的成本 = 单条价格 ÷ 留用率。如果一条的价格是 P、每抽五条留一条,那一条能用的成片实际花了 5P。由此能推出两件事。第一,便宜的版本如果留用率更低,算到每条成片上可能反而更贵 —— 所以比较版本和厂商时要比这个数,而不是比价目表。第二,任何能提高留用率的动作(更好的关键帧、更简单的提示词、固定的一组风格参考图),都比压低单条价格更值钱。怎么测:挑一个有代表性的镜头,每个候选版本各跑 20 条,数一数能用的有几条,你就有了一个能写进预算表的真实数字。
4. 在 cocodot 上怎么接
POST https://cocodot.co/api/ai/video/generations,model 填视频型号列表(GET https://cocodot.co/api/ai/video/models)里返回的海螺型号名 —— 标准版和 Fast 版是两个不同的型号名;分辨率和时长只能选列表里列出的组合;提示词放在 content 里,图生视频再加上图片。返回里带任务 ID,之后轮询 GET https://cocodot.co/api/ai/video/generations/{id},状态到 SUCCEEDED 再读视频链接。价格在提交时锁定,任务以失败结束不扣费。我们只上架逐档核过上游价格的分辨率和时长组合,所以列表里的标价就是实际扣费;其余组合核完价后再出现在列表里。充值用支付宝 / 微信支付(人民币),同一个 key 和余额还能调可灵(按秒计费、有声档)和 Seedance(更长的单条),同一个镜头可以在三家之间做 A/B,不用开三个账户。
5. 提示词:一条短片只装得下一件事
海螺出的是短片,短片最怕贪心的提示词。每条按这个顺序写,只写一组:一个主体、一个动作、一个镜头运动 —— 画面里是谁或是什么、它在做什么、镜头怎么动。光线和镜头质感描述一次就够,不要堆形容词。对白和画面里的文字别写,几秒钟的视频里这两样都很难稳定出效果。图生视频时,让图片负责构图,提示词只写动作:把图片里已经有的东西再描述一遍,往往会和图片「打架」,反而让画面跑偏。一个镜头里要发生两件事,就拆成两条,在剪辑软件里接起来 —— 剪辑师本来就是这么干的,而且比反复重跑一条塞满动作的视频便宜得多。
6. 失败、超时、链接过期:按这个顺序排查
任务以失败结束时,先看返回里的失败原因,别急着点重试。最常见的是提示词或图片没过内容审核 —— 原样重试大概率还是失败,要改提示词或换图。失败的任务不扣费,但这不等于重试免费:改过之后重新提交并成功,是一条新任务,照常计费。轮询一直不出结果时,检查轮询器有没有超时上限,不要让一个卡住的任务一直占着进程。视频链接第二天打不开,是因为生成的文件链接本来就是临时的 —— 解决办法只有一个:任务一成功就下载到自己的存储,并把任务 ID、提示词、版本和结果记进日志,以后查账和算留用率都靠它。
7. 直接用 MiniMax 开放平台,还是走中转
MiniMax 有自己的开放平台(platform.minimaxi.com)。如果你只用海螺一家,而且能顺利给 MiniMax 付款,直连官方完全合理:完整参数和规格以官方文档为准。官方的单价、支持的规格和注册要求会变,请以 MiniMax 开放平台当前页面为准,这里不转述。中转值得用的情况有三种:你要在一个 key、一个余额下同时用几家视频模型;你不想在每家分别预充一笔钱;或者你在某家的付款环节卡住了。三条都不沾,直连就好。
8. 上批量之前的五项检查
把批量脚本指向任何视频 API 之前,先确认五件事。一,轮询器有超时和退避,卡住的任务不会一直占着进程。二,每条成功的视频立刻下载到自己的存储,因为生成链接会过期。三,每条任务都记下任务 ID、提示词、版本和结果,这是之后算留用率的唯一数据来源。四,失败任务最多改提示词重试一两次 —— 内容审核没过的提示词原样重试只会再失败一次。五,在自己的代码里设一个每日花费上限:批量脚本里一个循环 bug,是一夜之间烧光视频预算最常见的方式。这些都不是海螺独有的,这正是重点 —— 写一次,以后每接一家模型都直接复用。
海螺两个版本按场景怎么选
| 你的情况 | 用哪个版本 | 理由 |
|---|---|---|
| 只有文字创意,还没有画面 | 标准版 | Fast 版不接受纯文字请求,文生视频只能用标准版 |
| 已有商品图、角色图或分镜图,要批量动起来 | Fast 版 | 只做图生视频,速度快,适合一次跑一批 |
| 草稿阶段,试运镜和节奏 | Fast 版(先出关键帧) | 构图交给图片模型定死,视频只负责「动起来」,试错成本最低 |
| 要进成片的镜头,细节和动作要稳 | 标准版 | 运动连贯性和细节更好,留用率通常更高 |
| 一条要讲完一段较长的连续情节 | 换 Seedance,或拆成多条再剪 | 海螺是短片引擎,三家对比见 /hub/ai-video-api-price-compare |
| 声音要和画面一起生成 | 换可灵的有声档 | 可灵有专门的有声档位,见 /hub/kling-v3-api |