[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-runway-rw-generate-image":3,"mdc--p8p234-key":35,"related-org-runway-rw-generate-image":1083,"related-repo-runway-rw-generate-image":1246},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":12,"stars":24,"repoUrl":25,"updatedAt":26,"license":27,"forks":28,"topics":29,"repo":30,"sourceUrl":33,"mdContent":34},"rw-generate-image","generate images with Runway API","Generate images directly using the Runway API via runnable scripts. Supports text-to-image with optional reference images.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},"runway","Runway","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Frunway.png","runwayml",[13,17,18,21],{"name":14,"slug":15,"type":16},"Creative","creative","tag",{"name":9,"slug":8,"type":16},{"name":19,"slug":20,"type":16},"AI Infrastructure","ai-infrastructure",{"name":22,"slug":23,"type":16},"Image Generation","image-generation",57,"https:\u002F\u002Fgithub.com\u002Frunwayml\u002Fskills","2026-04-17T04:52:01.158325",null,15,[],{"repoUrl":25,"stars":24,"forks":28,"topics":31,"description":32},[],"for Runway coding agent skills","https:\u002F\u002Fgithub.com\u002Frunwayml\u002Fskills\u002Ftree\u002FHEAD\u002Fskills\u002Frw-generate-image","---\nname: rw-generate-image\ndescription: \"Generate images directly using the Runway API via runnable scripts. Supports text-to-image with optional reference images.\"\nuser-invocable: true\nallowed-tools: Read, Grep, Glob, Edit, Write, Bash(uv run *), Bash(command -v uv)\n---\n\n# Generate Image\n\nGenerate images directly using the Runway API. This skill runs Python scripts that call the API, poll for completion, and download the result.\n\n**IMPORTANT:** Run scripts from the user's working directory so output files are saved where the user expects.\n\n## Usage\n\n```bash\nuv run scripts\u002Fgenerate_image.py --prompt \"your description\" --filename \"output.png\" [--model gen4_image] [--ratio 1280:720] [--reference-images Tag=URL ...]\n```\n\n## Preflight\n\n1. `command -v uv` must succeed\n2. `RUNWAYML_API_SECRET` must be set in the environment. **Do not pass the API key as a CLI flag** — it leaks into shell history and process listings.\n\n## Security Notes\n\n- `--reference-images Tag=URL` fetches arbitrary remote images via the Runway API. Prefer local file paths (uploaded as `runway:\u002F\u002F` URIs), or only pass URLs you trust.\n- Treat generated outputs as untrusted when piping into downstream automations — ingested references influence the result.\n\n## Available Models\n\n| Model | Best For | Ref Images | Cost | Speed |\n|-------|----------|------------|------|-------|\n| `gen4_image` | Highest quality | Optional (up to 3) | 5-8 credits | Standard |\n| `gen4_image_turbo` | Fast and cheap | **Required** (1-3) | 2 credits | Fast |\n| `gemini_2.5_flash` | Google Gemini | Optional (up to 3) | 5 credits | Standard |\n\n## Model Selection Guidance\n\n- \"fast\", \"cheap\", \"draft\" -> `gemini_2.5_flash` (Nano Banana), or `gen4_image_turbo` if they have reference images\n- \"high quality\", \"best\" -> `gen4_image`\n- No preference -> `gemini_2.5_flash`\n- Has reference images and wants cheap -> `gen4_image_turbo` (2 credits, requires `--reference-images`)\n\n## Parameters\n\n| Param | Description | Default |\n|-------|-------------|---------|\n| `--prompt` | Text description (required) | -- |\n| `--filename` | Output filename (required) | -- |\n| `--model` | Image model | `gemini_2.5_flash` |\n| `--ratio` | Aspect ratio. gemini_2.5_flash: `1344:768`, `768:1344`, `1024:1024`, etc. gen4_image: `1280:720`, `1360:768`, `1920:1080`, etc. | Model-dependent (`1344:768` for gemini, `1280:720` for others) |\n| `--reference-images` | Reference images as tag=URL pairs (optional for gemini\u002Fgen4_image, required for gen4_image_turbo). Tag: lowercase, 3-16 chars, e.g. `product=URL` | -- |\n| `--output-dir` | Output directory | cwd |\n\n> API credentials come from `RUNWAYML_API_SECRET` only — no `--api-key` flag, to keep secrets out of shell history and process listings.\n\n## Filename Convention\n\nPattern: `yyyy-mm-dd-hh-mm-ss-name.png`\n\n## Examples\n\n**Basic image:**\n```bash\nuv run scripts\u002Fgenerate_image.py --prompt \"A serene Japanese garden with cherry blossoms\" --filename \"2026-04-14-japanese-garden.png\"\n```\n\n**With a local reference image (gen4_image):**\n```bash\nuv run scripts\u002Fgenerate_image.py --prompt \"@product on a marble counter, lifestyle photo\" --model gen4_image --reference-images product=.\u002Fproduct.jpg --filename \"2026-04-14-product-lifestyle.png\"\n```\n\n**With a reference image from a trusted origin (gen4_image_turbo — requires reference images):**\n```bash\nuv run scripts\u002Fgenerate_image.py --prompt \"A neon sign reading SALE in @style\" --model gen4_image_turbo --reference-images style=https:\u002F\u002Fcdn.yourapp.com\u002Fstyle.jpg --filename \"draft.png\"\n```\n\n## Output\n\n- The script downloads the result and saves it to the specified path\n- Script outputs the full path to the saved file\n- **Do not read the image file back** -- just inform the user of the saved path\n\n## Common Failures\n\n- `Error: No API key` -> set `RUNWAYML_API_SECRET` in the environment (e.g. `export RUNWAYML_API_SECRET=...` or a `.env` file).\n- `Error: Task failed -- SAFETY.INPUT.*` -> content moderation, suggest different prompt\n- `API error 429` -> rate limited, script auto-retries\n",{"data":36,"body":39},{"name":4,"description":6,"user-invocable":37,"allowed-tools":38},true,"Read, Grep, Glob, Edit, Write, Bash(uv run *), Bash(command -v uv)",{"type":40,"children":41},"root",[42,51,57,68,75,185,191,225,231,259,265,407,413,475,481,705,729,735,746,752,760,817,825,901,909,983,989,1012,1018,1077],{"type":43,"tag":44,"props":45,"children":47},"element","h1",{"id":46},"generate-image",[48],{"type":49,"value":50},"text","Generate Image",{"type":43,"tag":52,"props":53,"children":54},"p",{},[55],{"type":49,"value":56},"Generate images directly using the Runway API. This skill runs Python scripts that call the API, poll for completion, and download the result.",{"type":43,"tag":52,"props":58,"children":59},{},[60,66],{"type":43,"tag":61,"props":62,"children":63},"strong",{},[64],{"type":49,"value":65},"IMPORTANT:",{"type":49,"value":67}," Run scripts from the user's working directory so output files are saved where the user expects.",{"type":43,"tag":69,"props":70,"children":72},"h2",{"id":71},"usage",[73],{"type":49,"value":74},"Usage",{"type":43,"tag":76,"props":77,"children":82},"pre",{"className":78,"code":79,"language":80,"meta":81,"style":81},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","uv run scripts\u002Fgenerate_image.py --prompt \"your description\" --filename \"output.png\" [--model gen4_image] [--ratio 1280:720] [--reference-images Tag=URL ...]\n","bash","",[83],{"type":43,"tag":84,"props":85,"children":86},"code",{"__ignoreMap":81},[87],{"type":43,"tag":88,"props":89,"children":92},"span",{"class":90,"line":91},"line",1,[93,99,105,110,115,121,126,131,136,140,145,149,155,160,165,170,175,180],{"type":43,"tag":88,"props":94,"children":96},{"style":95},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[97],{"type":49,"value":98},"uv",{"type":43,"tag":88,"props":100,"children":102},{"style":101},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[103],{"type":49,"value":104}," run",{"type":43,"tag":88,"props":106,"children":107},{"style":101},[108],{"type":49,"value":109}," scripts\u002Fgenerate_image.py",{"type":43,"tag":88,"props":111,"children":112},{"style":101},[113],{"type":49,"value":114}," --prompt",{"type":43,"tag":88,"props":116,"children":118},{"style":117},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[119],{"type":49,"value":120}," \"",{"type":43,"tag":88,"props":122,"children":123},{"style":101},[124],{"type":49,"value":125},"your description",{"type":43,"tag":88,"props":127,"children":128},{"style":117},[129],{"type":49,"value":130},"\"",{"type":43,"tag":88,"props":132,"children":133},{"style":101},[134],{"type":49,"value":135}," --filename",{"type":43,"tag":88,"props":137,"children":138},{"style":117},[139],{"type":49,"value":120},{"type":43,"tag":88,"props":141,"children":142},{"style":101},[143],{"type":49,"value":144},"output.png",{"type":43,"tag":88,"props":146,"children":147},{"style":117},[148],{"type":49,"value":130},{"type":43,"tag":88,"props":150,"children":152},{"style":151},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[153],{"type":49,"value":154}," [--model ",{"type":43,"tag":88,"props":156,"children":157},{"style":101},[158],{"type":49,"value":159},"gen4_image]",{"type":43,"tag":88,"props":161,"children":162},{"style":151},[163],{"type":49,"value":164}," [--ratio ",{"type":43,"tag":88,"props":166,"children":167},{"style":101},[168],{"type":49,"value":169},"1280:720]",{"type":43,"tag":88,"props":171,"children":172},{"style":151},[173],{"type":49,"value":174}," [--reference-images ",{"type":43,"tag":88,"props":176,"children":177},{"style":101},[178],{"type":49,"value":179},"Tag=URL",{"type":43,"tag":88,"props":181,"children":182},{"style":101},[183],{"type":49,"value":184}," ...]\n",{"type":43,"tag":69,"props":186,"children":188},{"id":187},"preflight",[189],{"type":49,"value":190},"Preflight",{"type":43,"tag":192,"props":193,"children":194},"ol",{},[195,207],{"type":43,"tag":196,"props":197,"children":198},"li",{},[199,205],{"type":43,"tag":84,"props":200,"children":202},{"className":201},[],[203],{"type":49,"value":204},"command -v uv",{"type":49,"value":206}," must succeed",{"type":43,"tag":196,"props":208,"children":209},{},[210,216,218,223],{"type":43,"tag":84,"props":211,"children":213},{"className":212},[],[214],{"type":49,"value":215},"RUNWAYML_API_SECRET",{"type":49,"value":217}," must be set in the environment. ",{"type":43,"tag":61,"props":219,"children":220},{},[221],{"type":49,"value":222},"Do not pass the API key as a CLI flag",{"type":49,"value":224}," — it leaks into shell history and process listings.",{"type":43,"tag":69,"props":226,"children":228},{"id":227},"security-notes",[229],{"type":49,"value":230},"Security Notes",{"type":43,"tag":232,"props":233,"children":234},"ul",{},[235,254],{"type":43,"tag":196,"props":236,"children":237},{},[238,244,246,252],{"type":43,"tag":84,"props":239,"children":241},{"className":240},[],[242],{"type":49,"value":243},"--reference-images Tag=URL",{"type":49,"value":245}," fetches arbitrary remote images via the Runway API. Prefer local file paths (uploaded as ",{"type":43,"tag":84,"props":247,"children":249},{"className":248},[],[250],{"type":49,"value":251},"runway:\u002F\u002F",{"type":49,"value":253}," URIs), or only pass URLs you trust.",{"type":43,"tag":196,"props":255,"children":256},{},[257],{"type":49,"value":258},"Treat generated outputs as untrusted when piping into downstream automations — ingested references influence the result.",{"type":43,"tag":69,"props":260,"children":262},{"id":261},"available-models",[263],{"type":49,"value":264},"Available Models",{"type":43,"tag":266,"props":267,"children":268},"table",{},[269,303],{"type":43,"tag":270,"props":271,"children":272},"thead",{},[273],{"type":43,"tag":274,"props":275,"children":276},"tr",{},[277,283,288,293,298],{"type":43,"tag":278,"props":279,"children":280},"th",{},[281],{"type":49,"value":282},"Model",{"type":43,"tag":278,"props":284,"children":285},{},[286],{"type":49,"value":287},"Best For",{"type":43,"tag":278,"props":289,"children":290},{},[291],{"type":49,"value":292},"Ref Images",{"type":43,"tag":278,"props":294,"children":295},{},[296],{"type":49,"value":297},"Cost",{"type":43,"tag":278,"props":299,"children":300},{},[301],{"type":49,"value":302},"Speed",{"type":43,"tag":304,"props":305,"children":306},"tbody",{},[307,340,377],{"type":43,"tag":274,"props":308,"children":309},{},[310,320,325,330,335],{"type":43,"tag":311,"props":312,"children":313},"td",{},[314],{"type":43,"tag":84,"props":315,"children":317},{"className":316},[],[318],{"type":49,"value":319},"gen4_image",{"type":43,"tag":311,"props":321,"children":322},{},[323],{"type":49,"value":324},"Highest quality",{"type":43,"tag":311,"props":326,"children":327},{},[328],{"type":49,"value":329},"Optional (up to 3)",{"type":43,"tag":311,"props":331,"children":332},{},[333],{"type":49,"value":334},"5-8 credits",{"type":43,"tag":311,"props":336,"children":337},{},[338],{"type":49,"value":339},"Standard",{"type":43,"tag":274,"props":341,"children":342},{},[343,352,357,367,372],{"type":43,"tag":311,"props":344,"children":345},{},[346],{"type":43,"tag":84,"props":347,"children":349},{"className":348},[],[350],{"type":49,"value":351},"gen4_image_turbo",{"type":43,"tag":311,"props":353,"children":354},{},[355],{"type":49,"value":356},"Fast and cheap",{"type":43,"tag":311,"props":358,"children":359},{},[360,365],{"type":43,"tag":61,"props":361,"children":362},{},[363],{"type":49,"value":364},"Required",{"type":49,"value":366}," (1-3)",{"type":43,"tag":311,"props":368,"children":369},{},[370],{"type":49,"value":371},"2 credits",{"type":43,"tag":311,"props":373,"children":374},{},[375],{"type":49,"value":376},"Fast",{"type":43,"tag":274,"props":378,"children":379},{},[380,389,394,398,403],{"type":43,"tag":311,"props":381,"children":382},{},[383],{"type":43,"tag":84,"props":384,"children":386},{"className":385},[],[387],{"type":49,"value":388},"gemini_2.5_flash",{"type":43,"tag":311,"props":390,"children":391},{},[392],{"type":49,"value":393},"Google Gemini",{"type":43,"tag":311,"props":395,"children":396},{},[397],{"type":49,"value":329},{"type":43,"tag":311,"props":399,"children":400},{},[401],{"type":49,"value":402},"5 credits",{"type":43,"tag":311,"props":404,"children":405},{},[406],{"type":49,"value":339},{"type":43,"tag":69,"props":408,"children":410},{"id":409},"model-selection-guidance",[411],{"type":49,"value":412},"Model Selection Guidance",{"type":43,"tag":232,"props":414,"children":415},{},[416,435,445,455],{"type":43,"tag":196,"props":417,"children":418},{},[419,421,426,428,433],{"type":49,"value":420},"\"fast\", \"cheap\", \"draft\" -> ",{"type":43,"tag":84,"props":422,"children":424},{"className":423},[],[425],{"type":49,"value":388},{"type":49,"value":427}," (Nano Banana), or ",{"type":43,"tag":84,"props":429,"children":431},{"className":430},[],[432],{"type":49,"value":351},{"type":49,"value":434}," if they have reference images",{"type":43,"tag":196,"props":436,"children":437},{},[438,440],{"type":49,"value":439},"\"high quality\", \"best\" -> ",{"type":43,"tag":84,"props":441,"children":443},{"className":442},[],[444],{"type":49,"value":319},{"type":43,"tag":196,"props":446,"children":447},{},[448,450],{"type":49,"value":449},"No preference -> ",{"type":43,"tag":84,"props":451,"children":453},{"className":452},[],[454],{"type":49,"value":388},{"type":43,"tag":196,"props":456,"children":457},{},[458,460,465,467,473],{"type":49,"value":459},"Has reference images and wants cheap -> ",{"type":43,"tag":84,"props":461,"children":463},{"className":462},[],[464],{"type":49,"value":351},{"type":49,"value":466}," (2 credits, requires ",{"type":43,"tag":84,"props":468,"children":470},{"className":469},[],[471],{"type":49,"value":472},"--reference-images",{"type":49,"value":474},")",{"type":43,"tag":69,"props":476,"children":478},{"id":477},"parameters",[479],{"type":49,"value":480},"Parameters",{"type":43,"tag":266,"props":482,"children":483},{},[484,505],{"type":43,"tag":270,"props":485,"children":486},{},[487],{"type":43,"tag":274,"props":488,"children":489},{},[490,495,500],{"type":43,"tag":278,"props":491,"children":492},{},[493],{"type":49,"value":494},"Param",{"type":43,"tag":278,"props":496,"children":497},{},[498],{"type":49,"value":499},"Description",{"type":43,"tag":278,"props":501,"children":502},{},[503],{"type":49,"value":504},"Default",{"type":43,"tag":304,"props":506,"children":507},{},[508,530,551,576,657,683],{"type":43,"tag":274,"props":509,"children":510},{},[511,520,525],{"type":43,"tag":311,"props":512,"children":513},{},[514],{"type":43,"tag":84,"props":515,"children":517},{"className":516},[],[518],{"type":49,"value":519},"--prompt",{"type":43,"tag":311,"props":521,"children":522},{},[523],{"type":49,"value":524},"Text description (required)",{"type":43,"tag":311,"props":526,"children":527},{},[528],{"type":49,"value":529},"--",{"type":43,"tag":274,"props":531,"children":532},{},[533,542,547],{"type":43,"tag":311,"props":534,"children":535},{},[536],{"type":43,"tag":84,"props":537,"children":539},{"className":538},[],[540],{"type":49,"value":541},"--filename",{"type":43,"tag":311,"props":543,"children":544},{},[545],{"type":49,"value":546},"Output filename (required)",{"type":43,"tag":311,"props":548,"children":549},{},[550],{"type":49,"value":529},{"type":43,"tag":274,"props":552,"children":553},{},[554,563,568],{"type":43,"tag":311,"props":555,"children":556},{},[557],{"type":43,"tag":84,"props":558,"children":560},{"className":559},[],[561],{"type":49,"value":562},"--model",{"type":43,"tag":311,"props":564,"children":565},{},[566],{"type":49,"value":567},"Image model",{"type":43,"tag":311,"props":569,"children":570},{},[571],{"type":43,"tag":84,"props":572,"children":574},{"className":573},[],[575],{"type":49,"value":388},{"type":43,"tag":274,"props":577,"children":578},{},[579,588,638],{"type":43,"tag":311,"props":580,"children":581},{},[582],{"type":43,"tag":84,"props":583,"children":585},{"className":584},[],[586],{"type":49,"value":587},"--ratio",{"type":43,"tag":311,"props":589,"children":590},{},[591,593,599,601,607,608,614,616,622,623,629,630,636],{"type":49,"value":592},"Aspect ratio. gemini_2.5_flash: ",{"type":43,"tag":84,"props":594,"children":596},{"className":595},[],[597],{"type":49,"value":598},"1344:768",{"type":49,"value":600},", ",{"type":43,"tag":84,"props":602,"children":604},{"className":603},[],[605],{"type":49,"value":606},"768:1344",{"type":49,"value":600},{"type":43,"tag":84,"props":609,"children":611},{"className":610},[],[612],{"type":49,"value":613},"1024:1024",{"type":49,"value":615},", etc. gen4_image: ",{"type":43,"tag":84,"props":617,"children":619},{"className":618},[],[620],{"type":49,"value":621},"1280:720",{"type":49,"value":600},{"type":43,"tag":84,"props":624,"children":626},{"className":625},[],[627],{"type":49,"value":628},"1360:768",{"type":49,"value":600},{"type":43,"tag":84,"props":631,"children":633},{"className":632},[],[634],{"type":49,"value":635},"1920:1080",{"type":49,"value":637},", etc.",{"type":43,"tag":311,"props":639,"children":640},{},[641,643,648,650,655],{"type":49,"value":642},"Model-dependent (",{"type":43,"tag":84,"props":644,"children":646},{"className":645},[],[647],{"type":49,"value":598},{"type":49,"value":649}," for gemini, ",{"type":43,"tag":84,"props":651,"children":653},{"className":652},[],[654],{"type":49,"value":621},{"type":49,"value":656}," for others)",{"type":43,"tag":274,"props":658,"children":659},{},[660,668,679],{"type":43,"tag":311,"props":661,"children":662},{},[663],{"type":43,"tag":84,"props":664,"children":666},{"className":665},[],[667],{"type":49,"value":472},{"type":43,"tag":311,"props":669,"children":670},{},[671,673],{"type":49,"value":672},"Reference images as tag=URL pairs (optional for gemini\u002Fgen4_image, required for gen4_image_turbo). Tag: lowercase, 3-16 chars, e.g. ",{"type":43,"tag":84,"props":674,"children":676},{"className":675},[],[677],{"type":49,"value":678},"product=URL",{"type":43,"tag":311,"props":680,"children":681},{},[682],{"type":49,"value":529},{"type":43,"tag":274,"props":684,"children":685},{},[686,695,700],{"type":43,"tag":311,"props":687,"children":688},{},[689],{"type":43,"tag":84,"props":690,"children":692},{"className":691},[],[693],{"type":49,"value":694},"--output-dir",{"type":43,"tag":311,"props":696,"children":697},{},[698],{"type":49,"value":699},"Output directory",{"type":43,"tag":311,"props":701,"children":702},{},[703],{"type":49,"value":704},"cwd",{"type":43,"tag":706,"props":707,"children":708},"blockquote",{},[709],{"type":43,"tag":52,"props":710,"children":711},{},[712,714,719,721,727],{"type":49,"value":713},"API credentials come from ",{"type":43,"tag":84,"props":715,"children":717},{"className":716},[],[718],{"type":49,"value":215},{"type":49,"value":720}," only — no ",{"type":43,"tag":84,"props":722,"children":724},{"className":723},[],[725],{"type":49,"value":726},"--api-key",{"type":49,"value":728}," flag, to keep secrets out of shell history and process listings.",{"type":43,"tag":69,"props":730,"children":732},{"id":731},"filename-convention",[733],{"type":49,"value":734},"Filename Convention",{"type":43,"tag":52,"props":736,"children":737},{},[738,740],{"type":49,"value":739},"Pattern: ",{"type":43,"tag":84,"props":741,"children":743},{"className":742},[],[744],{"type":49,"value":745},"yyyy-mm-dd-hh-mm-ss-name.png",{"type":43,"tag":69,"props":747,"children":749},{"id":748},"examples",[750],{"type":49,"value":751},"Examples",{"type":43,"tag":52,"props":753,"children":754},{},[755],{"type":43,"tag":61,"props":756,"children":757},{},[758],{"type":49,"value":759},"Basic image:",{"type":43,"tag":76,"props":761,"children":763},{"className":78,"code":762,"language":80,"meta":81,"style":81},"uv run scripts\u002Fgenerate_image.py --prompt \"A serene Japanese garden with cherry blossoms\" --filename \"2026-04-14-japanese-garden.png\"\n",[764],{"type":43,"tag":84,"props":765,"children":766},{"__ignoreMap":81},[767],{"type":43,"tag":88,"props":768,"children":769},{"class":90,"line":91},[770,774,778,782,786,790,795,799,803,807,812],{"type":43,"tag":88,"props":771,"children":772},{"style":95},[773],{"type":49,"value":98},{"type":43,"tag":88,"props":775,"children":776},{"style":101},[777],{"type":49,"value":104},{"type":43,"tag":88,"props":779,"children":780},{"style":101},[781],{"type":49,"value":109},{"type":43,"tag":88,"props":783,"children":784},{"style":101},[785],{"type":49,"value":114},{"type":43,"tag":88,"props":787,"children":788},{"style":117},[789],{"type":49,"value":120},{"type":43,"tag":88,"props":791,"children":792},{"style":101},[793],{"type":49,"value":794},"A serene Japanese garden with cherry blossoms",{"type":43,"tag":88,"props":796,"children":797},{"style":117},[798],{"type":49,"value":130},{"type":43,"tag":88,"props":800,"children":801},{"style":101},[802],{"type":49,"value":135},{"type":43,"tag":88,"props":804,"children":805},{"style":117},[806],{"type":49,"value":120},{"type":43,"tag":88,"props":808,"children":809},{"style":101},[810],{"type":49,"value":811},"2026-04-14-japanese-garden.png",{"type":43,"tag":88,"props":813,"children":814},{"style":117},[815],{"type":49,"value":816},"\"\n",{"type":43,"tag":52,"props":818,"children":819},{},[820],{"type":43,"tag":61,"props":821,"children":822},{},[823],{"type":49,"value":824},"With a local reference image (gen4_image):",{"type":43,"tag":76,"props":826,"children":828},{"className":78,"code":827,"language":80,"meta":81,"style":81},"uv run scripts\u002Fgenerate_image.py --prompt \"@product on a marble counter, lifestyle photo\" --model gen4_image --reference-images product=.\u002Fproduct.jpg --filename \"2026-04-14-product-lifestyle.png\"\n",[829],{"type":43,"tag":84,"props":830,"children":831},{"__ignoreMap":81},[832],{"type":43,"tag":88,"props":833,"children":834},{"class":90,"line":91},[835,839,843,847,851,855,860,864,869,874,879,884,888,892,897],{"type":43,"tag":88,"props":836,"children":837},{"style":95},[838],{"type":49,"value":98},{"type":43,"tag":88,"props":840,"children":841},{"style":101},[842],{"type":49,"value":104},{"type":43,"tag":88,"props":844,"children":845},{"style":101},[846],{"type":49,"value":109},{"type":43,"tag":88,"props":848,"children":849},{"style":101},[850],{"type":49,"value":114},{"type":43,"tag":88,"props":852,"children":853},{"style":117},[854],{"type":49,"value":120},{"type":43,"tag":88,"props":856,"children":857},{"style":101},[858],{"type":49,"value":859},"@product on a marble counter, lifestyle photo",{"type":43,"tag":88,"props":861,"children":862},{"style":117},[863],{"type":49,"value":130},{"type":43,"tag":88,"props":865,"children":866},{"style":101},[867],{"type":49,"value":868}," --model",{"type":43,"tag":88,"props":870,"children":871},{"style":101},[872],{"type":49,"value":873}," gen4_image",{"type":43,"tag":88,"props":875,"children":876},{"style":101},[877],{"type":49,"value":878}," --reference-images",{"type":43,"tag":88,"props":880,"children":881},{"style":101},[882],{"type":49,"value":883}," product=.\u002Fproduct.jpg",{"type":43,"tag":88,"props":885,"children":886},{"style":101},[887],{"type":49,"value":135},{"type":43,"tag":88,"props":889,"children":890},{"style":117},[891],{"type":49,"value":120},{"type":43,"tag":88,"props":893,"children":894},{"style":101},[895],{"type":49,"value":896},"2026-04-14-product-lifestyle.png",{"type":43,"tag":88,"props":898,"children":899},{"style":117},[900],{"type":49,"value":816},{"type":43,"tag":52,"props":902,"children":903},{},[904],{"type":43,"tag":61,"props":905,"children":906},{},[907],{"type":49,"value":908},"With a reference image from a trusted origin (gen4_image_turbo — requires reference images):",{"type":43,"tag":76,"props":910,"children":912},{"className":78,"code":911,"language":80,"meta":81,"style":81},"uv run scripts\u002Fgenerate_image.py --prompt \"A neon sign reading SALE in @style\" --model gen4_image_turbo --reference-images style=https:\u002F\u002Fcdn.yourapp.com\u002Fstyle.jpg --filename \"draft.png\"\n",[913],{"type":43,"tag":84,"props":914,"children":915},{"__ignoreMap":81},[916],{"type":43,"tag":88,"props":917,"children":918},{"class":90,"line":91},[919,923,927,931,935,939,944,948,952,957,961,966,970,974,979],{"type":43,"tag":88,"props":920,"children":921},{"style":95},[922],{"type":49,"value":98},{"type":43,"tag":88,"props":924,"children":925},{"style":101},[926],{"type":49,"value":104},{"type":43,"tag":88,"props":928,"children":929},{"style":101},[930],{"type":49,"value":109},{"type":43,"tag":88,"props":932,"children":933},{"style":101},[934],{"type":49,"value":114},{"type":43,"tag":88,"props":936,"children":937},{"style":117},[938],{"type":49,"value":120},{"type":43,"tag":88,"props":940,"children":941},{"style":101},[942],{"type":49,"value":943},"A neon sign reading SALE in @style",{"type":43,"tag":88,"props":945,"children":946},{"style":117},[947],{"type":49,"value":130},{"type":43,"tag":88,"props":949,"children":950},{"style":101},[951],{"type":49,"value":868},{"type":43,"tag":88,"props":953,"children":954},{"style":101},[955],{"type":49,"value":956}," gen4_image_turbo",{"type":43,"tag":88,"props":958,"children":959},{"style":101},[960],{"type":49,"value":878},{"type":43,"tag":88,"props":962,"children":963},{"style":101},[964],{"type":49,"value":965}," style=https:\u002F\u002Fcdn.yourapp.com\u002Fstyle.jpg",{"type":43,"tag":88,"props":967,"children":968},{"style":101},[969],{"type":49,"value":135},{"type":43,"tag":88,"props":971,"children":972},{"style":117},[973],{"type":49,"value":120},{"type":43,"tag":88,"props":975,"children":976},{"style":101},[977],{"type":49,"value":978},"draft.png",{"type":43,"tag":88,"props":980,"children":981},{"style":117},[982],{"type":49,"value":816},{"type":43,"tag":69,"props":984,"children":986},{"id":985},"output",[987],{"type":49,"value":988},"Output",{"type":43,"tag":232,"props":990,"children":991},{},[992,997,1002],{"type":43,"tag":196,"props":993,"children":994},{},[995],{"type":49,"value":996},"The script downloads the result and saves it to the specified path",{"type":43,"tag":196,"props":998,"children":999},{},[1000],{"type":49,"value":1001},"Script outputs the full path to the saved file",{"type":43,"tag":196,"props":1003,"children":1004},{},[1005,1010],{"type":43,"tag":61,"props":1006,"children":1007},{},[1008],{"type":49,"value":1009},"Do not read the image file back",{"type":49,"value":1011}," -- just inform the user of the saved path",{"type":43,"tag":69,"props":1013,"children":1015},{"id":1014},"common-failures",[1016],{"type":49,"value":1017},"Common Failures",{"type":43,"tag":232,"props":1019,"children":1020},{},[1021,1055,1066],{"type":43,"tag":196,"props":1022,"children":1023},{},[1024,1030,1032,1037,1039,1045,1047,1053],{"type":43,"tag":84,"props":1025,"children":1027},{"className":1026},[],[1028],{"type":49,"value":1029},"Error: No API key",{"type":49,"value":1031}," -> set ",{"type":43,"tag":84,"props":1033,"children":1035},{"className":1034},[],[1036],{"type":49,"value":215},{"type":49,"value":1038}," in the environment (e.g. ",{"type":43,"tag":84,"props":1040,"children":1042},{"className":1041},[],[1043],{"type":49,"value":1044},"export RUNWAYML_API_SECRET=...",{"type":49,"value":1046}," or a ",{"type":43,"tag":84,"props":1048,"children":1050},{"className":1049},[],[1051],{"type":49,"value":1052},".env",{"type":49,"value":1054}," file).",{"type":43,"tag":196,"props":1056,"children":1057},{},[1058,1064],{"type":43,"tag":84,"props":1059,"children":1061},{"className":1060},[],[1062],{"type":49,"value":1063},"Error: Task failed -- SAFETY.INPUT.*",{"type":49,"value":1065}," -> content moderation, suggest different prompt",{"type":43,"tag":196,"props":1067,"children":1068},{},[1069,1075],{"type":43,"tag":84,"props":1070,"children":1072},{"className":1071},[],[1073],{"type":49,"value":1074},"API error 429",{"type":49,"value":1076}," -> rate limited, script auto-retries",{"type":43,"tag":1078,"props":1079,"children":1080},"style",{},[1081],{"type":49,"value":1082},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":1084,"total":1245},[1085,1102,1111,1125,1140,1153,1160,1171,1185,1203,1214,1234],{"slug":1086,"name":1086,"fn":1087,"description":1088,"org":1089,"tags":1090,"stars":24,"repoUrl":25,"updatedAt":1101},"rw-api-reference","look up Runway API reference","Complete reference for Runway's public API: models, endpoints, costs, limits, and types",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1091,1092,1095,1098],{"name":19,"slug":20,"type":16},{"name":1093,"slug":1094,"type":16},"API Development","api-development",{"name":1096,"slug":1097,"type":16},"Reference","reference",{"name":1099,"slug":1100,"type":16},"Video","video","2026-04-08T04:41:58.820783",{"slug":1103,"name":1103,"fn":1104,"description":1105,"org":1106,"tags":1107,"stars":24,"repoUrl":25,"updatedAt":1110},"rw-check-compatibility","verify codebase compatibility with the Runway API","Analyze a user's codebase to verify it can use Runway's public API (server-side requirement)",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1108,1109],{"name":1093,"slug":1094,"type":16},{"name":9,"slug":8,"type":16},"2026-04-08T04:42:01.271257",{"slug":1112,"name":1112,"fn":1113,"description":1114,"org":1115,"tags":1116,"stars":24,"repoUrl":25,"updatedAt":1124},"rw-check-org-details","query Runway API for organization details","Query the Runway API for organization details: rate limits, credit balance, usage tier, and daily generation counts",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1117,1120,1123],{"name":1118,"slug":1119,"type":16},"Operations","operations",{"name":1121,"slug":1122,"type":16},"Reporting","reporting",{"name":9,"slug":8,"type":16},"2026-04-08T04:42:00.054235",{"slug":1126,"name":1126,"fn":1127,"description":1128,"org":1129,"tags":1130,"stars":24,"repoUrl":25,"updatedAt":1139},"rw-fetch-api-reference","retrieve Runway API reference","Retrieve the latest Runway API reference from docs.dev.runwayml.com and use it as the authoritative source before any integration work",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1131,1132,1135,1138],{"name":1093,"slug":1094,"type":16},{"name":1133,"slug":1134,"type":16},"Documentation","documentation",{"name":1136,"slug":1137,"type":16},"Research","research",{"name":9,"slug":8,"type":16},"2026-04-08T04:42:07.604739",{"slug":1141,"name":1141,"fn":1142,"description":1143,"org":1144,"tags":1145,"stars":24,"repoUrl":25,"updatedAt":1152},"rw-generate-audio","generate audio with Runway API","Generate audio using the Runway API via runnable scripts. Supports TTS, sound effects, voice isolation, dubbing, and voice conversion.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1146,1147,1150,1151],{"name":19,"slug":20,"type":16},{"name":1148,"slug":1149,"type":16},"Audio","audio",{"name":14,"slug":15,"type":16},{"name":9,"slug":8,"type":16},"2026-04-17T04:51:59.892185",{"slug":4,"name":4,"fn":5,"description":6,"org":1154,"tags":1155,"stars":24,"repoUrl":25,"updatedAt":26},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1156,1157,1158,1159],{"name":19,"slug":20,"type":16},{"name":14,"slug":15,"type":16},{"name":22,"slug":23,"type":16},{"name":9,"slug":8,"type":16},{"slug":1161,"name":1161,"fn":1162,"description":1163,"org":1164,"tags":1165,"stars":24,"repoUrl":25,"updatedAt":1170},"rw-generate-video","generate videos with Runway API","Generate videos directly using the Runway API via runnable scripts. Supports text-to-video, image-to-video, and video-to-video with seedance2, gen4.5, veo3, and more.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1166,1167,1168,1169],{"name":19,"slug":20,"type":16},{"name":14,"slug":15,"type":16},{"name":9,"slug":8,"type":16},{"name":1099,"slug":1100,"type":16},"2026-04-17T04:51:58.600919",{"slug":1172,"name":1172,"fn":1173,"description":1174,"org":1175,"tags":1176,"stars":24,"repoUrl":25,"updatedAt":1184},"rw-integrate-audio","integrate Runway audio APIs","Help users integrate Runway audio APIs (TTS, sound effects, voice isolation, dubbing)",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1177,1178,1179,1180,1181],{"name":1093,"slug":1094,"type":16},{"name":1148,"slug":1149,"type":16},{"name":14,"slug":15,"type":16},{"name":9,"slug":8,"type":16},{"name":1182,"slug":1183,"type":16},"Speech","speech","2026-04-08T04:42:10.081814",{"slug":1186,"name":1186,"fn":1187,"description":1188,"org":1189,"tags":1190,"stars":24,"repoUrl":25,"updatedAt":1202},"rw-integrate-character-embed","embed Runway characters in React apps","Help users embed Runway Character avatar calls in React apps using the @runwayml\u002Favatars-react SDK",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1191,1192,1195,1198,1199],{"name":1093,"slug":1094,"type":16},{"name":1193,"slug":1194,"type":16},"Frontend","frontend",{"name":1196,"slug":1197,"type":16},"React","react",{"name":9,"slug":8,"type":16},{"name":1200,"slug":1201,"type":16},"UI Components","ui-components","2026-04-08T04:42:08.849481",{"slug":1204,"name":1204,"fn":1205,"description":1206,"org":1207,"tags":1208,"stars":24,"repoUrl":25,"updatedAt":1213},"rw-integrate-characters","integrate Runway conversational characters","Help users create Runway Characters (GWM-1 avatars) and integrate real-time conversational sessions into their apps",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1209,1210,1211,1212],{"name":1093,"slug":1094,"type":16},{"name":1148,"slug":1149,"type":16},{"name":14,"slug":15,"type":16},{"name":9,"slug":8,"type":16},"2026-04-08T04:42:06.171483",{"slug":1215,"name":1215,"fn":1216,"description":1217,"org":1218,"tags":1219,"stars":24,"repoUrl":25,"updatedAt":1233},"rw-integrate-documents","add documents to Runway Characters","Help users add knowledge base documents to Runway Characters for domain-specific conversations",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1220,1223,1226,1229,1232],{"name":1221,"slug":1222,"type":16},"Agents","agents",{"name":1224,"slug":1225,"type":16},"AI Context","ai-context",{"name":1227,"slug":1228,"type":16},"Documents","documents",{"name":1230,"slug":1231,"type":16},"Knowledge Management","knowledge-management",{"name":9,"slug":8,"type":16},"2026-04-08T04:42:04.95186",{"slug":1235,"name":1235,"fn":1236,"description":1237,"org":1238,"tags":1239,"stars":24,"repoUrl":25,"updatedAt":1244},"rw-integrate-image","integrate Runway image generation APIs","Help users integrate Runway image generation APIs (text-to-image with reference images)",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1240,1241,1242,1243],{"name":1093,"slug":1094,"type":16},{"name":14,"slug":15,"type":16},{"name":22,"slug":23,"type":16},{"name":9,"slug":8,"type":16},"2026-04-08T04:42:11.322008",18,{"items":1247,"total":1294},[1248,1255,1260,1266,1273,1280,1287],{"slug":1086,"name":1086,"fn":1087,"description":1088,"org":1249,"tags":1250,"stars":24,"repoUrl":25,"updatedAt":1101},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1251,1252,1253,1254],{"name":19,"slug":20,"type":16},{"name":1093,"slug":1094,"type":16},{"name":1096,"slug":1097,"type":16},{"name":1099,"slug":1100,"type":16},{"slug":1103,"name":1103,"fn":1104,"description":1105,"org":1256,"tags":1257,"stars":24,"repoUrl":25,"updatedAt":1110},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1258,1259],{"name":1093,"slug":1094,"type":16},{"name":9,"slug":8,"type":16},{"slug":1112,"name":1112,"fn":1113,"description":1114,"org":1261,"tags":1262,"stars":24,"repoUrl":25,"updatedAt":1124},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1263,1264,1265],{"name":1118,"slug":1119,"type":16},{"name":1121,"slug":1122,"type":16},{"name":9,"slug":8,"type":16},{"slug":1126,"name":1126,"fn":1127,"description":1128,"org":1267,"tags":1268,"stars":24,"repoUrl":25,"updatedAt":1139},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1269,1270,1271,1272],{"name":1093,"slug":1094,"type":16},{"name":1133,"slug":1134,"type":16},{"name":1136,"slug":1137,"type":16},{"name":9,"slug":8,"type":16},{"slug":1141,"name":1141,"fn":1142,"description":1143,"org":1274,"tags":1275,"stars":24,"repoUrl":25,"updatedAt":1152},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1276,1277,1278,1279],{"name":19,"slug":20,"type":16},{"name":1148,"slug":1149,"type":16},{"name":14,"slug":15,"type":16},{"name":9,"slug":8,"type":16},{"slug":4,"name":4,"fn":5,"description":6,"org":1281,"tags":1282,"stars":24,"repoUrl":25,"updatedAt":26},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1283,1284,1285,1286],{"name":19,"slug":20,"type":16},{"name":14,"slug":15,"type":16},{"name":22,"slug":23,"type":16},{"name":9,"slug":8,"type":16},{"slug":1161,"name":1161,"fn":1162,"description":1163,"org":1288,"tags":1289,"stars":24,"repoUrl":25,"updatedAt":1170},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1290,1291,1292,1293],{"name":19,"slug":20,"type":16},{"name":14,"slug":15,"type":16},{"name":9,"slug":8,"type":16},{"name":1099,"slug":1100,"type":16},17]