1. reference-to-video
RunningHub-API
  • Log of Update
  • Getting Started
    • Instructions for Use
    • About nodeInfoList
    • About Enterprise ComfyUI API
    • Native ComfyUI API Integration Guide
    • API Error Code Reference
  • Quick Create
    • About Quick Create Invocation
    • Obtain quick create - model library style parameter data
    • Initiate Quick Create Task
  • Integration Example
    • Complete integration example
    • Complete Integration Example – Advanced Edition
    • Task Progress Display Example
    • Full Workflow Integration Example
  • Standard Model API
    • Video Generation & Processing
      • image-to-video
        • Vidu
          • Vidu-image-to-video-q3-pro-fast
          • Vidu-start-end-to-video-q3-pro-fast
          • Vidu-start-end-to-video-q2-turbo
          • Vidu-start-end-to-video-q2-pro
          • Vidu-image-to-video-q2-pro
          • Vidu-image-to-video-q2-turbo
          • Vidu-image-to-video-q3-pro
          • Vidu-image-to-video-q2-pro-fast
          • Vidu-start-end-to-video-q2-pro-fast
          • Vidu-image-to-video-q3-turbo
          • Vidu-start-end-to-video-q3-turbo
          • Vidu-start-end-to-video-q3-pro
        • kling
          • kling-v3.0-pro-image-to-video
          • kling-video-o3-pro/reference-to-video
          • kling-video-o1/image-to-video
          • kling-v3.0-std-image-to-video
          • kling-video-o3-std/reference-to-video
          • kling-video-o1/start-to-end
          • kling-video-o3-pro-image-to-video
          • kling-video-o3-std-image-to-video
          • kling-elements
          • kling-v2.5-turbo-std/image-to-video
          • kling-v2.5-turbo-pro/image-to-video
          • kling-v2.6-pro-image-to-video
        • wan
          • wan-2.7/image-to-video
          • wan-2.2/image-to-video
          • wan-2.6-reference-to-video
          • wan-2.6-reference-to-video-flash
          • wan-2.6-image-to-video-flash
          • wan-2.2-video/start-to-end
        • alibaba
          • wan
            • alibaba/wan-2.6/image-to-video
        • seedance
          • seedance-2.0/image-to-video
          • seedance-2.0-fast/image-to-video
          • seedance-v1.5-pro-image-to-video-fast
          • seedance-v1.5-pro-image-to-video
        • hailuo
          • hailuo-02-i2v-standard
          • hailuo-02-standard
          • hailuo-2.3/i2v-standard
          • hailuo-2.3-fast/image-to-video
          • hailuo-2.3-fast-pro/image-to-video
          • hailuo-2.3/i2v-pro
          • hailuo-02-i2v-pro
          • hailuo-02-fast
        • midjourney
          • midjourney-image-to-video
        • sora
          • sora-2/image-to-video-channel-low-price
          • sora-2/image-to-video-pro-official-stable
          • sora-2/image-to-video-pro-channel-low-price
          • sora-2/text-to-video-pro-official-stable
          • sora-2/image-to-video-realistic-official-stable
          • sora-2/image-to-video-official-stable
          • sora-2/image-to-video-channel-low-price
          • sora-2/image-to-video-pro-channel-low-price
        • xai
          • grok
            • xai/grok-imagine/image-to-video-channel-low-price
            • xai/grok-imagine/image-to-video-official-stable
        • google
          • veo3.1
            • google/veo3.1-pro/start-end-to-video-channel-low-price
            • google/veo3.1-fast/image-to-video-channel-low-price
            • google/veo3.1-fast/image-to-video-official-stable
            • google/veo3.1-pro/image-to-video-official-stable
            • google/veo3.1-fast/start-end-to-video-channel-low-price
            • google/veo3.1-pro/reference-to-video-official-stable
        • skyreels
          • skyreels-v4/image-to-video
        • ltx
          • ltx-2.3/image-to-video
          • ltx-2.3/image-to-video-lora
        • pixverse
          • pixverse-v6/image-to-video
      • reference-to-video
        • wan-2.7-reference-to-video
          POST
        • skyreels-v3/reference-to-video
          POST
        • Vidu-reference-to-video-q3
          POST
        • seedance-2.0/multimodal-video
          POST
        • Vidu-reference-to-video-q2
          POST
        • seedance-2.0-fast/multimodal-video
          POST
        • kling-video-o1-std/refrence-to-video
          POST
        • seedance-v1-lite-reference-to-video
          POST
        • skyreels-v4/omni-reference
          POST
        • Vidu-reference-to-video-q3-mix
          POST
      • text-to-video
        • Vidu
          • Vidu-text-to-video-q3-pro-fast
          • Vidu-text-to-video-q2
          • Vidu-text-to-video-q3-pro
          • Vidu-text-to-video-q3-turbo
        • kling
          • kling-video-o3-std-text-to-video
          • kling-video-o1/text-to-video
          • kling-v3.0-pro-text-to-video
          • kling-v3.0-std-text-to-video
          • kling-video-o3-pro-text-to-video
          • kling-v2.5-turbo-pro/text-to-video
          • kling-v2.6-pro-text-to-video
        • alibaba
          • wan
            • alibaba/wan-2.6/text-to-video
        • seedance
          • seedance-2.0/text-to-video
          • seedance-2.0-fast/text-to-video
          • seedance-v1.5-pro-text-to-video-fast
          • seedance-v1.5-pro-text-to-video
        • hailuo
          • hailuo-02-t2v-standard
          • hailuo-02-pro
          • hailuo-2.3-t2v-standard
          • hailuo-2.3-t2v-pro
          • hailuo-02-t2v-pro
        • sora
          • sora-2/text-to-video-channel-low-price
          • sora-2/text-to-video-pro-channel-low-price
          • sora-2/text-to-video-official-stable
          • sora-2/text-to-video-channel-low-price
          • sora-2/text-to-video-pro-channel-low-price
        • xai
          • grok
            • xai/grok-imagine/text-to-video-channel-low-price
            • xai/grok-imagine/text-to-video-official-stable
        • google
          • veo3.1
            • google/veo3.1-pro/text-to-video-channel-low-price
            • google/veo3.1-pro/text-to-video-official-stable
            • google/veo3.1-fast/video-extend-official-stable
            • google/veo3.1-pro/video-extend-official-stable
            • google/veo3.1-fast/text-to-video-channel-low-price
            • google/veo3.1-fast/text-to-video-official-stable
        • cinematic
          • cinematic-video-generator
        • wan
          • wan-2.7/text-to-video
          • wan-2.2/text-to-video
        • skyreels
          • skyreels-v4/text-to-video
        • ltx
          • ltx-2.3/text-to-video
          • ltx-2.3/text-to-video-lora
        • pixverse
          • pixverse-v6/text-to-video
      • video-edit
        • wan-2.7/video-edit
        • kling-video-o3-pro/video-edit
        • kling-video-o3-std/video-edit
        • kling-video-o1-std/edit-video
        • xai/grok-imagine/edit-video-official-stable
      • motion-control
        • kling-v3.0-pro-motion-control
        • kling-v3.0-std-motion-control
        • kling-v2.6-pro-motion-control
        • bytedance/dreamactor-v2
        • kling-v2.6-std-motion-control
      • video-tools
        • sora-upload-character-official
        • pixverse-v6/extend
        • pixverse-v6/transition
        • sora-upload-character-channel-low-price
        • rh-video-upscaler
        • rh-video-fps-increaser
      • video-effects
        • skyreels-v3/video-restyling
      • video-extend
        • wan-2.7/video-extend
        • skyreels-v3/single-shot-video-extension
        • skyreels-v3/shot-switching-video-extension
      • audio-to-video
        • kling-lip-sync/identify-face
        • kling-lip-sync/lip-sync-video
    • 3D Generation & Processing
      • text-to-3D
        • hunyuan3d-v3.1/text-to-3d
      • image-to-3D
        • hitem3d-v15/image-to-3d
        • hunyuan3d-v3.1/image-to-3d
        • hitem3d-v2/image-to-3d
        • hitem3d-v15/multi-image-to-3d
        • hitem3d-v2/multi-image-to-3d
        • hitem3d-portrait-v21/image-to-3d
        • hitem3d-portrait-v21/multi-image-to-3d
        • hitem3d-portrait-v20/image-to-3d
        • hitem3d-portrait-v20/multi-image-to-3d
        • hitem3d-portrait-v15/image-to-3d
        • hitem3d-portrait-v15/multi-image-to-3d
    • Audio Generation & Processing
      • text-to-audio
        • minimax/speech-2.8-hd
        • minimax/music-2.5
        • minimax/speech-02-hd
        • minimax/speech-02-turbo
        • minimax/speech-2.6-hd
        • minimax/speech-2.6-turbo
        • minimax/speech-2.8-turbo
        • minimax/voice-clone
        • kling-lip-sync/tts
    • Image Generation & Processing
      • reference-to-image
        • Vidu-reference-to-video-q2-pro
      • image-to-image
        • midjourney
          • midjourney-text-to-image-niji6
          • midjourney-text-to-image-v61
          • midjourney-text-to-image-v6
          • midjourney-text-to-image-v7
        • seedream
          • seedream-v4.5/image-to-image
          • seedream-v4/image-to-image
          • seedream-v5-lite/image-to-image
        • nano
          • nano-banana2-gemini31flash/image-to-image-channel-low-price
          • nano-banana-pro/edit-channel-low-price
          • nano-banana2-gemini31flash/image-to-image-official-stable
          • nano-banana/edit-channel-low-price
          • nano-banana/edit-official-stable
          • nano-banana-pro/edit-ultra-official-stable
          • nano-banana-pro/edit-official-stable
        • gpt
          • gpt-image-1.5/edit-channel-low-price
        • grok
          • grok-image/image-to-image/channel-low-price
        • qwen
          • qwen-image/edit-2511-lora
          • qwen-image/edit-2511
          • qwen-image-2.0-pro/image-edit
          • qwen-image-2.0/image-edit
        • z
          • z-image-turbo/image-to-image-lora
          • z-image-turbo/image-to-image
        • wan
          • wan-2.2/image-to-image
        • f
          • f-kontext-dev-lora
          • f-2-dev/edit-lora
          • f-2-dev/edit
          • f-2-klein-9b/edit
          • f-2-klein-4b/edit
          • f-2-klein-4b/edit-lora
      • text-to-image
        • midjourney
          • midjourney-text-to-image-niji7
        • nano
          • nano-banana-pro/text-to-image-channel-low-price
          • nano-banana2-gemini31flash/text-to-image-official-stable
          • nano-banana/text-to-image-channel-low-price
          • nano-banana-pro/text-to-image-ultra-official-stable
          • nano-banana2-gemini31flash/text-to-image-channel-low-price
          • nano-banana-pro/text-to-image-official-stable
          • nano-banana/text-to-image-official-stable
        • gpt
          • gpt-image-1.5/text-to-image-official-stable
          • gpt-image-1.5/text-to-image-channel-low-price
          • gpt-image-1.5/image-to-image-official-stable
        • seedream
          • seedream-v4.5/text-to-image
          • seedream-v5-lite/text-to-image
          • seedream-v4/text-to-image
        • grok
          • grok-image/text-to-image/channel-low-price
        • qwen
          • qwen-image/text-to-image-2512
          • qwen-image/text-to-image-2512-lora
          • qwen-image-2.0/text-to-image
          • qwen-image-2.0-pro/text-to-image
        • z
          • z-image/turbo-lora
          • z-image/turbo
        • wan
          • wan-2.2/text-to-image-lora
          • wan-2.7/text-to-image-pro
          • wan-2.7/text-to-image
        • f
          • f-krea-dev-lora
          • f-dev-lora
          • f-2-dev/text-to-image-lora
          • f-2-dev/text-to-image
          • f-2-klein-9b/text-to-image-lora
          • f-2-klein-9b/text-to-image
          • f-2-klein-4b/text-to-image
          • f-2-klein-4b/text-to-image-lora
          • f-dev
      • image-tools
        • wan-2.7/image-edit-pro
        • wan-2.7/image-edit
    • Other
      • pixverse-v5.6/text-to-video
      • pixverse-v5.6/image-to-video
  • Task Query & webhook
    • Check Task Status
    • Check Task Output
    • Get Webhook Event Details
    • Resend Specific Webhook Event
    • Query generation result (V2)
  • ComfyUI Workflows
    • Start ComfyUI Task 1 - Basic
    • Start ComfyUI Task 2 - Advanced
    • Get Workflow JSON
    • Cancel ComfyUI Task
  • AI App
    • Start AI App Task
    • Get API call examples for AI application
  • Resource Upload
    • 文件上传(新)
    • Upload Resource(image\video\audio\Compressed Files)
    • Upload Lora
  • Get Account Information
    POST
  • Schemas
    • Get Workflow JSON Request
    • TaskRunWebappByKeyRequest
    • Generate task submission results
    • Get Workflow JSON Response
    • Start ComfyUI Task Request 1
    • Start ComfyUI Task Request 2
    • Start ComfyUI Task Request -webhook
    • Start ComfyUI Task Response
    • TaskCreateResponse
    • Check Task Status Request
    • Node Input Information
    • Get Account Information Request
    • Upload Resource Request
    • Get Webhook Event Details Request
    • Resend Specific Webhook Request
    • R?
    • RWorkflowDuplicateResponse
    • RAccountStatusResponse
    • WorkflowDuplicateResponse
    • AccountStatusResponse
    • WorkflowDuplicateRequest
    • ApiUploadLoraRequest
    • RString
    • RTaskUploadResponse
    • TaskUploadResponse
  1. reference-to-video

