MiniAPI 影片、圖片與音訊
MiniAPI 是一個單一預付費 API 金鑰，用於存取 https://api.minicut.ai 上的影片、圖片與音訊模型。
標示為 coming soon（即將推出）的模型有價格但目前不接收任務；請選擇其他模型。
價格依秒數或圖片張數計算，在任務執行前設定。任務失敗不會收取費用。
點數永不過期。
輔助腳本（Node 18+，無需安裝）：node scripts/miniapi.mjs <command>，從此技能所在的資料夾執行。
步驟 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. 選擇模型
執行 node scripts/miniapi.mjs models 查看每個 ID 及其起始價格。
執行 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 行，並徵求同意。切勿在未經同意的情況下提交任務。
- 一次同意只涵蓋一個任務。重新執行或產生第二個片段需要新的報價和新的同意。
步驟 3. 執行
node scripts/miniapi.mjs run <id> '<json>' --yes --out <folder>
它會再次報價、提交、等待、將檔案下載至 <folder>，並輸出 SAVED <path> 和 CHARGED <price>。
向使用者顯示儲存路徑。如果是圖片，請開啟它；如果是影片片段，請提供路徑。
錯誤處理
| 退出碼 | 意義 | 處理方式 |
|---|---|---|
| 3 | 無金鑰 | 回到步驟 0 |
| 4 | 餘額不足 | 告訴使用者價格以及它印出的儲值連結 |
| 5 | MiniAPI 拒絕請求主體 | 讀取訊息，根據模型頁面修正欄位，再次報價 |
| 7 | 任務失敗 | 不收費。告知使用者，並提供一次更改後的重新嘗試，需重新報價 |
範例
使用者：「製作一個 5 秒的片段，內容為黎明時一隻紅狐在雪地中奔跑，720p」
node scripts/miniapi.mjs quote seedance-2.5 '{"prompt":"a red fox runs through snow at dawn","resolution":"720p","duration":5}'
# PRICE 1.750000 USD ... 報價免費，未實際執行動作。
#（詢問使用者，等待同意）
node scripts/miniapi.mjs run seedance-2.5 '{"prompt":"a red fox runs through snow at dawn","resolution":"720p","duration":5}' --yes --out clips
文件：https://api.minicut.ai/docs 。每個模型的 Markdown 文件：https://api.minicut.ai/llms.txt