메인 콘텐츠로 건너뛰기
POST
https://api.apimart.ai
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-Hailuo-02",
    "prompt": "잔디밭에서 뛰어다니는 귀여운 고양이",
    "duration": 5,
    "metadata": {
      "resolution": "768p",
      "prompt_optimizer": true,
      "fast_pretreatment": false,
      "watermark": false
    }
  }'
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-Hailuo-02",
    "prompt": "잔디밭에서 뛰어다니는 귀여운 고양이",
    "duration": 5,
    "metadata": {
      "resolution": "768p",
      "prompt_optimizer": true,
      "fast_pretreatment": false,
      "watermark": false
    }
  }'
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

인증

Authorization
string
required
모든 API 요청에는 Bearer Token 인증이 필요합니다API 키 얻기:API 키 관리 페이지에서 API 키를 얻으세요요청 헤더에 추가:
Authorization: Bearer YOUR_API_KEY

요청 매개변수

model
string
required
비디오 생성 모델 이름고정 값: MiniMax-Hailuo-02
prompt
string
required
비디오 내용 설명더 나은 생성 결과를 위해 장면, 동작, 스타일 등을 자세히 설명하세요예: "잔디밭에서 뛰어다니는 귀여운 고양이"
duration
integer
default:"5"
비디오 길이 (초)옵션:
  • 5 - 5초 비디오
  • 10 - 10초 비디오
기본값: 5
1080p 제한: 1080p 해상도를 사용할 때는 5초 길이만 지원됩니다
metadata
object
비디오 생성을 위한 고급 구성 옵션

매개변수 제한

제한사항설명
길이5초 또는 10초만 지원
1080p 해상도5초 길이만 지원
이미지 형식공개 URL 또는 Base64 인코딩 (data:image/jpeg;base64,...) 지원

해상도 및 길이 조합

해상도지원되는 길이참고
512p5초, 10초모두 지원
768p5초, 10초모두 지원
1080p5초10초 지원 안 함

응답

code
integer
응답 상태 코드, 성공 시 200
data
array
응답 데이터 배열

사용 사례

사례 1: 빠른 텍스트-비디오 생성

{
  "model": "MiniMax-Hailuo-02",
  "prompt": "밝은 햇살 속에서 잔디밭을 뛰어다니는 귀여운 고양이"
}

사례 2: 고품질 1080p 비디오 생성

{
  "model": "MiniMax-Hailuo-02",
  "prompt": "도시 야경, 네온 불빛 깜빡임, 교통 흐름",
  "duration": 5,
  "metadata": {
    "resolution": "1080p",
    "prompt_optimizer": true,
    "watermark": false
  }
}

사례 3: 첫 프레임 이미지에서 비디오 생성

{
  "model": "MiniMax-Hailuo-02",
  "prompt": "사람이 천천히 돌아서며 미소 짓는다",
  "duration": 5,
  "metadata": {
    "resolution": "768p",
    "first_frame_image": "https://example.com/portrait.jpg"
  }
}
작업 결과 쿼리비디오 생성은 비동기 작업이며 제출 시 task_id가 반환됩니다. 작업 상태 가져오기 엔드포인트를 사용하여 생성 진행 상황과 결과를 쿼리하세요.