PopNowAPI ドキュメント
本文

MiniMax H3 Singularity LoRA API リファレンス

コミュニティ調整のH3動画。自分のLoRAを読み込める

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

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

概要

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

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

画像から動画

minimax/h3-singularity-lora/image-to-video

料金

オプションクレジット (出力 1 秒あたり)米ドル
480p9.38$0.0938
540p14.06$0.1406
768p18.75$0.1875
1080p37.5$0.375

パラメーター

フィールド型既定値指定できる値説明
prompt必須string—7,000 文字までDescribe what happens after the opening frame: the action, the camera and the sound.
image_url必須string (uri)——Opening frame. The clip starts from this image and keeps its aspect ratio.
last_image_url任意string (uri)——Optional closing frame the clip should resolve to.
resolution任意string480p480p, 540p, 768p, 1080pOutput resolution.
duration_seconds任意integer53〜15Requested output length in whole seconds, from 3 to 15.
loras任意array<object>[]3 件までUp to three LoRA weight files trained for MiniMax H3, each with its own strength.
seed任意integer—0〜2147483647Random seed for controlled comparisons.

リクエスト例

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

例の image_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-singularity-lora/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",
    "duration_seconds": 5,
    "resolution": "480p"
  }
}'

レスポンスにはすぐに 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-singularity-lora/reference-to-video

料金

オプションクレジット (出力 1 秒あたり)米ドル
480p9$0.09
540p13.5$0.135
768p20.25$0.2025
1080p40.5$0.405

パラメーター

フィールド型既定値指定できる値説明
prompt必須string—7,000 文字までRefer to the references by number and describe the shot they should produce, including the sound.
reference_image_urls任意array<string (uri)>—9 件までReference images, up to nine. Each one adds a per-reference charge.
reference_video_urls任意array<string (uri)>—3 件までReference videos, up to three and 15 seconds in total. Their seconds are billed like output seconds.
reference_audio_urls任意array<string (uri)>—3 件までReference audio clips, up to three. Each one adds a per-reference charge.
aspect_ratio任意string16:916:9, 9:16, 1:1, 4:3, 3:4, 21:9, 9:21Output aspect ratio.
resolution任意string480p480p, 540p, 768p, 1080pOutput resolution.
duration_seconds任意integer53〜15Requested output length in whole seconds, from 3 to 15.
loras任意array<object>[]3 件までUp to three LoRA weight files trained for MiniMax H3, each with its own strength.
seed任意integer—0〜2147483647Random seed for controlled comparisons.

リクエスト例

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

例の reference_image_urls には 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-singularity-lora/reference-to-video",
  "input": {
    "prompt": "The man from the reference image jogs across a sunlit rooftop at golden hour and smiles at the camera; smooth tracking shot",
    "reference_image_urls": [
      "https://media.popnow.ai/influencer/examples/ava.webp"
    ],
    "duration_seconds": 5,
    "resolution": "480p"
  }
}'

レスポンスにはすぐに 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-singularity-lora/video-extend

料金

オプションクレジット (出力 1 秒あたり)米ドル
480p9.38$0.0938
540p14.06$0.1406
768p18.75$0.1875
1080p37.5$0.375

パラメーター

フィールド型既定値指定できる値説明
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 comes to rest on this picture.
resolution任意string480p480p, 540p, 768p, 1080pResolution of the new segment. Match your source clip; it sets how sharp the new part is generated.
duration_seconds任意integer53〜15Length of the new segment in whole seconds, from 3 to 15. The source clip is added on top and is not billed.
loras任意array<object>[]3 件までUp to three LoRA weight files trained for MiniMax H3, each with its own strength, applied to the new segment. Reuse the ones used for the source clip to keep the style consistent.
seed任意integer—0〜2147483647Random seed for controlled comparisons.

リクエスト例

このリクエストはそのまま実行できます。省略したフィールドには既定値が入ります。先にキーを環境変数 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-singularity-lora/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",
    "duration_seconds": 5,
    "resolution": "480p"
  }
}'

レスポンスにはすぐに 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"

次に読む

このページの内容