Integrate Uploads

PREREQUISITE: Run +rw-check-compatibility first. Run +rw-fetch-api-reference to load the latest API reference before integrating. Requires +rw-setup-api-key for API credentials.

Help users upload local files (images, videos, audio) to Runway's ephemeral storage for use as inputs to generation models.

When to Use Uploads

Use the Uploads API when:

• The user has a local file (not a public URL) they want to use as input
• The file exceeds data URI size limits (5 MB for images, 16 MB for video/audio)
• The file's URL doesn't meet Runway's URL requirements (HTTPS, proper headers, no redirects)

You do NOT need uploads when:

• The asset is already at a public HTTPS URL with proper headers
• The asset is small enough for a data URI (< 5 MB image, < 16 MB video)

How It Works