SuperAPI AI 工具集

runway-hello-world

设计与创作

查看项目

更新于 10-15 23:29

技能介绍

用途:作为 Runway 平台的入门示例,指导用户从文本提示生成第一段 AI 视频,适用于视频生成、图像编辑或创意 AI 相关场景。

前提条件:已先完成 runway-install-auth;Runway 账户中拥有可用 API 额度。

主要能力与用法:

  1. 文生视频:通过 runwayml 库的 RunwayML 客户端创建 image_to_video 任务,指定模型 model='gen3a_turbo'、prompt_text 提示词、duration(5 或 10 秒)、ratio(16:9 或 9:16),并打印 task.id。
  2. 轮询完成状态:可用 client.tasks.retrieve(task.id) 手动轮询,循环中 time.sleep(5),直到状态为 SUCCEEDED 或 FAILED;成功时输出 task_result.output[0] 作为视频 URL。
  3. 下载视频:用 urllib.request.urlretrieve(video_url, 'output.mp4') 将结果保存到本地。
  4. 内置等待助手:也可直接调用 task.wait_for_task_output(),SDK 自动轮询,默认超时 10 分钟。

输出结果:创建视频生成任务、轮询至完成、获取生成视频 URL、下载视频到本地文件。

错误处理:任务 FAILED 多因内容策略违规,需调整提示词;402 表示额度不足,需在 dev.runwayml.com 充值;超时可增大超时或缩短时长;输出质量低多因提示词模糊,可加入 cinematic、4K、professional 等风格关键词。

限制:需账户有 API 额度;受内容策略约束;生成耗时可能超时;资料未提供收费标准、平台兼容性等更多信息。更高级的文生视频流程参见 runway-core-workflow-a。