動画生成

非同期ジョブで動画を作る /v1/videos の使い方です。

対応モデル

動画生成は /v1/videos です。テキスト生成とは別サーフェスのため、これらのモデル ID は GET /v1/models には含まれません(GET /v1/videos/models で対応モデルと単価を確認できます)。トライアルキーは対象外です(本番モデル + 有料キー)。

モデル IDモデル名仕様
minimax-h3MiniMax H3解像度 2K / 長さ 5〜15 秒 / 音声あり(既定 ON)
アスペクト比 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16
参照画像 最大 2 枚
精度 INT8
利用モデル MiniMaxAI/MiniMax-H3

出力サイズはアスペクト比で決まります。

アスペクト比出力サイズ(px)
21:93072×1344
16:92688×1536
4:32048×1536
1:11536×1536
3:41536×2048
9:161536×2688

生成の流れ

生成は分単位の非同期ジョブです(5 秒の動画で 10〜13 分ほど。混雑時はさらに時間がかかります)。POST /v1/videos が 202 でジョブ ID を返し、GET /v1/videos/{id} で完了を確認してから GET /v1/videos/{id}/content で mp4 を取得します。OpenAI Video API 互換の形なので、OpenAI SDK の videos.create / videos.retrieve / videos.download_content がそのまま使えます。

curl https://api.router.hello.ai/v1/videos \
  -H "Authorization: Bearer hello_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3",
    "prompt": "A product spin on a clean white table, soft studio light",
    "seconds": 5,
    "aspect_ratio": "16:9"
  }'
# 完了確認(status が completed になるまで繰り返す)
curl https://api.router.hello.ai/v1/videos/<id> \
  -H "Authorization: Bearer hello_..."

# mp4 の取得
curl -L https://api.router.hello.ai/v1/videos/<id>/content \
  -H "Authorization: Bearer hello_..." \
  -o out.mp4
import time
from openai import OpenAI

client = OpenAI(
    base_url="https://api.router.hello.ai/v1",
    api_key="hello_...",
)

video = client.videos.create(
    model="minimax-h3",
    prompt="A product spin on a clean white table",
    seconds="5",
)
while video.status in ("pending", "in_progress"):
    time.sleep(30)
    video = client.videos.retrieve(video.id)

client.videos.download_content(video.id).write_to_file("out.mp4")

パラメータ

パラメータ内容
prompt生成内容のテキスト(必須)
seconds尺(整数秒。文字列も可)。省略時は最短尺。duration も同義で受け付けます
aspect_ratio上の表のアスペクト比から選びます(省略時 16:9)
input_reference先頭フレームの画像 1 枚。画像ファイル(multipart)または data:image/...;base64, の data URL。frame_images の first_frame とは併用できません
frame_images開始・終了フレームの指定({ "type": "first_frame" | "last_frame", "image_url": "…" })。image_url は data URL のみ。first_frame / last_frame は各 1 枚まで
resolution2K のみ。省略可
generate_audio音声トラックを含めるか(既定 true)。false のとき mp4 は映像トラックだけになります

仕様と課金

  • 参照画像の枚数は frame_images と input_reference の合計で数えます。上の表の上限を超えると 400 です。画像は合計 750KB までで、https URL は受け付けません(400)。
  • input_references は非対応です(指定すると 400)。
  • seed は非対応です(指定すると 400)。解像度は 2K 固定(出力サイズは上の表)で、size は受け付けません。
  • 課金は秒単価と参照画像の枚数で決まります(トークン課金ではないため、利用履歴の入力 / 出力トークンは 0 です)。単価は料金をご覧ください。
  • 投入時に見積り全額をクレジットから予約します。残高不足の場合は 402 で送信しません。完了時に実額で精算し、失敗・期限切れのジョブは課金せず予約を全額解放します。
  • /content は完了前に呼ぶと 409 です。レスポンスは Content-Type: video/mp4 固定で、保持期限は GET /v1/videos/{id} の expires_at(UNIX 秒)で確認できます。期限が切れる前に取得・保存してください。
  • mp4 には「AI で生成した動画である」ことを示すメタデータ(comment フィールドに {"generated_by":"HAI","ai_generated":true})が入る場合があります。映像に焼き付く透かしやロゴはありません。