文生视频
接口概览
- 接口路径:
POST /task/minimax/v1/video_generation - 业务分类:视频模型(Video)/海螺视频
- 认证方式:Bearer Token
- 服务地址:
https://api.gpt.ge
请求参数
请求体(application/json):
model(string,必填):模型名称,可选:MiniMax-Hailuo-2.3、MiniMax-Hailuo-02、T2V-01-Director、T2V-01。prompt(string,必填):视频文本描述,最长 2000 字符。对于MiniMax-Hailuo-2.3、MiniMax-Hailuo-02与*-Director系列,支持在prompt中使用方括号指令进行运镜控制(例如[推进]、[上升]、[固定]等),可组合或顺序使用以控制镜头。prompt_optimizer(boolean,可选,默认true):是否自动优化 prompt,设为false可获得更精确控制。fast_pretreatment(boolean,可选,默认false):是否缩短prompt_optimizer的优化耗时(仅对部分模型生效)。duration(integer,必填):视频时长(秒),支持6或10,默认6;可用值与模型/分辨率有关。resolution(string,必填):视频分辨率,具体可用选项视模型而定(示例:720P、768P、1080P)。callback_url(string,可选):任务状态回调地址。配置后服务器会先发送带challenge的验证请求,验证通过后会在任务状态变更时推送与查询接口一致的结果,回调status可能为processing、success或failed。
请求示例
bash
curl -X POST "https://api.gpt.ge/task/minimax/v1/video_generation" \
-H "Authorization: Bearer $YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"model":"MiniMax-Hailuo-02",
"prompt":"女子拿起一本书[上升],然后阅读[固定]。",
"duration":6,
"resolution":"1080P"
}'成功响应示例
json
{
"task_id": "106916112212032",
"base_resp": {"status_code": 0, "status_msg": "success"}
}返回字段说明
task_id(string):任务 ID,用于后续查询任务结果。base_resp.status_code(integer):内部状态码,0表示成功。base_resp.status_msg(string):简要结果说明。
说明
- 请务必传入
model、prompt、duration、resolution等必填字段。 - 如需接收异步回调,请确保
callback_url能正确响应验证请求(返回challenge)。