Skip to main content

Generate AI Video

POST 
/api/v1/runway/generate

Create dynamic AI-generated videos from text prompts or image references.

Usage Guide​

  • Create short videos (5-8 seconds) using AI visualization
  • Generate videos based on text descriptions or reference images
  • Suitable for social media content, digital art, or concept visualization

Parameter Details​

  • prompt describes what you want to show in the video
  • imageUrl provides visual reference for AI
  • aspectRatio determines video orientation (vertical or horizontal)
  • duration control the video duration (5 or 8 seconds), where if an 8-second video is selected, 1080p resolution cannot be selected
  • quality video resolution (720p or 1080p), where if 1080p is selected, 8-second video cannot be generated
  • waterMark video watermark text content, empty string means no watermark

Developer Notes​

  • Generated videos are stored for 14 days before automatic deletion
  • For text-only generation, aspect ratio must be explicitly specified

Request​

Responses​

Request successful

Callbacks​

POST 
{$request.body#/callBackUrl}

When video generation is complete, the system will send a POST request to the provided callback URL to notify the result

Callbacks Responses​

Callback received successfully