Skip to main content
POST
Minimax H3 Text-to-Video 텍스트-비디오

인증

Authorization
string
header
필수

##모든 API는 Bearer Token 인증이 필요합니다##

API Key 얻기:

API Key 관리 페이지에서 API Key를 받으세요

요청 헤더에 다음을 추가하세요:

본문

application/json
model
enum<string>
기본값:minimax-h3-text-to-video
필수

비디오 생성 모델 이름

사용 가능한 옵션:
minimax-h3-text-to-video
예시:

"minimax-h3-text-to-video"

prompt
string
필수

생성하려는 동영상의 내용을 설명합니다.

프롬프트 요구 사항:

  • 필수이며 비워 둘 수 없습니다
  • 중국어와 영어를 지원합니다
  • 중국어는 500자, 영어는 1000단어 이하를 권장합니다. 프롬프트가 너무 길면 일부 세부 사항이 무시될 수 있습니다

입력 제한:

  • 이 모델은 텍스트로만 동영상을 생성하며 텍스트 입력만 허용합니다
  • image_start, image_end, image_urls, video_urls, audio_urls는 지원하지 않습니다
  • 이러한 미디어 필드를 전달하면 매개변수 오류가 반환됩니다
Minimum string length: 1
예시:

"장대한 스페이스 오페라 영화 예고편. 여성 함장이 거대한 전망창 앞에 홀로 서 있고 창밖에는 마지막 함대가 집결한다. 함대가 눈부신 섬광과 함께 도약하며 함교가 크게 흔들리고, 빛이 사라지자 그녀만 고요한 심우주에 남는다. 영화 같은 조명, 느린 돌리 인, 웅장하면서 절제된 분위기."

duration
integer
기본값:5

출력 동영상 길이(초)입니다. 기본값은 5초입니다.

값 제한:

  • 5부터 15까지의 정수만 지원하며 양쪽 경곗값을 포함합니다
  • 소수, 숫자 문자열, auto, -1은 지원하지 않습니다
  • 출력 길이는 요금에 직접 영향을 줍니다
필수 범위: 5 <= x <= 15
예시:

5

quality
enum<string>
기본값:2k

출력 동영상 해상도입니다. 기본값은 2k입니다.

사용 가능한 값:

  • 2k: 현재 지원하는 유일한 해상도

참고:

  • 768p는 아직 제공되지 않으며 전달하면 매개변수 오류가 반환됩니다
  • 출력 비트레이트, 프레임률, 동영상 코덱, 오디오 코덱은 플랫폼에서 결정하며 요청으로 설정할 수 없습니다
사용 가능한 옵션:
2k
예시:

"2k"

aspect_ratio
enum<string>
기본값:adaptive

출력 동영상 화면 비율입니다. 기본값은 adaptive입니다.

사용 가능한 값:

  • adaptive: 프롬프트에 따라 적절한 비율을 자동 선택
  • 21:9: 울트라와이드
  • 16:9: 가로형
  • 4:3: 표준 가로형
  • 1:1: 정사각형
  • 3:4: 표준 세로형
  • 9:16: 세로형
사용 가능한 옵션:
adaptive,
21:9,
16:9,
4:3,
1:1,
3:4,
9:16
예시:

"adaptive"

callback_url
string<uri>

작업 완료 후 HTTPS 콜백 주소

콜백 시점:

  • 작업 완료(completed) 또는 실패(failed) 시 트리거
  • 과금 확인 완료 후 전송

보안 제한:

  • HTTPS 프로토콜만 지원
  • 내부 네트워크 IP 주소로의 콜백 금지(127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x 등)
  • URL 길이는 2048자를 초과할 수 없습니다

콜백 메커니즘:

  • 타임아웃: 10
  • 실패 시 최대 3회 재시도(실패 후 각각 1/2/4초 후 재시도)
  • 콜백 응답 본문 형식은 작업 조회 API 반환 형식과 동일
  • 2xx 상태 코드를 성공으로 간주하며, 다른 상태 코드는 재시도를 트리거합니다
Pattern: ^https://
예시:

"https://your-domain.com/webhooks/video-task-completed"

응답

비디오 생성 작업이 성공적으로 생성되었습니다

created
integer

작업 생성 타임스탬프

예시:

1761313744

id
string

작업 ID

예시:

"task-unified-1774857405-abc123"

model
string

실제 사용된 모델 이름

예시:

"minimax-h3-text-to-video"

object
enum<string>

작업의 구체적 유형

사용 가능한 옵션:
video.generation.task
progress
integer

작업 진행률 (0-100)

필수 범위: 0 <= x <= 100
예시:

0

status
enum<string>

작업 상태

사용 가능한 옵션:
pending,
processing,
completed,
failed
예시:

"pending"

task_info
object

비디오 작업 상세 정보

type
enum<string>

작업의 출력 유형

사용 가능한 옵션:
text,
image,
audio,
video
예시:

"video"

usage
object

사용량 및 과금 정보