Runway ML

Overview

Runway ML provides video generation via an asynchronous task-based API. You submit a generation request and poll until the video is ready.

Supported Operations

Operation	Supported	Endpoint
Video Generation	✅	/v1/text_to_video, /v1/image_to_video, /v1/video_to_video
Video Retrieve	✅	/v1/tasks/{task_id}
Video Download	✅	via Retrieve + URL download
Video Delete	✅	/v1/tasks/{task_id} (cancel)
Video List	❌	-
Video Remix	❌	-

---

1. Video Generation

Generate (POST /v1/videos)

Request Parameters

Parameter	Type	Required	Notes
model	string	✅	Runway model
prompt	string	✅	Text description of the video
input_reference	string	❌	Input image for image-to-video
seconds	string	❌	Duration in seconds (default: "2")
size	string	❌	Resolution as WxH (e.g., 1280x720; default: 1280x720)
seed	int	❌	Gen models only
audio	bool	❌	Enable audio generation. Veo models only
video_uri	string	❌	Source video URL for video-to-video. gen4_aleph only

Extra Params

Key	Type	Notes
references	array	Video reference objects [{"uri": "...", "tag": "..."}] for video-to-video
content_moderation	object	Content moderation config
reference_images	array	Reference image objects for style/asset guidance

Generation Modes (auto-detected from inputs)

• Text-to-video: prompt only
• Image-to-video: prompt + input_reference
• Video-to-video: prompt + video_uri - gen4_aleph only

Response: DeepIntShieldVideoGenerationResponse with id, status, videos[]

DeepIntShield statuses (normalized): queued → in_progress → completed / failed

These values are the normalized view returned by DeepIntShield’s API. Runway’s native statuses are: PENDING, THROTTLED, RUNNING, SUCCEEDED, FAILED, CANCELLED.

Retrieve / Download / Delete

Operation	Endpoint	Notes
Get status	GET /v1/videos/{id}	Poll until status: completed
Download content	GET /v1/videos/{id}/content	Returns raw video bytes (MP4)
Cancel/Delete	DELETE /v1/videos/{id}	Cancels the running task

---

Configuration

Add Runway as a provider from the dashboard:

1. Go to https://app.deepintshield.com and open Providers in the sidebar.
2. Click Add New Provider and select Runway as the provider type.
3. Add a key (for example, named runway-key-1) and paste your Runway API key.
4. Save the configuration.

Once saved, route requests to Runway through the gateway using your virtual key.

See Provider Configuration for full setup options.

---

Reference Links

• Runway ML API Documentation
• Runway ML Models