Kwaivgi Kling Video O1 Reference To Video

Kwaivgi Kling Video O1 Reference To Video

Playground

Kling Omni Video O1 Reference-to-Video generates creative videos using character, prop, or scene references from multiple viewpoints. Extracts subject features and creates new video content while maintaining identity consistency across frames. Ready-to-use REST API, best performance, no cold starts, affordable pricing.

Features

Kling Omni Video O1 is Kuaishou’s groundbreaking unified multi-modal video model. The Reference-to-Video mode creates new video content based on subject references — maintaining character, prop, and scene identity while generating entirely new creative scenarios.

Key Capabilities

Multi-Reference Subject Creation

Build subjects from multiple reference viewpoints:

• Extract features from character, prop, or scene images
• Maintain consistent identity in generated videos
• Create new scenarios with familiar subjects

Subject Consistency Technology

Advanced feature extraction ensures:

• Stable character appearance across all frames
• Consistent clothing, accessories, and props
• Maintained facial features and expressions
• Coherent scene elements and backgrounds

Creative Freedom

Generate entirely new content while preserving identity:

• New poses and actions
• Different scenes and environments
• Various camera angles and movements
• Fresh creative scenarios

Core Features

• Identity Lock — Subject features remain consistent throughout video
• Multi-Angle Support — Use references from various viewpoints
• Scene Flexibility — Place subjects in new environments
• Motion Control — Guide actions with text prompts

How to Use

1. Upload Reference Images Provide one or more images of your subject (character, object, or scene).

2. Describe the Scenario Write a prompt for the new video content. > Example: “The character walking through a futuristic city at night, neon lights reflecting on wet streets”

3. Set Parameters Choose duration, resolution, and output format.

4. Generate Receive video with your subject in the new scenario.

Pricing

$0.112/s for image reference only; $0.168/s when using video reference.

Pro Tips

• Use multiple reference angles for better identity capture
• Provide clear, high-resolution reference images
• Describe actions and environments clearly in prompts
• Works best for characters, products, and distinct objects

Note

• If the input reference parameters include a video, then the number of reference images that can be entered will be reduced to 4.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result

set -euo pipefail

export WAVESPEED_API_KEY="your-api-key"

REQUEST_BODY=$(cat <<'JSON'
{
  "prompt": "A cinematic ocean wave at sunrise, highly detailed",
  "keep_original_sound": true,
  "aspect_ratio": "16:9",
  "duration": 5
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/kwaivgi/kling-video-o1/reference-to-video" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}")

TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL=$(printf '%s' "${TASK}" | jq -r '.urls.get // empty')
if [ -z "${RESULT_URL}" ]; then RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"; fi

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body \
    "${RESULT_URL}" \
    -H "Authorization: Bearer ${WAVESPEED_API_KEY}")
  RESULT=$(printf '%s' "${RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
  STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')

  case "${STATUS}" in
    completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
    failed|cancelled|timeout) printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
    created|processing) sleep 2 ;;
    *) printf 'Unexpected status: %s
' "${STATUS}" >&2; exit 1 ;;
  esac
done

Parameters

Task Submission Parameters

Request Parameters

Response Parameters

Result Request Parameters

Result Response Parameters