비디오 생성

공통 매개변수는 요청의 최상위에 있으며 모델 전용 매개변수는 metadata로 전달합니다.

POST/v1/video/generations

플랫폼 Video Generations의 공통 필드로 Hailuo 비디오 작업을 생성합니다. Hailuo 전용 매개변수는 모두 metadata 객체에 넣어야 합니다.

MiniMax-Hailuo-2.3과 MiniMax-Hailuo-2.3-Fast는 6초 또는 10초와 768P, 1080P를 지원합니다. MiniMax-Hailuo-02는 6초 또는 10초와 512P, 768P, 1080P를 지원합니다. T2V-01-Director는 6초와 768P, 1080P를 지원하고 T2V-01은 6초와 720P를 지원합니다. I2V-01-Director, I2V-01-live, I2V-01은 6초와 720P, 1080P를 지원하고 S2V-01은 6초와 720P를 지원합니다.

실제 사용 가능한 모델과 기능은 현재 API 키가 반환하는 모델 목록과 선택한 모델을 기준으로 합니다.

인증

bearerAuth

인증Bearer <token>

Authorization Header에 Bearer your-api-key를 사용합니다.

전달 위치: header

요청 본문

application/json

Hailuo 비디오 생성 요청입니다.

TypeScript 타입 정의

TypeScript에서 request body 타입을 사용하세요.

model*string

Hailuo 비디오 모델 ID입니다. 모델 기록에는 MiniMax-Hailuo-2.3, MiniMax-Hailuo-2.3-Fast, MiniMax-Hailuo-02, T2V-01-Director, T2V-01, I2V-01-Director, I2V-01-live, I2V-01, S2V-01이 포함됩니다.

실제 사용 가능한 모델은 현재 API 키가 반환하는 모델 목록을 기준으로 합니다.

길이1 <= length

prompt*string

생성할 비디오 내용을 설명합니다.

길이1 <= length

size?string

출력 해상도입니다. Hailuo 2.3 계열은 768P와 1080P를 지원하고 MiniMax-Hailuo-02는 512P, 768P, 1080P를 지원합니다. T2V/I2V/S2V 계열의 구체적인 지원 범위는 모델에 따라 다릅니다.

duration?integer

비디오 길이이며 단위는 초입니다. Hailuo 2.3 및 02 계열은 6초 또는 10초를 지원하고 T2V/I2V/S2V 계열의 기록은 6초입니다. 실제 지원 범위는 선택한 모델을 기준으로 합니다.

metadata?

Hailuo 모델 전용 확장 매개변수입니다.

응답 본문

`application/json`

curl -X POST "https://example.com/v1/video/generations" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "사이버펑크 스타일의 말이 달리고 뒤에는 네온 불빛이 깜박이는 미래 도시가 있습니다.",
    "size": "768P",
    "duration": 6
  }'

{
  "id": "video_123",
  "object": "video",
  "model": "MODEL_ID",
  "created_at": 1640995200,
  "task_id": "abcd1234efgh",
  "status": "",
  "progress": 0
}

인증

요청 본문

응답 본문

200application/json

400application/json

401application/json

403

500

`application/json`

`application/json`

`application/json`