Runway Gen-4.5 API 怎么用？5 分钟跑通第一条视频

TL;DR

• Runway Gen-4.5 是 Runway 的视频模型，HiAPI 上有文生视频和图生视频两个入口，打开模型页就能在线试，新用户注册送 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 秒三档：8 秒刚好走完一次推镜、环绕或缓慢上升。
• 固定 720p：横屏 1280×720，竖屏 720×1280，不用选分辨率。
• 图生视频有 5 种画幅：16:9、9:16、4:3、3:4、1:1，同一张图能出不同平台的版本。
• 成片没有音轨：画面交给模型，声音在剪辑时统一加。

VIDEO

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。首帧：窗边人像原图。

她从侧脸转向镜头露出笑容，发丝轻动，镜头一路推到脸部特写。提示词只写了动作和运镜，人物外貌和窗边的光全来自首帧。

两个入口怎么选

两个入口同价，都是每秒 $0.1715。

两条上手路线

在浏览器里试（3 步）

1. 打开文生视频或图生视频模型页并登录。
2. 写提示词；图生视频先传一张首帧。
3. 选 5 秒和画幅，点运行。

用 API 调（3 步）

1. 在控制台的 API Key 页面创建密钥，放进环境变量 HIAPI_KEY。
2. POST https://api.hiapi.ai/v1/tasks 提交，返回 data.taskId。
3. 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。成片是这样的：

VIDEO

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)

参数表

没有 resolution、seed、negative_prompt，也没有尾帧。

你会遇到的报错

提交时参数不对，接口直接返回 400，不建任务、不扣钱：

• duration: value must be one of 5, 10：文生视频选了 9:16 又传了 8 秒。
• duration: value must be one of 5, 8, 10：时长只有这三档。
• image_urls: maxItems: got 2, want 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：这两个字段在 Runway Gen-4.5 上不存在。

上线前注意

• 用回调代替轮询：请求顶层（和 input 同级）加 "callback": {"url": "https://你的域名/hiapi/callback"}，按 taskId 去重。
• 及时转存：output[0].url 约 7 天后失效，拿到就存到自己的存储。
• 显式写 duration 和 aspect_ratio：竖屏文生视频要避开 8 秒，写死在代码里最稳。
• 重试带幂等键：请求头加 Idempotency-Key，同一个键只建一次任务。

常见问题

能出 1080p 或 4K 吗？

不能，输出固定 720p。要 1080p 可以用 Kling 2.5 Turbo，对照看 Runway Gen-4.5 和 Kling 2.5 Turbo 对比。

成片有声音吗？

没有，输出只有画面。配乐、音效和口播在剪辑时加。

图生视频能加尾帧吗？

不能，image_urls 只收一张。要用尾帧控制结尾，用 Kling 2.5 Turbo 图生视频。

首帧比例和画幅不一样会怎样？

首帧按所选画幅居中裁切，主体放在中间最稳。

价格明细看 Runway Gen-4.5 API 价格，更多场景看 Runway Gen-4.5 提示词大全。想先看效果，复制上面的灯塔提示词，去模型页生成第一条。