MiniAPI 動画、画像、音声
MiniAPIは、https://api.minicut.ai で動画、画像、音声モデルを一つのプリペイドAPIキーで利用できるサービスです。
models で coming soon とマークされたモデルは価格は表示されますが、まだジョブを受け付けていません。別のモデルを選んでください。
価格は秒単位または画像単位で、ジョブ実行前に設定されます。失敗したジョブは課金されません。
クレジットに有効期限はありません。
ヘルパースクリプト（Node 18以上、インストール不要）： node scripts/miniapi.mjs <コマンド>、このスキルのフォルダから実行します。
ステップ 0. キー
MINIAPI_KEYが設定されていない場合、ユーザーに一行で伝えてください：キーを https://api.minicut.ai/console/keys?utm_source=skills-sh&utm_medium=skill&utm_campaign=miniapi-video で作成し、 資金を追加し（最低$10）、その後export MINIAPI_KEY=mapi_live_...を実行するように伝えてください。実行を待ちます。- キーを絶対に出力しないでください。プロジェクト内のファイルに書き込まないでください。
ステップ 1. モデルを選ぶ
すべてのIDとその開始価格を確認するには node scripts/miniapi.mjs models を実行します。
特定のモデルのパラメータ、制限、価格を確認するには node scripts/miniapi.mjs model <id> を実行します。
そのモデルのページにリストされているパラメータのみを使用してください。モデルが受け付けないパラメータは422エラーで拒否されます。
ユーザーが指定しなかった場合のデフォルト：
| ジョブ | モデルID | 理由 |
|---|---|---|
| 動画、最高品質 | seedance-2.5 | 4～30秒、最大1080p、参照動画、デフォルトで音声あり |
| 動画、安価なドラフト | seedance-2.0-mini | $0.054 / 秒から |
| 画像 | models を読み、ユーザーが指定した画像モデルを選ぶ。指定がない場合は最も安い画像モデル |
ステップ 2. 見積もり、そして確認
- モデルページからJSONボディを構築します。
node scripts/miniapi.mjs quote <id> '<json>'を実行します。見積もりは無料で、何も実行されません。- ユーザーにPRICE行を表示し、承諾を求めます。承諾なしに決して送信しないでください。
- 1回の承諾は1つのジョブをカバーします。再試行または2つ目のクリップは新しい見積もりと新しい承諾が必要です。
ステップ 3. 実行
node scripts/miniapi.mjs run <id> '<json>' --yes --out <フォルダ>
再度見積もりを行い、送信し、待機し、ファイルを <フォルダ> にダウンロードし、SAVED <パス> と CHARGED <価格> を出力します。
ユーザーに保存先のパスを表示します。画像の場合は開きます。動画の場合はパスを伝えます。
エラー
| 終了コード | 意味 | 対処 |
|---|---|---|
| 3 | キーなし | ステップ0 |
| 4 | 残高不足 | 価格と、出力された資金追加リンクをユーザーに伝える |
| 5 | MiniAPIがボディを拒否 | メッセージを読み、モデルページからフィールドを修正し、再度見積もる |
| 7 | ジョブ失敗 | 課金されません。その旨を伝え、新しい見積もりで変更した再試行を提案する |
例
ユーザー：「夜明けの雪の中を走る赤いキツネの5秒クリップ、720p」
node scripts/miniapi.mjs quote seedance-2.5 '{"prompt":"夜明けの雪の中を走る赤いキツネ","resolution":"720p","duration":5}'
# PRICE 1.750000 USD ... 見積もりは無料です。何も実行されていません。
# （ユーザーに確認、承諾を待つ）
node scripts/miniapi.mjs run seedance-2.5 '{"prompt":"夜明けの雪の中を走る赤いキツネ","resolution":"720p","duration":5}' --yes --out clips
ドキュメント：https://api.minicut.ai/docs 。各モデルのMarkdown：https://api.minicut.ai/llms.txt