alibaba/wan-2.6/reference-to-video

POST

/ws/api/v3/alibaba/wan-2.6/reference-to-video

alibaba/wan-2.6/reference-to-video can convert character, prop, or scene references (single-view or multi-view) into new video shots while preserving their characteristics, style, and layout, and achieving smooth and coherent motion.

Usage Steps

Prepare 1-2 reference videos

Pure motion shots, stable frames, and clear styles work best.

Two angles of the same scene or two segments with similar styles can be used.

Enter a prompt. Example: "A Cyberpunk alley at night, the protagonist walking towards the camera, slow push-in, neon reflections on the wet ground, cinematic color grading."

(Optional) Add negative_prompt. Example: watermark, text, logo, extra limbs, low resolution.

Select size, duration, and shot_type

Set seed (optional)

Price (/call)

	Sizes (Width×High)	5s	10s
720p	1280×720 / 720×1280	1PTC	1.5PTC
1080p	1920×1080 / 1080×1920	1.5PTC	2.25PTC

Request

Header Params

Body Params application/jsonRequired

Example

{
  "seed": 500185695,
  "size": "1280*720",
  "prompt": "the dog (reference1) is in the room(reference2)",
  "videos": [
    "https://d1q70pf5vjeyhc.cloudfront.net/media/f9753bf06bfa406fbbeacead4edb5069/videos/1765812927355675728_PZWV20YW.mp4",
    "https://d1q70pf5vjeyhc.cloudfront.net/media/f9753bf06bfa406fbbeacead4edb5069/videos/1765814893336691127_nba7gdc9.mp4"
  ],
  "duration": 5,
  "shot_type": "single",
  "enable_prompt_expansion": false
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/ws/api/v3/alibaba/wan-2.6/reference-to-video' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
  "seed": 500185695,
  "size": "1280*720",
  "prompt": "the dog (reference1) is in the room(reference2)",
  "videos": [
    "https://d1q70pf5vjeyhc.cloudfront.net/media/f9753bf06bfa406fbbeacead4edb5069/videos/1765812927355675728_PZWV20YW.mp4",
    "https://d1q70pf5vjeyhc.cloudfront.net/media/f9753bf06bfa406fbbeacead4edb5069/videos/1765814893336691127_nba7gdc9.mp4"
  ],
  "duration": 5,
  "shot_type": "single",
  "enable_prompt_expansion": false
}'

Responses

🟢200Success

application/json

Body

Example

{
  "code": 200,
  "message": "success",
  "data": {
    "id": "96e8cbb2e0d0400b8c10cf91759afe6c",
    "model": "alibaba/wan-2.6/reference-to-video",
    "outputs": [],
    "urls": {
      "get": "https://api.302.ai/ws/api/v3/predictions/96e8cbb2e0d0400b8c10cf91759afe6c/result"
    },
    "has_nsfw_contents": [],
    "status": "created",
    "created_at": "2025-12-16T10:07:41.066Z",
    "error": "",
    "executionTime": 0,
    "timings": {
      "inference": 0
    }
  }
}

Modified at 2025-12-16 11:27:48

alibaba/wan-2.6/image-to-video

alibaba/wan-2.5/text-to-video-fast