使用ガイド

Runway Gen-4.5 API の使い方？5 分で最初の動画を生成

テキスト生成と画像生成の 2 つの入口の選び方、curl と Python のサンプル、完全なパラメータ表とよくあるエラー。

Oct 19, 2026

TL;DR

Runway Gen-4.5 は Runway の動画モデルで、HiAPI にはテキストから動画と画像から動画の 2 つの入口があり、モデルページを開くとオンラインで試せます。新規ユーザー登録で 200 クレジットが付与されます。
どちらの入口も毎秒 $0.1715：5 秒 $0.8575、8 秒 $1.372、10 秒 $1.715。
呼び出し方法：POST /v1/tasks で送信し、taskId を取得して結果を確認、完成動画は output[0].url にあります。

Runway Gen-4.5 でできること

5、8、10 秒の 3 段階：8 秒はプッシュイン、周回、ゆっくりした上昇をちょうど 1 回こなせます。
固定 720p：横画面 1280×720、縦画面 720×1280。解像度は選ぶ必要がありません。
画像から動画は 5 種類のアスペクト比：16:9、9:16、4:3、3:4、1:1。同じ画像から各プラットフォーム向けのバージョンを作れます。
完成動画に音声トラックはなし：映像はモデルに任せ、音声は編集時にまとめて付けます。

She turns her head toward the camera and smiles, hair moves in a light breeze, slow push-in

このプロンプトで生成 →（人物の最初のフレームをアップロードし、5 秒、3:4 を選択）

runway-gen-4.5/image-to-video、3:4、832×1104、5 秒、$0.8575。最初のフレーム：。

彼女が横顔からカメラの方を向いて微笑み、髪が軽く動き、カメラが顔のアップまで一気に寄っていきます。プロンプトには動作とカメラワークだけを書き、人物の外見や窓辺の光はすべて最初のフレームに由来します。

2 つの入口の選び方

モデル ID	入力	長さ	アスペクト比	向いている用途
`runway-gen-4.5/text-to-video`	プロンプト	5 / 8 / 10 秒（9:16 は 5 / 10 のみ）	16:9、9:16	素材がなく、テキストから始める
`runway-gen-4.5/image-to-video`	最初のフレーム 1 枚 + プロンプト	5 / 8 / 10 秒	16:9、9:16、4:3、3:4、1:1	被写体を元画像と一致させたい、または正方形・4:3・3:4 が必要

どちらの入口も同価格で、いずれも毎秒 $0.1715。

2 つの始め方

ブラウザで試す（3 ステップ）

テキストから動画または画像から動画のモデルページを開いてログインします。
プロンプトを書きます。画像から動画の場合は先に最初のフレームを 1 枚アップロードします。
5 秒とアスペクト比を選び、実行をクリックします。

API で呼び出す（3 ステップ）

コンソールの API Key ページでキーを作成し、環境変数 HIAPI_KEY に設定します。
POST https://api.hiapi.ai/v1/tasks で送信し、data.taskId が返ります。
GET /v1/tasks/{taskId} で status が success になるのを確認し、output[0].url をダウンロードします。

curl：最初の動画

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "runway-gen-4.5/text-to-video",
    "input": {
      "prompt": "A lone stone lighthouse on a rugged sea cliff at dusk, heavy waves crashing against the rocks, the lamp beam sweeping across dark storm clouds, slow cinematic push-in, drifting sea mist, dramatic lighting",
      "duration": 5,
      "aspect_ratio": "16:9"
    }
  }'

5 秒、16:9、$0.8575。完成動画はこちらです：

A lone stone lighthouse on a rugged sea cliff at dusk, heavy waves crashing against the rocks, the lamp beam sweeping across dark storm clouds, slow cinematic push-in, drifting sea mist, dramatic lighting

このプロンプトで生成 →（5 秒、16:9 を選択）

runway-gen-4.5/text-to-video、16:9、1280×720、5 秒、$0.8575。

Python：送信、ポーリング、ダウンロード

