reference-to-video
kling-v3-omni-std-r2v
background_tasks

Kling 3 Omni Standard - Video-to-video generation

Generate AI video using Kling 3 Omni Standard with a reference video for motion and style guidance.

Video-to-video mode: This endpoint requires a video_url parameter. Reference the video in your prompt using @Video1.

Features:

  • Use a reference video (3-10s) to guide motion and style
  • Combine with an image for start frame control
  • Faster generation at slightly lower quality

Use case: Create videos that follow motion patterns from a reference video while applying your creative prompt.

Duration: 3-15 seconds Quality: Standard mode offers faster generation at slightly lower quality.

Tip: For text-to-video or image-to-video without a reference video, use the /ai/video/kling-v3-omni-std endpoint instead.

post/v1/ai/reference-to-video/kling-v3-omni-std

Request

  • Base URL: https://api.magnific.com
  • URL: https://api.magnific.com/v1/ai/reference-to-video/kling-v3-omni-std
  • Auth: API key in header x-magnific-api-key

Request body

webhook_urlstring uri

Optional callback URL that receives asynchronous notifications when the task changes status. The payload includes the task status and result URL when completed.

promptstring

Text prompt describing the desired video content. Maximum 2500 characters. Reference the video in your prompt as @Video1.

Tips for better results:

  • Be specific about actions, camera movements, and mood
  • Reference @Video1 to indicate how the reference video should influence generation
image_urlstring

URL of the start frame image for image-to-video generation with video reference.

Image requirements:

  • Minimum: 300x300 pixels
  • Maximum: 10MB file size
  • Formats: JPG, JPEG, PNG
video_urlstring uri required

Required. URL of the reference video to use as a creative guide for video-to-video generation. Reference in your prompt as @Video1.

Video constraints:

  • Duration: 3-10 seconds
  • Resolution: 720-2160px (minimum 720px width or height)
  • Max file size: 200MB
  • Frame rate: 24-60 FPS
  • Formats: .mp4 or .mov only
duration'3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | '11' | '12' | '13' | '14' | '15'

Duration of the generated video in seconds.

Range: 3-15 seconds Note: When using multi-shot mode, total duration across all shots cannot exceed 15 seconds.

aspect_ratio'auto' | '16:9' | '9:16' | '1:1'

Aspect ratio for Kling V3 Omni video generation:

  • auto: Automatically match the input image aspect ratio (image-to-video only)
  • 16:9: Landscape (widescreen)
  • 9:16: Portrait (vertical)
  • 1:1: Square
cfg_scalenumber float

Guidance scale controlling prompt adherence versus creative freedom. Range: 0 to 1. Values above 1 are not supported for Kling 3 (only Kling 1.x models support cfg_scale up to 2).

  • 0: Maximum creative freedom, loosest interpretation of the prompt
  • 0.5 (default): Balanced between prompt adherence and creativity
  • 1: Strongest adherence to the prompt, least creative variation
negative_promptstring

Undesired elements to avoid in the generated video. Maximum 2500 characters.

Response

OK - Task created successfully

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.