Skip to main content
MiniMax느림울트라

MiniMax Hailuo 2.3

고급 캐릭터 일관성과 자연스러운 움직임을 갖춘 사실적인 인물 모션 비디오 생성 모델입니다.

420 크레딧
비디오당
사실적인 인물 모션
고급 캐릭터 일관성
자연스러운 움직임 생성
이미지-비디오 변환 지원
3초 또는 6초 길이

AI 어시스턴트에서 사용하기

이 모델의 사용법을 Claude, ChatGPT 등에 복사

llms.txt

빠른 시작

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "minimax/hailuo-2.3",
  "input": {
    "prompt": "A young woman walking through a busy Tokyo street at night, realistic motion, natural gait, neon lights reflecting on wet pavement",
    "duration": "6",
    "aspect_ratio": "16:9"
  }
}'

파라미터

파라미터타입필수기본값설명
promptstringYes-생성할 비디오에 대한 텍스트 설명
image_urlstringNo-이미지-비디오 변환을 위한 시작 이미지 URL
durationintegerNo6비디오 길이 초 (3 또는 6)
36
aspect_ratiostringNo16:9출력 화면 비율
16:99:161:1

파일 입력 방법

이 모델의 image_url 파라미터에 파일을 전달하는 방법은 3가지입니다.

추천

간편 업로드 (Multipart)

POST /v1/predictions/upload에 파일을 직접 첨부합니다. 별도 업로드 과정이 필요 없습니다.

curl -X POST "https://api.core.today/v1/predictions/upload" \
  -H "X-API-Key: cdt_your_api_key" \
  -F "model=minimax/hailuo-2.3" \
  -F 'input={"prompt":"your prompt here"}' \
  -F "file:image_url=@your_file.png"

이미지 URL 전달

공개 접근 가능한 URL을 직접 전달합니다. Storage API로 업로드한 파일의 file_url도 사용 가능합니다.

{
  "model": "minimax/hailuo-2.3",
  "input": {
    "prompt": "your prompt here",
    "image_url": "https://example.com/image.jpg"
  }
}
File Upload 문서에서 Presigned URL 방식 등 더 자세한 업로드 방법을 확인하세요.

공통 파라미터

POST /v1/predictions 요청 시 사용되는 공통 파라미터입니다.

파라미터타입필수기본값설명
modelstringYes-모델 식별자
inputobjectYes-위 테이블의 모델별 파라미터를 포함하는 객체
output_folderstringNo-결과물 저장 폴더 경로 (최대 256자, '..' 사용 불가)
webhook_urlstringNo-완료 시 호출할 Webhook URL
is_publicbooleanNofalsetrue 시 결과물을 영구 공개 URL로도 제공

예제

캐릭터 워킹

사실적인 캐릭터 걷기 비디오

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "minimax/hailuo-2.3",
  "input": {
    "prompt": "A young woman walking through a busy Tokyo street at night, realistic motion, natural gait, neon lights reflecting on wet pavement",
    "duration": "6",
    "aspect_ratio": "16:9"
  }
}'

댄스 움직임

다이나믹한 댄스 움직임 비디오

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "minimax/hailuo-2.3",
  "input": {
    "prompt": "Contemporary dancer performing a graceful spin in a sunlit studio, flowing fabric, natural body movement, artistic composition",
    "duration": "6",
    "aspect_ratio": "9:16"
  }
}'

팁 & 모범 사례

1인물 캐릭터와 모션이 포함된 비디오에 가장 적합합니다
2캐릭터 일관성을 위해 image_url로 얼굴 이미지를 제공하세요
36초 길이는 더 복잡한 움직임 시퀀스를 허용합니다
4최상의 결과를 위해 신체 언어와 움직임을 명시적으로 설명하세요

사용 사례

캐릭터 중심 비디오 콘텐츠
인물 모션 애니메이션
가상 모델 쇼케이스
소셜 미디어 캐릭터 콘텐츠
댄스 및 움직임 비디오