视频生成 (Hailuo Video)

基于海螺 AI (Hailuo) 的视频生成接口。支持文本生成视频和图片生成视频，可选择不同分辨率和时长。

API 端点

POST/video_generation

创建视频生成任务

GET/query/video_generation

查询视频生成状态

请求参数

参数名	类型	必填	说明
`model`	string	必填	模型名称：Hailuo-2.3, Hailuo-2.3-Fast 等
`prompt`	string	必填	视频描述文本
`resolution`	string	可选	分辨率：768P 或 1080P
`duration`	integer	可选	视频时长（秒），默认 6
`first_frame_image`	string	可选	首帧图片 URL（图生视频）

请求示例

{
  "model": "Hailuo-2.3",
  "prompt": "一只可爱的猫咪在阳光下伸懒腰",
  "resolution": "1080P",
  "duration": 6
}

响应示例

{
  "task_id": "video_task_xxxxx",
  "status": "processing",
  "message": "视频生成任务已创建"
}

// 查询结果
{
  "task_id": "video_task_xxxxx",
  "status": "completed",
  "video_url": "https://...",
  "duration": 6,
  "resolution": "1080P"
}

代码示例

import requests
import time

API_BASE = "https://your-proxy-domain.com/v1"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}

# 创建视频生成任务
data = {
    "model": "Hailuo-2.3",
    "prompt": "一只可爱的猫咪在阳光下伸懒腰",
    "resolution": "1080P",
    "duration": 6
}
resp = requests.post(f"{API_BASE}/video_generation", headers=headers, json=data)
task_id = resp.json()["task_id"]

# 轮询查询任务状态
while True:
    status_resp = requests.get(
        f"{API_BASE}/query/video_generation?task_id={task_id}",
        headers=headers
    )
    result = status_resp.json()
    if result["status"] == "completed":
        print("视频已生成:", result["video_url"])
        break
    time.sleep(10)