wan-2.7-reference-to-video

POST
/openapi/v2/alibaba/wan-2.7/reference-to-video
Wan 2.7 Reference-to-Video is an advanced AI model that transforms character, prop, or scene references from existing media into entirely new video shots. By uploading reference materials (requiring at least 1 reference image or video, up to a combined maximum of 5), alongside text prompts, the model generates smooth videos that strictly preserve the original identity and visual style. Supporting 720P and 1080P resolutions and equipped with negative prompt capabilities, it seamlessly brings your visual assets into fresh contexts with remarkable consistency.

Request

Authorization
Header Params

Body Params application/jsonRequired

Example
{
    "prompt": "Video 1 is eating, Picture 1 is singing next to it",
    "videoUrls": [
        "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/hfugmr/wan-r2v-role1.mp4"
    ],
    "imageUrls": [
        "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qpzxps/wan-r2v-object4.png"
    ],
    "resolution": "1080P",
    "duration": "5",
    "aspectRatio": "16:9",
    "promptExtend": true
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://www.runninghub.ai/openapi/v2/alibaba/wan-2.7/reference-to-video' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "Video 1 is eating, Picture 1 is singing next to it",
    "videoUrls": [
        "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/hfugmr/wan-r2v-role1.mp4"
    ],
    "imageUrls": [
        "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qpzxps/wan-r2v-object4.png"
    ],
    "resolution": "1080P",
    "duration": "5",
    "aspectRatio": "16:9",
    "promptExtend": true
}'

Responses

🟢200成功
application/json
Task result query endpoint: /openapi/v2/query
Body

Examples
{
    "taskId": "2013508786110730241",
    "status": "RUNNING",
    "errorCode": "",
    "errorMessage": "",
    "results": null,
    "clientId": "f828b9af25161bc066ef152db7b29ccc",
    "promptTips": "{\"result\": true, \"error\": null, \"outputs_to_execute\": [\"4\"], \"node_errors\": {}}"
}
Modified at 2026-04-09 12:00:02
Previous
pixverse-v6/image-to-video
Next
skyreels-v3/reference-to-video
Built with