PopNowAPI ドキュメント
本文

MiniMax H3 Max API リファレンス

環境音・効果音・音楽つきのクリップを速く

PopNow の API キー 1 つで、MiniMax H3 Max を自分のコードから呼び出せます。送るモデル ID、受け付ける入力フィールド、1 回あたりのクレジット、ターミナルに貼ってそのまま動くリクエストをこのページにまとめました。

パラメーターの説明はモデルの入力 schema から取っているため、英語のみです。

概要

開発元
MiniMax
出力
動画
最安
7.5 クレジット 出力 1 秒あたり ($0.075)
目安の所要時間
約 31 秒

1 クレジット = 0.01 米ドル。タスクの受付時に上限額を確保し、完了時に実際の使用量で精算します(整数クレジットに切り上げ、差額は返却)。失敗したタスクには課金されません。実行前に正確な金額を知りたいときは POST /api/v1/jobs/quote を呼んでください。

動画を作成

minimax/h3-max/text-to-video

料金

オプションクレジット (出力 1 秒あたり)米ドル
480p7.5$0.075
768p12$0.12

パラメーター

フィールド型既定値指定できる値説明
prompt必須string—7,000 文字までDescribe the subject, action, camera, and mood of the shot.
aspect_ratio任意string1:121:9, 16:9, 4:3, 1:1, 3:4, 9:16Output aspect ratio.
duration_seconds任意integer85〜15Requested output length in seconds, from 5 to 15.
resolution任意string768p480p, 768pOutput resolution.
enable_prompt_expansion任意booleanfalse—Expand the prompt into a fuller description before generating. Requests with it on add a flat per-request prompt-expansion fee.

リクエスト例

このリクエストはそのまま実行できます。省略したフィールドには既定値が入ります。先にキーを環境変数 POPNOW_API_KEY に設定してください。

POST /api/v1/jobs/createTask
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: $(uuidgen)" \
  -d '{
  "model": "minimax/h3-max/text-to-video",
  "input": {
    "prompt": "A paper boat drifts down a rain-soaked street at dusk, neon signs reflecting in the water, slow tracking shot at ground level",
    "enable_prompt_expansion": false,
    "resolution": "768p",
    "duration_seconds": 8
  }
}'

レスポンスにはすぐに taskId が入ります。結果は GET /api/v1/jobs/recordInfo で取得するか、callBackUrl を付けて通知を受け取ります。

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

画像から動画

minimax/h3-max/image-to-video

料金

オプションクレジット (出力 1 秒あたり)米ドル
480p7.5$0.075
768p12$0.12

パラメーター

フィールド型既定値指定できる値説明
image_url必須string (uri)——Opening frame. It fixes the composition and the subject the clip starts from.
prompt必須string—7,000 文字までDescribe what happens after the opening frame: the action, the camera, and the mood.
last_image_url任意string (uri)——Optional closing frame the clip should resolve to. It may only be sent together with an opening frame.
duration_seconds任意integer85〜15Requested output length in seconds, from 5 to 15.
resolution任意string768p480p, 768pOutput resolution.
enable_prompt_expansion任意booleanfalse—Expand the prompt into a fuller description before generating. Requests with it on add a flat per-request prompt-expansion fee.

リクエスト例

このリクエストはそのまま実行できます。省略したフィールドには既定値が入ります。先にキーを環境変数 POPNOW_API_KEY に設定してください。

例の image_url には PopNow のサンプル素材を使っています。自分の公開 HTTPS リンク、アップロードしたファイル、保存済みアセットに置き換えてください。

POST /api/v1/jobs/createTask?wait=60
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "minimax/h3-max/image-to-video",
  "input": {
    "prompt": "He lands softly on the rooftop, laughs and turns toward the camera while the balloons sway in the evening breeze; slow push-in",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "enable_prompt_expansion": false,
    "resolution": "768p",
    "duration_seconds": 8
  }
}'

レスポンスにはすぐに taskId が入ります。結果は GET /api/v1/jobs/recordInfo で取得するか、callBackUrl を付けて通知を受け取ります。

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

動画を延長

minimax/h3-max/video-extend

料金

オプションクレジット (出力 1 秒あたり)米ドル
480p7.5$0.075
768p12$0.12

パラメーター

フィールド型既定値指定できる値説明
prompt必須string—7,000 文字までDescribe what happens next: the action that follows, the camera move and the sound.
video_url必須string (uri)——The clip to continue: MP4, MOV or WebM, up to 60 seconds. Its last frame opens the new segment, and the result is your clip with the new segment joined on.
last_image_url任意string (uri)——Optional target end frame: the new segment closes on this image.
duration_seconds任意integer85〜15Length of the new segment in seconds, from 5 to 15. The source clip is added on top and is not billed.
resolution任意string768p480p, 768pResolution of the new segment. It sets how sharp the new part is generated; match your source clip.
enable_prompt_expansion任意booleanfalse—Expand the prompt into a fuller description before generating. Requests with it on add a flat per-request prompt-expansion fee.

リクエスト例

このリクエストはそのまま実行できます。省略したフィールドには既定値が入ります。先にキーを環境変数 POPNOW_API_KEY に設定してください。

例の video_url には PopNow のサンプル素材を使っています。自分の公開 HTTPS リンク、アップロードしたファイル、保存済みアセットに置き換えてください。

POST /api/v1/jobs/createTask
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: $(uuidgen)" \
  -d '{
  "model": "minimax/h3-max/video-extend",
  "input": {
    "prompt": "The flowers keep opening while the camera slowly pulls back to reveal a sunlit meadow",
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "enable_prompt_expansion": false,
    "resolution": "768p",
    "duration_seconds": 8
  }
}'

レスポンスにはすぐに taskId が入ります。結果は GET /api/v1/jobs/recordInfo で取得するか、callBackUrl を付けて通知を受け取ります。

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

次に読む

このページの内容