目录
1.MiniMax海螺AI视频简介
海螺视频，作为 MiniMax 旗下海螺 AI 平台精心打造的 AI 视频生成工具，致力于助力用户产出高品质视频内容。该工具依托 abab-video-1 模型，具备强大的文生视频功能。用户仅需输入关键词或简短语句，海螺视频就能据此创作出情节丰富的完整视频。此外，海螺视频运用 DiT 架构，能够精准模拟现实世界的物理规律，尤其在生成复杂场景与高动作场景时，展现出卓越的性能。
2.使用教程
点击如下链接，进入蓝耘元生代智算云平台主页
https://cloud.lanyun.net/#/registerPage?promoterCode=11f606c51e
点击主页上方栏的"MaaS平台"
然后点击左侧栏的"视觉模型"
可以看到可以免费体验一次I2V-01图片生成视频
点击如下红框处将图片上传
例如输入如下的图片
例如想让小狗动起来，可以在如下红框处输入相应的指令，然后点击立即生成 ， 等待一段时间后，视频即可生成出来
视觉模型API
Video Generation（视频生成）
该API支持基于用户提供的prompt、首帧图片、主体参考图片，生成720p，25帧的动态视频。
该接口采用异步调用的方式完成视频生成：首先创建视频生成任务，对应接口会返回任务ID（task_id）；接下来，在异步任务查询接口通过任务 ID （task_id），获取视频生成任务的状态，以及生成的视频的文件ID（file_id）。
API说明
完成视频生成及下载，使用到三个API：创建视频生成任务、查询视频生成任务状态文件管理。具体步骤如下：
1.使用创建视频生成任务接口，创建视频生成任务，并得到task_id；
2.使用查询视频生成任务状态接口，基于task_id查询视频生成任务状态；当状态为成功时，将获得对应的文件 ID（file_id）；
3.使用文件管理接口（File API）基于步骤2查询接口返回的file_id进行视频生成结果的查看和下载。
创建视频生成任务API
POST https://maas-api.lanyun.net/v1/video_generation
请求示例（Python）
import requests
import json
url = "https://maas-api.lanyun.net/v1/video_generation"
payload = json.dumps({
"model": "I2V-01-Director",
"prompt": "测试12312312313",
"promptOptimizer": "true",
"firstFrameImage": "data:image/jpeg;base64,{image_base64_data}"
})
headers = {
'Authorization': 'Bearer sk-******************',
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)请求示例（Crul）
curl --location --request POST 'https://maas-api.lanyun.net/v1/video_generation' \
--header 'Authorization: Bearer sk-*****************' \
--header 'Content-Type: application/json' \
--data-raw '{
"model": "I2V-01",
"prompt": "起风了",
"promptOptimizer": true,
"firstFrameImage": ""
}'返回示例
{
"task_id": "174741320903036928",
"base_resp": {
"status_code": 0,
"status_msg": "success"
}
}| 请求体（Request）参数 | |||
|---|---|---|---|
| 参数名称 | 类型 | 必填项 | 描述 |
| Authorization | string | 必填 | 给定的API密钥 |
| Content-Type | application/json | 必填 | Content-type |
| model | string | 必填 | 调用的算法模型ID。可选项：T2V-01-Director、I2V-01-Director、S2V-01、I2V-01-live、I2V-01、T2V-01 |
| prompt | string | 非必填 | 生成视频的描述。(注：最大支持2000字符)。 |
| promptOptimizer | boolean | 非必填 | 默认取值为True，模型会自动优化传入的prompt，以提升生成质量。如果需要更精确的控制，可以将此参数设置为False，模型将更加严格地遵循指令。此时建议提供更精细的prompt，以获得最佳效果 |
| firstFrameImage | string | 非必填 | 本参数当model选择为I2V-01I2V-01-DirectorI2V-01-live时，为必填参数。模型将以此参数中传入的图片为首帧画面来生成视频。支持传入图片的data:image/jpeg;base64,{data}格式的 Base64 编码字符串，或可通过公网访问的 URL。传入此参数时支持将prompt设置为空字符串或不传入prompt，模型将自主决定画面如何演变。 传入图片需要满足以下条件： - 格式为JPG/JPEG/PNG； - 长宽比大于2:5、小于5:2； - 短边像素大于300px； - 体积不大于20MB。 |
| subjectReference | array | 非必填 | 本参数仅当model选择为S2V-01时可用。模型将依据此参数中上传的主体来生成视频。目前仅支持单主体参考（数组长度为 1）。 |
| 返回（Response）参数 | |||
| task_id | string | 视频生成异步任务的任务id，生成结果需要通过使用此id在异步任务查询接口中获取。 | |
| base_resp | 状态码及其详情。 base_resp.status_code 状态码及其分别含义如下： 0：请求成功； 1002：触发限流，请稍后再试； 1004：账号鉴权失败，请检查 API-Key 是否填写正确； 1008：账号余额不足； 1026：视频描述涉及敏感内容，请调整； 2013：传入参数异常，请检查入参是否按要求填写； 2049：无效的api key，请检查api key。 base_resp.status_msg 具体错误详情 |
其他说明： 当参数model选择为T2V-01-DirectorI2V-01-Director时，对prompt中的运镜控制，有更准确的响应。
-
支持插入运镜指令，实现运镜控制：运镜指令需以[ ]格式插入prompt中镜头应用处，标准运镜指令格式为[C1,C2,C3]，其中C表示不同类型运镜，共支持15种枚举运镜方式，具体可参考下方详情。为保证运镜效果，建议组合运镜指令不超过3个。 1、支持15种运镜方式（枚举值） （1） 左右移：[左移]、[右移] （2）左右摇：[左摇]、[右摇] （3）推拉：[推进]、[拉远] （4）升降：[上升]、[下降] （5）上下摇：[上摇]、[下摇] （6）变焦：[变焦推近]、[变焦拉远] （7）晃动：[晃动] （8）跟随：[跟随] （9）固定：[固定] 2、支持单一及组合运镜 （1）单一运镜：例如[左摇]，表示插入单一镜头； （2）多运镜同时生效：同一组内的镜头表示同时生效，如[左摇,右移]，表示插入两个组合镜头，且同时生效； （3）多运镜先后生效：插入在前的镜头指令，先生效。如在prompt描述"xxx[左摇]，xxx[右移] " 表示：视频生成时，先运行左摇镜头，后运行右移镜头；
-
支持通过自然语言描述，实现运镜控制；使用指令内运镜名称，会提升运镜响应准确性。
-
运镜指令与自然语言描述可同时生效。
查询视频生成任务状态API
GET https://maas-api.lanyun.net/v1/query/video_generation?taskId={task_id}
请求示例（Python）
import requests
import json
api_key="sk-*************"
task_id="174847042751959040"
url = f"https://maas-api.lanyun.net/v1/query/video_generation?taskId={task_id}"
payload = {}
headers = {
'authorization': f'Bearer {api_key}'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)请求示例（Crul）
curl --location --request GET 'https://maas-api.lanyun.net/v1/query/video_generation?taskId=174741320903036928' \
--header 'Authorization: Bearer sk-**************'返回示例
{
"taskId": "174741320903036928",
"status": "Success",
"videoWidth": null,
"videoHeight": null,
"videoDownLoadUrl": "https://oss.lanyun.net/private//cloud-maas/11564/16/2025-03-11/32206a67-5265-4db9-a0c8-081d38653943.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=G54Tgw7wJRAKeBOej7Rz%2F20250311%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250311T030018Z&X-Amz-Expires=86400&X-Amz-SignedHeaders=host&X-Amz-Signature=e3a77757c844412a6dfc24f1770b6a201041027eda8691f6493b28011927b539"
}| 请求体（Request）参数 | |||
|---|---|---|---|
| 参数名称 | 类型 | 必填项 | 描述 |
| Authorization | string | 必填 | 给定的API密钥 |
| taskId | string | 必填 | 需要查询的任务ID。仅能查绚当前账号创建的任务。 |
| 返回（Response）参数 | |||
| taskId | string | -- | 需要查询的任务ID。仅能查绚当前账号创建的任务。 |
| status | string | -- | 任务状态，包括以下状态： Preparing-准备中 Queueing-队列中 Processing-生成中 Success-成功 Fail-失败 |
| videoWidth | -- | -- | 任务成功后，该字段将返回生成视频的横边像素数。 |
| videoHeight | -- | -- | 任务成功后，该字段将返回生成视频的竖边像素数。 |
| videoDownLoadUrl | -- | -- | 任务成功后，该字段将返回生成视频的临时下载地址。 |