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-10 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)
  • model controls video duration (5 or 10 seconds)
  • waterMark video watermark text content, empty string means no watermark

Developer Notes​

  • Generated videos are stored for 14 days before automatic deletion
  • Image-based generation requires compatible aspect ratios (16:9 or 9:16)
  • 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