Text-to-Video
POST /v1/common_task/text2video/task/submit — generate 480p, 768p, or 1440p clips up to 15 seconds from a prompt.
Generate MiniMax H3 clips from the Topview REST API. Compare Business member rates with the official 768p quote, then submit text-to-video, image-to-video, or reference tasks.
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());Business member rates from the Topview pricing table. 768p and 1440p official comparison rates are $0.088 and $0.176 per second (40% OFF). 480p official price matches the Topview list.
768p
/ second
$0.0528
0.3 credits
$0.088
40% OFF
1440p
/ second
$0.1056
0.6 credits
$0.176
40% OFF
The same MiniMax H3 generation modes available in Topview, callable as async tasks.
POST /v1/common_task/text2video/task/submit — generate 480p, 768p, or 1440p clips up to 15 seconds from a prompt.
POST /v2/common_task/image2video/task/submit — animate a first-frame image into a MiniMax H3 clip.
POST /v1/common_task/omni_reference/task/submit — pass image and video references with triple-bracket prompt syntax.
Every submit returns a taskId. Poll /task/query every 3–5 seconds until status is success, then download filePath.
Specs that change MiniMax H3 cost and output.
Topview catalog and Board identifier
Official comparison is mapped for 768p only
Catalog default is 15 seconds; billed per output second
Product clips ship with coordinated sound
Confirm the ratios accepted by the selected mode
All Business USD prices use this conversion
Get an API key, or try the same model in the Topview generator before you integrate.
REST API · Business rates · Async polling