Runway Gen-4 Image API and MCP for AI agents
TollNode gives Claude, Cursor or any AI agent Runway Gen-4 Image, Runway's cinematic image model with tagged reference images, over API and MCP, from $0.069 per image, with no subscription.
Ask for 'An astronaut in a white spacesuit with the visor up...' and get a finished image link back in seconds.
No subscription · Sign-up optional · From $0.069 per call · Charged only when it works · No Runway account needed
Make this image: An astronaut in a white spacesuit with the visor up, standing alone in a vast...
TollNode · Runway · 1080p$0.109 · 1 image
| Result | Detail |
|---|---|
| File | 1 image link, does not expire |
| Resolution | 1080p |
Real result, shown below.
Runway Gen-4 Image examples
Made by this node in our own tests, from the request shown under each.

“An astronaut in a white spacesuit with the visor up, standing alone in a vast field of sunflowers at golden hour, cinematic wide shot”
The request that made it
Send the same body to get this kind of result. Change the prompt or the options to get your own.
{
"prompt": "An astronaut in a white spacesuit with the visor up, standing alone in a vast field of sunflowers at golden hour, cinematic wide shot",
"resolution": "1080p"
}What you control with Runway Gen-4 Image
Prompt and style
Runway Gen-4 Image prompt to image
Describe the picture in plain words, including any text.
- Prompt
- An astronaut in a white spacesuit with the visor up, standing alone...
- Resolution
- 1080p
- Returns
- 1 image link
You get
- prompt: what to create, in plain words
- aspect_ratio: the shape of the result: 16:9 to 21:9
- seed: repeat a result by reusing the number
Reference images
Add photos to edit, restyle or combine.
- reference images
- https://.../photo.jpg
- Prompt
- An astronaut in a white spacesuit with the visor up...
- Up to
- 3 images
You get
- reference_images: reference images for people or style
- reference_tags: one tag per reference image
- from $0.069
Resolution and price
Runway Gen-4 Image resolution options
Pick the option; the price follows it.
- Default
- 1080p
- Options
- 720p, 1080p
- Charged
- only when a result comes back
You get
- resolution: output size; sets the price; default 1080p
- options: 720p, 1080p
Actions
Failed calls are never charged. Image and audio links returned by TollNode don't expire.
What people ask their AI to do with it
Ecommerce sellers
Product photos without a shoot
“Make a studio photo of my ceramic mug on a marble counter in morning light”
1080p
Cost today$0.109
Marketers
Ad and social images
“Create three portrait Instagram ad images for a coffee subscription, bold and bright”
3 × 1080p
Cost today$0.327
Designers
Concept art and mockups
“Generate three packaging concepts for an oat milk brand, flat lay on a gray background”
3 × 1080p
Cost today$0.327
Founders
Pitch deck visuals
“Draw a wide hero image of a delivery drone over a US suburb at sunset for my seed deck”
1080p
Cost today$0.109
Content creators
Thumbnails and blog headers
“Make a wide YouTube thumbnail of me pointing at a glowing laptop with big bold text”
2 × 1080p
Cost today$0.218
Educators
Diagrams and class visuals
“Illustrate the water cycle for fourth graders, labeled, clean flat style”
1080p
Cost today$0.109
Use it as a Runway Gen-4 Image MCP server in Claude, Cursor or Codex
Connect once. Then just ask.
Paste this into Claude Code, Cursor or Codex. It connects TollNode and gives your agent a small wallet. Add a few dollars of USDC and you're done.
npx agentcash add https://tollnode.comCopy for your AI agent
Paste this into your agent so it knows what this node does and how to call it.
You can use TollNode's Runway Gen-4 Image node to make an image. Call POST https://tollnode.com/api/v1/nodes/runway-gen-4-image with prompt (required), resolution (optional), aspect_ratio (optional), reference_tags (optional), reference_images (optional). The price depends on resolution (720p, 1080p; default 1080p) and is charged only when a result is returned. Over MCP, call the "runway-gen-4-image" tool; use list_models to see prices. Give me the file link when it is done.Price
from $0.069
per image
The price depends on the resolution you choose. If you don't choose, you get 1080p.
| 720p | $0.069 per image |
| 1080pdefault | $0.109 per image |
Charged only when a call returns a result. Failed or empty calls cost $0.
Runway Gen-4 Image without a Runway account
No subscription, no credit packs
Pay per image: $0.069 at 720p, $0.109 at 1080p.
No Runway account, no quota form
Your agent calls TollNode. You never set up billing with the model's maker or request access.
Only charged when it works
If generation fails or returns nothing, the call costs nothing.
One connection, many image models
The same setup also gives your agent other models and live data tools, so it can compare results.
FAQ
- Is this the official Runway API?
- No. TollNode is an independent service. It gives your agent access to Runway Gen-4 Image through its own API and MCP server, priced per image, with no Runway account needed.
- Can I use it as a Runway Gen-4 Image MCP server in Claude?
- Yes. Add https://tollnode.com/mcp in Claude Code, Claude Desktop or Cursor, and the "runway-gen-4-image" tool appears with its options and prices.
- What options can I choose?
- The resolution can be 720p or 1080p; the default is 1080p. The price follows the option you pick, shown in the price table above.
- Can I start from my own image?
- Yes. Send an image link in reference_images (https) along with your prompt. The result is built from it. Up to 3 images are accepted.
- What if nothing comes back?
- You're not charged. TollNode only collects payment when a usable result is returned.
- How long are the links valid?
- They don't expire. Download the file or keep the link.
- How do I pay for Runway Gen-4 Image?
- Your agent sends the request, gets an HTTP 402 with the exact price (from $0.069 per call), signs a USDC payment on Base and retries. Or use an account balance with an API key. Either way you are charged only when a result comes back.
- What does the Runway Gen-4 Image response look like?
- A JSON object with a link to the finished file. The link does not expire, so you can download it later or keep the link.
Works well with
- Crisp image upscalerEnlarge the finished image for print$0.010
- Nano Banana Pro image generationA high-quality image model to comparefrom $0.204
- GPT Image 2 generation and editingOpenAI's image model, good with textfrom $0.018
- Veo 3.1 video with soundTurn a finished image or idea into a video with soundfrom $2.161
Ready in a minute
Connect your AIFor developers: endpoint, inputs and an example response
POST https://tollnode.com/api/v1/nodes/runway-gen-4-image
Input
| Field | Type | Notes |
|---|---|---|
| seed | integer | |
| prompt* | string | What to create or change |
| resolution | enum | Output resolution; sets the price. Default 1080p (720p, 1080p) |
| aspect_ratio | enum | Aspect ratio, default 16:9 (16:9, 9:16, 4:3, 3:4, 1:1, 21:9) |
| reference_tags | array | One tag per reference image, e.g. ["chair"], used in the prompt as @chair |
| reference_images | array | Optional reference images (https URLs); mention them in the prompt by their tag. Or send the file inline as a base64 data: URI (up to 4.5 MB) |
Example response
{
"images": [
"https://tollnode.com/api/v1/files/00000000-0000-0000-0000-000000000000/0"
]
}Also described in the OpenAPI file and llms.txt. Setup for every app: Agents & MCP.