# pip install requests；先 export HIAPI_KEY=你的 Key
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(model, timeout_s=900, **inp):
    # 重试同一个任务时带同一个 Idempotency-Key，避免重复扣费
    r = requests.post(API, json={"model": model, "input": inp},
                      headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    r.raise_for_status()
    task_id = r.json()["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

# 图生视频：同一张图出 1:1 版本，8 秒（$1.372）
url = generate(
    "runway-gen-4.5/image-to-video",
    prompt="The scene slowly comes alive: clouds drift, light shifts across the mountain lake, gentle forward camera move",
    image_urls=["https://你的图床/lake.jpg"],
    duration=8, aspect_ratio="1:1",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

パラメータ表

フィールド	必須	値	説明
`prompt`	はい	1–1000 文字	被写体、動作、カメラワークを書く。画像から動画では動作とカメラワークのみ
`duration`	いいえ	`5`（デフォルト）/ `8` / `10`	テキストから動画の 9:16 は `5` / `10` のみ
`aspect_ratio`	いいえ	テキスト：`16:9`（デフォルト）`9:16`；画像：`16:9`（デフォルト）`9:16` `4:3` `3:4` `1:1`	画像から動画の最初のフレームはアスペクト比に合わせて中央でクロップ
`image_urls`	画像から動画では必須	1 枚のみ、jpeg/png/webp、≤10MB	最初のフレーム。テキストから動画ではこのフィールドを受け付けない

resolution、seed、negative_prompt はなく、最後のフレームもありません。

遭遇するエラー

送信時にパラメータが正しくない場合、API は直接 400 を返し、タスクは作成されず課金もされません：

duration: value must be one of 5, 10：テキストから動画で 9:16 を選び、さらに 8 秒を指定した。
duration: value must be one of 5, 8, 10：長さはこの 3 段階のみ。
image_urls: maxItems: got 2, want 1：画像から動画は最初のフレーム 1 枚のみ受け付け、最後のフレームは非対応。
image_urls: missing required field "image_urls"：画像から動画で最初のフレームを送信していない。
prompt: maxLength: got 3,000, want 1,000：プロンプトは最大 1000 文字。
additional properties 'negative_prompt', 'cfg_scale' not allowed：この 2 つのフィールドは Runway Gen-4.5 には存在しません。

公開前の注意

ポーリングの代わりにコールバックを使う：リクエストのトップレベル（input と同じ階層）に "callback": {"url": "https://你的域名/hiapi/callback"} を追加し、taskId で重複排除します。
速やかに転送保存：output[0].url は約 7 日で失効するため、取得したらすぐに自分のストレージへ保存します。
duration と aspect_ratio を明示的に書く：縦画面のテキストから動画では 8 秒を避け、コードに固定するのが最も確実です。
リトライには冪等キーを付ける：リクエストヘッダーに Idempotency-Key を追加し、同じキーではタスクが 1 回だけ作成されます。

よくある質問

1080p や 4K は出力できますか？

できません。出力は固定で 720p です。1080p が必要なら Kling 2.5 Turbo が使えます。比較はRunway Gen-4.5 と Kling 2.5 Turbo の比較をご覧ください。

完成動画に音声はありますか？

ありません。出力は映像のみです。BGM、効果音、ナレーションは編集時に追加します。

画像から動画で最後のフレームを追加できますか？

できません。image_urls は 1 枚のみ受け付けます。最後のフレームで結末を制御したい場合は、Kling 2.5 Turbo の画像から動画を使ってください。

最初のフレームの比率とアスペクト比が違うとどうなりますか？

最初のフレームは選択したアスペクト比に合わせて中央でクロップされます。被写体を中央に置くのが最も確実です。

価格の詳細はRunway Gen-4.5 API の価格、その他のシーンはRunway Gen-4.5 プロンプト大全をご覧ください。まず効果を見たい方は、上記の灯台のプロンプトをコピーして、モデルページで最初の 1 本を生成してください。

タグRunway api-guide 動画生成 API チュートリアル動画生成

すべての記事を見る →