MiniMax H3 Edit API：768p 有聲影片

Name: MiniMax H3 Edit API
SKU: minimax/h3-edit/video-edit
Price: 0.15 USD
Availability: InStock

關於 MiniMax H3 Edit

MiniMax H3 Edit 可以改變你上傳片段的光線、天氣、風格或場景，而你的原始素材仍然決定畫面中是誰、構圖與動作。它可以編輯 3 到 15 秒的片段，解析度為 480p、540p 或 768p，並預設加入新的配樂。

在 POST /jobs/createTask 把模型名稱填成 minimax/h3-edit/video-edit 就能呼叫，US$0.15 起。

請求參數

參數	必填	說明
`aspect_ratio`	否	畫面形狀：橫式、方形或直式。 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · 9:21
`duration_seconds`	否	影片長度，按秒計費。 ≥ 3 · ≤ 15 · 預設值: 5
`generate_audio`	否	加上和畫面相配的聲音：人聲、環境音和音效。預設值: true
`prompt`	是	The change to make: lighting, weather, style, setting or specific elements. Name references as <Picture 1> or <Audio 1>.
`reference_audio_urls`	否	要搭配的聲音：人聲、音樂或節奏。
`reference_image_urls`	否	希望結果保留的人物、服裝或場景的參考圖。
`resolution`	否	輸出尺寸。越大越清晰，價格也越高。 480p · 540p · 768p · 預設值: 768p
`seed`	否	用同一個數字，結果就能重現。 ≥ 0 · ≤ 2147483647
`video_url`	是	要處理的影片。

價格

價格以美元計。API 使用獨立的美元餘額。網站點數不能用於 API，也不能轉入 API 餘額；API 餘額同樣不能轉為網站點數。任務受理時，從 API 餘額中保留報價的最高金額；完成後按實際用量結算，實際扣款不超過保留金額，並釋放剩餘金額。任務失敗則釋放保留金額。

選項	USD /秒
resolution 480p	US$0.03
resolution 540p	US$0.045
resolution 768p	US$0.066

執行前，將相同請求內容傳送至 POST /jobs/quote，即可查看預估費用與最高費用，單位為美元。報價不會執行任務或扣款。

API 快速上手

三步驟呼叫 MiniMax H3 Edit API

建立 API 金鑰. 登入 PopNow，在 API 主控台建立金鑰。金鑰以 sk-popnow- 開頭，API 呼叫使用獨立的美元餘額。
送出請求. 對 POST /jobs/createTask 送出請求，model 填 minimax/h3-edit/video-edit，input 依照參數表填寫。回應會立即傳回任務 ID。
取得結果. 用任務 ID 輪詢 GET /jobs/recordInfo，或帶上 callBackUrl，結果會推送到該網址。任務成功後下載輸出連結。

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "minimax/h3-edit/video-edit",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "resolution": "768p",
    "duration_seconds": 5
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

請把提示詞和連結換成你自己的。API 頁籤裡有回應、輪詢和回呼的參考。

MiniMax H3 Edit API 常見問題

MiniMax H3 Edit API 怎麼收費？

MiniMax H3 Edit：US$0.15/ 5 秒影片。各選項價格：480p US$0.03/秒、540p US$0.045/秒、768p US$0.066/秒。API 使用獨立的美元餘額。網站點數不能用於 API，也不能轉入 API 餘額；API 餘額同樣不能轉為網站點數。任務受理時，從 API 餘額中保留報價的最高金額；完成後按實際用量結算，實際扣款不超過保留金額，並釋放剩餘金額。任務失敗則釋放保留金額。

MiniMax H3 Edit 在 API 裡的模型名稱是什麼？

在 POST /jobs/createTask 的 model 欄位填編輯影片用 minimax/h3-edit/video-edit。

MiniMax H3 Edit API 有哪些限制？

影片長度：3–15 s；解析度：480p · 540p · 768p；畫面比例：16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · 9:21；參考音訊：3；參考圖：9。超出這些限制的請求會在扣款之前被拒絕。

不寫程式能試 MiniMax H3 Edit 嗎？

不需要 API 金鑰，即可在 Playground 用 API 美元餘額執行 MiniMax H3 Edit。每次執行都記入開發者紀錄，並附對應程式碼。

所有 MiniMax 模型

Kling O3 同樣能編輯片段，並支援最高 4K。如果只是換風格或改天氣，H3 Edit 更快，價格也較低。