비디오 생성

content 배열로 텍스트, 시작·종료 프레임, 참조 이미지, 참조 비디오 및 참조 오디오를 조합하고 작업 ID를 반환합니다.

POST/v2/video_generation

content 배열로 프롬프트 텍스트와 선택적 시작·종료 프레임, 참조 이미지, 참조 비디오 또는 참조 오디오를 조합합니다. 배열에는 비어 있지 않은 텍스트 항목이 하나 이상 포함되어야 합니다.

참조 이미지는 최대 9장, 참조 비디오는 최대 3개, 참조 오디오는 최대 3개입니다. 참조 이미지, 참조 비디오 및 참조 오디오는 각각 참조 미디어로 사용하거나 서로 조합하여 사용할 수 있습니다. 참조 미디어는 시작 또는 종료 프레임 이미지와 함께 사용할 수 없습니다.

MiniMax 업스트림이 유효한 JSON 오류를 반환하면 API는 업스트림 HTTP 상태 코드와 JSON 내용을 유지합니다.

인증

bearerAuth

인증Bearer <token>

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

전달 위치: header

요청 본문

application/json

MiniMax-H3 비디오 생성 요청입니다.

TypeScript 타입 정의

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

model*string

MiniMax-H3 비디오 모델 ID입니다. 모델 기록은 MiniMax-H3이며 실제 사용 가능한 모델은 현재 API 키가 반환하는 모델 목록을 기준으로 합니다.

길이1 <= length

content*array<|||>

입력 콘텐츠 배열입니다. 비어 있지 않은 text 항목이 하나 이상 포함되어야 합니다. 미디어 유형별 수량 및 조합 제한은 각 항목 설명을 참고하세요.

항목1 <= items

resolution*string

출력 비디오 해상도입니다.

허용 값

"768P"
"2K"

duration*integer

출력 비디오 길이이며 단위는 초입니다. 범위는 4~15입니다.

범위4 <= value <= 15

ratio?string

텍스트 기반 비디오 생성에서는 구체적인 비율을 전달해야 하며 adaptive를 사용할 수 없습니다. 시작 프레임, 종료 프레임 및 시작·종료 프레임 이미지 기반 비디오 생성에서는 입력 이미지가 비율을 결정하므로 adaptive를 사용해야 합니다. 멀티모달 참조 기반 비디오 생성에서는 생략할 수 있으며 기본적으로 adaptive를 사용하고 구체적인 비율을 지정할 수도 있습니다.

허용 값

"adaptive"
"21:9"
"16:9"
"4:3"
"1:1"
"3:4"
"9:16"

callback_url?string

MiniMax 작업 상태 callback 주소입니다.

형식uri

aigc_watermark?boolean

AIGC 워터마크 추가 여부입니다.

응답 본문

`application/json`

curl -X POST "https://example.com/v2/video_generation" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "content": [
      {
        "type": "text",
        "text": "비가 그친 상하이 거리, 영화 같은 카메라가 천천히 앞으로 이동하고 도로에는 네온 불빛이 비칩니다."
      }
    ],
    "resolution": "2K",
    "duration": 5,
    "ratio": "16:9"
  }'

{
  "task_id": "426014652088710"
}

인증

요청 본문

응답 본문

200application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`