テキスト→動画
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% OFF）です。480pの公式価格はTopview定価と一致します。
Topview Business公式提示価格割引
768p
/秒
$0.0528
0.3クレジット
$0.088
40% OFF
40% OFF
1440p
/秒
$0.1056
0.6クレジット
$0.176
40% OFF
40% OFF
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米ドル価格はこの換算を使います
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クレジットです。米ドルは1クレジット = $0.176で換算します。
768pと1440pの公式比較単価は秒あたり$0.088と$0.176です。そのためTopview Businessの4秒あたり1.2クレジットと2.4クレジットは40% OFFになります。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換算を確認してください。