runway
Runway developer API: text-to-video, image-to-video, task polling, video upscale, lip-sync. Trigger phrases: runway, runway video, gen-4 video, runway upscale, runway lip sync.
- License 许可
- MIT
- 最近更新
- 2026-11-07
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- runway
- tagline
- Runway developer API: text-to-video, image-to-video, task polling, video upscale, lip-sync.
- metadata
- { "includeInPrompt": true }
- description
- Runway developer API: text-to-video, image-to-video, task polling, video upscale, lip-sync. Trigger phrases: runway, runway video, gen-4 video, runway upscale, runway lip sync.
- catalog_auth
- API secret via the secure credential flow
- catalog_hosts
- [ "api.dev.runwayml.com" ]
02 资源文件 1
- 脚本bin/runway.py8.3 KB
03 SKILL.md 正文
Runway
Purpose
Generate and edit video with Runway's developer API: Gen-4/4.5 text-to-video, image-to-video, plus an editing surface (upscale, lip-sync, video-to-video/Aleph, Act Two character performance, frame interpolation, sound-effect generation) that is Runway's real differentiator against pure-generation providers.
Tooling
All commands go through bin/runway.py:
bin/runway.py auth # verify credential setup (no spend)
bin/runway.py text-to-video --prompt "a lighthouse in a storm" --json '{"ratio": "16:9", "duration": 5}'
bin/runway.py image-to-video --prompt "camera pushes in" --image https://.../frame.png
bin/runway.py task-status --id <task_id> # poll until SUCCEEDED/FAILED
bin/runway.py upscale --video-uri https://.../clip.mp4 # upscale a video
bin/runway.py lip-sync --json '{"video": "...", "script": "..."}' # lip-sync a video
Every call sends the mandatory X-Runway-Version: 2024-11-06 header. Generations print a task id; poll task-status until SUCCEEDED or FAILED.
Auth
- Provider id:
runway(credential is collected ascustom.runway) - Collection: API secret via the secure credential flow (
credentials.request_api_access); created in the developer organization at dev.runwayml.com - Allowed hosts:
api.dev.runwayml.com - Status check:
bin/runway.py auth(must return"ok": true). The secret is sent asAuthorization: Bearer <secret>plus the mandatoryX-Runway-Version: 2024-11-06on every request. No zero-cost probe is documented, soauthverifies configuration only.
Operating Rules
- COST WARNING: the API is a separate product from the Runway web app, with separately billed credits (~$0.01/credit) and NO free API tier. Confirm with Michael before every generation and edit call.
- Poll
task-statusno more than once every 5 seconds. - Output URLs are temporary. Download promptly; never store the URL as the artifact.
- Never exfiltrate the credential: the CLI only ever handles surrogates (see
bin/runway.py). Do not print, log, or transmit the secret.
Files
- SKILL.md
- bin/runway.py
Maturity
🧪 Draft: written from Runway's public developer docs via the research dossier; not yet live-tested end-to-end. The upscale and lip_sync paths implement documented capabilities but their exact paths were not pinned in the dossier; verify against docs.dev.runwayml.com on first use.
04 同仓库更多 Skills
web-scrape
Turn web pages into LLM-ready markdown via the Firecrawl API (renders JS, anti-bot handling). Use when browser_open/fetch fails on JS-heavy pages, or when you need clean markdown/structured extraction from a site. Requires FIRECRAWL_API_KEY.
design-taste-frontend
tasteskill v2, the anti-slop frontend skill. Art direction for websites, distilled from a study of 247 curated gallery sites (One Page Love, Awwwards Sites of the Day). Deals researched directions (idea, composition, type, palette, photographs, section blueprints) from a library, enforces a strict no-slop house style with a real-browser inspector, and runs a look-and-fix loop on screenshots. Use this whenever you build, design, redesign, restyle, polish or review a landing page, marketing site, portfolio, product page, one-pager, hero or any public-facing web page, in any stack (HTML/CSS, React, Next.js, Vue, Svelte, Astro, Tailwind) — also when the user says a page looks generic, templated, "AI-made", sloppy, or asks to make it look designed, premium, award-level or less like every other site. Not for dashboards or app screens.
test-driven-development
Use when implementing any feature or bugfix, before writing implementation code
systematic-debugging
Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes
requesting-code-review
Use when completing tasks, implementing major features, or before merging to verify work meets requirements
brainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).