텍스트-투-비디오
POST /v1/common_task/text2video/task/submit — 프롬프트로 480p, 768p 또는 1440p, 최대 15초 클립을 생성합니다.
개발자 API
MiniMax H3 API
Topview REST API로 MiniMax H3 클립을 생성하세요. Business 회원 요율과 공식 768p 제시가를 비교한 뒤 텍스트-투-비디오, 이미지-투-비디오 또는 참조 작업을 제출할 수 있습니다.
const submit = await fetch('https://api.topview.ai/v1/common_task/text2video/task/submit', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Topview-Uid': 'YOUR_USER_ID',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'minimax-h3',
prompt: 'A commercial product turntable with stereo room tone and soft key light',
aspectRatio: '16:9',
resolution: 768,
duration: 10,
sound: 'on',
generatingCount: 1
})
});
const { result } = await submit.json();
const query = await fetch(
'https://api.topview.ai/v1/common_task/text2video/task/query?taskId=' + result.taskId,
{ headers: { Authorization: 'Bearer YOUR_API_KEY', 'Topview-Uid': 'YOUR_USER_ID' } }
);
console.log(await query.json());MiniMax H3 API 요금
Topview 요금표의 Business 회원 요율입니다. 768p와 1440p 공식 비교 단가는 초당 $0.088과 $0.176입니다(40% 할인). 480p 공식 가격은 Topview 정가와 같습니다.
Topview Business공식 제시가할인
768p
/초
$0.0528
0.3 크레딧
$0.088
40% 할인
40% 할인
1440p
/초
$0.1056
0.6 크레딧
$0.176
40% 할인
40% 할인
API 기능
Topview에서 사용할 수 있는 MiniMax H3 생성 모드를 비동기 작업으로 호출할 수 있습니다.
이미지-투-비디오
POST /v2/common_task/image2video/task/submit — 첫 프레임 이미지를 MiniMax H3 클립으로 애니메이션화합니다.
참조 입력
POST /v1/common_task/omni_reference/task/submit — 삼중 꺾쇠 프롬프트 구문으로 이미지와 영상 참조를 전달하세요.
비동기 폴링
제출마다 taskId가 반환됩니다. status가 success가 될 때까지 3–5초마다 /task/query를 폴링한 뒤 filePath를 다운로드하세요.
모델 파라미터
MiniMax H3 비용과 출력이 바뀌는 사양입니다.
모델 ID
minimax-h3
Topview 카탈로그와 Board 식별자
해상도
480p / 768p / 1440p
공식 비교는 768p만 대응합니다
길이
최대 15초
카탈로그 기본값은 15초입니다. 출력 초 단위로 과금합니다
오디오
네이티브 영상+오디오
제품 클립에는 화면과 맞춘 사운드가 포함됩니다
화면비
16:9, 9:16, 1:1 등
선택한 모드가 받는 비율을 확인하세요
크레딧
1 크레딧 = $0.176
모든 Business USD 가격은 이 환산을 사용합니다
MiniMax H3 API로 시작하기
API Key를 받거나, 연동 전에 Topview 생성기에서 같은 모델을 사용해 보세요.
REST API · Business 요율 · 비동기 폴링
MiniMax H3 API 질문
Topview 카탈로그 식별자인 minimax-h3를 사용하세요. 계정에 표시 별칭이 있으면 API 문서에서 라이브 enum을 확인하세요.
Business 요율은 480p, 768p, 1440p에서 초당 0.15, 0.3, 0.6 크레딧입니다. USD는 1 크레딧 = $0.176으로 환산합니다.
768p와 1440p 공식 비교 단가는 초당 $0.088과 $0.176이므로, Topview Business의 4초당 1.2·2.4 크레딧은 40% 할인입니다. 480p 공식 가격은 Topview 정가와 같으며 초당 $0.0264입니다. 추가 참조 이미지와 입력 영상은 별도 요금일 수 있습니다.
아니요. 그것들은 별도 카탈로그 행입니다. 이 페이지는 minimax-h3만 다룹니다.
텍스트-투-비디오, 이미지-투-비디오 V2, omni reference입니다. 세 가지 모두 taskId를 반환합니다. 대응하는 /task/query 엔드포인트를 폴링하세요.
모든 요청에 Authorization: Bearer YOUR_API_KEY와 Topview-Uid: YOUR_USER_ID가 필요합니다.
MiniMax H3는 Topview 카탈로그에서 기본값이 약 15초입니다. 길이는 초당 Business 요율에 곱해집니다.
Topview 모델 요금 카탈로그를 열어 이미지·영상 요율, 공식 출처, 같은 Business 환산을 확인하세요.