runway-gen4defaultRunway Gen4 API — how to connect and pay
Runway Gen4 — cinematic quality. T2V and I2V, 720p/1080p. Pixel does not return creditsConsumed — price per catalog.
Channel comparison
last 7 days
| Channel | Price |
|---|---|
Default runway-gen4default | from $0.08 per clip |
Build the result you need
runway-gen4What is Runway Gen4
Runway Gen4 — cinematic quality. T2V and I2V, 720p/1080p. Pixel does not return creditsConsumed — price per catalog.
Contract at a glance
- Input
- text, image
- Output
- video
- Mode
- async (job + polling)
- Status polling
- every 3 s · up to 600 s
Strengths
- Pricing: per clip
- Inputs: text, image
- 3 configurable options
- One API key for media generation
Where it is used
- Social media clips
- Promos and title sequences
- Still-image animation
- Storyboards and animatics
API contract
Generation runs asynchronously: create a job, then poll its status until completion.
- Create job
- POST /api/media/generate
- Check status
- GET /api/media/jobs/{jobId}
- Input
- text, image
- Output
- video
- Polling
- every 3 s · up to 600 s
- Authentication
- Authorization: Bearer sk-pv-…
Example request
Pass your key in the Bearer header. The API returns jobId for polling the status.
curl -sS https://getvibeapi.com/api/media/generate \
-H "Authorization: Bearer $GETVIBE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary '{"model":"runway-gen4","prompt":"a beautiful landscape","opts":{"aspect_ratio":"16:9","duration":"5","quality":"720p"}}'JavaScript
const response = await fetch('https://getvibeapi.com/api/media/generate', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.GETVIBE_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"model": "runway-gen4",
"prompt": "a beautiful landscape",
"opts": {
"aspect_ratio": "16:9",
"duration": "5",
"quality": "720p"
}
}),
});
if (!response.ok) throw new Error(`GetVibe API: ${response.status}`);
const { jobId } = await response.json();
console.log(jobId);API request parameters
Parameters for requests to Runway Gen4 via the GetVibe API.
aspect_ratiodurationqualityimage_file_idimage_base64| Parameter | Type | Values | Default | Price |
|---|---|---|---|---|
aspect_ratio | option selection | 16:9 · 9:16 · 1:1 | 16:9 | Included in the base price |
duration | option selection | 5 · 10 | 5 | Included in the base price |
quality | option selection | 720p · 1080p | 720p | Included in the base price |
image_file_id | text | Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…) | — | Included in the base price |
image_base64 | text | Alternative to image_url: the file inline, as base64 or a data: URI | — | Included in the base price |
Request: POST https://getvibeapi.com/api/media/generate. Prices in USD.
Price of Runway Gen4
The cost of Runway Gen4: from $35.00 per clip. The price is calculated dynamically at the current exchange rate, and the final charge is shown in the API response (priceRub). Payment in USD, no subscriptions.
Channels and prices for every parameter combination
For every channel, the price of every parameter combination. It is exactly the amount a successful generation is charged, and the same figure as in the machine-readable table linked below.
Defaultrunway-gen4from $0.08exact prices
| Resolution \ Duration, sec | 5 s | 10 s |
|---|---|---|
| 720p | $0.08 | $0.20 |
| 1080p | $0.20 | — |
Every combination as JSON: /api/media/price-table?model=runway-gen4
README
The machine-readable contract for Runway Gen4 contains the request schema, operations, limits, polling and response examples.
# Runway Gen4
Public model: runway-gen4
Create job: POST /api/media/generate
Check status: GET /api/media/jobs/{jobId}
## Input parameters
- `aspect_ratio` (option selection): 16:9 · 9:16 · 1:1; default: 16:9
- `duration` (option selection): 5 · 10; default: 5
- `quality` (option selection): 720p · 1080p; default: 720p
- `image_file_id` (text): Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…); default: —
- `image_base64` (text): Alternative to image_url: the file inline, as base64 or a data: URI; default: —
## Public variants
- `runway-gen4`: DefaultFAQ about the Runway Gen4 API
How much does Runway Gen4 cost?
The price of Runway Gen4: from $35.00 per clip. The price is calculated dynamically at the current exchange rate.
Is it compatible with the OpenAI SDK?
Yes, the API is fully OpenAI-compatible. Just change base_url to https://getvibeapi.com/v1 and set your key — the rest of the code stays the same.