동영상 생성 (Hailuo Video)

Hailuo AI 기반 동영상 생성 인터페이스입니다. 텍스트-동영상 및 이미지-동영상 변환을 지원하며, 해상도와 길이를 선택할 수 있습니다.

API 엔드포인트

POST/video_generation

동영상 생성 작업 생성

GET/query/video_generation

동영상 생성 상태 조회

요청 파라미터

파라미터타입필수설명
modelstring필수모델 이름: Hailuo-2.3, Hailuo-2.3-Fast 등
promptstring필수동영상 설명 텍스트
resolutionstring선택해상도: 768P 또는 1080P
durationinteger선택동영상 길이(초), 기본값 6
first_frame_imagestring선택첫 번째 프레임 이미지 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)