1. reference-to-video
RunningHub-API
  • Instructions for Use
  • Log of Update
  • Getting Started
    • About nodeInfoList
    • About Enterprise ComfyUI API
    • Native ComfyUI API Integration Guide
    • API Error Code Reference
  • Integration Example
    • Complete integration example
    • Complete Integration Example – Advanced Edition
    • Task Progress Display Example
    • Full Workflow Integration Example
  • 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
  • Standard Model API
    • Video Generation & Processing
      • image-to-video
        • Vidu
          • Vidu-image-to-video-q2-pro-fast
          • Vidu-start-end-to-video-q3-turbo
          • Vidu-image-to-video-q3-turbo
          • Vidu-start-end-to-video-q3-pro
          • Vidu-image-to-video-q3-pro
          • Vidu-image-to-video-q2-turbo
          • Vidu-image-to-video-q2-pro
          • Vidu-start-end-to-video-q2-turbo
          • Vidu-start-end-to-video-q2-pro
          • Vidu-start-end-to-video-q2-pro-fast
        • kling
          • kling-v2.5-turbo-pro/image-to-video
          • kling-v3.0-std-image-to-video
          • kling-v2.5-turbo-std/image-to-video
          • kling-v3.0-pro-image-to-video
          • kling-video-o1/image-to-video
          • kling-video-o3-std-image-to-video
          • kling-video-o1/start-to-end
          • kling-video-o3-pro-image-to-video
          • kling-v3-turbo-std-image-to-video
          • kling-v2.6-pro-image-to-video
          • kling-v3-turbo-pro-image-to-video
          • kling-elements
          • kling-v2.6-std-image-to-video
          • kling-v3.0-4k-image-to-video
          • kling-video-o3-4k-image-to-video
        • seedance
          • seedance-2.0/image-to-video
          • seedance-v1.5-pro-image-to-video-fast
          • seedance-2.5/image-to-video Token
          • seedance-2.0-fast/image-to-video
          • seedance-v1.5-pro-image-to-video
          • seedance-2.5-global/image-to-video Token
          • seedance-2.0-global-mini/image-to-video
          • seedance-2.0-mini/image-to-video
          • seedance-2.0-global-fast/image-to-video
          • seedance-2.0-global/image-to-video
        • hailuo
          • hailuo-02-fast
          • hailuo-02-standard
          • hailuo-02-i2v-pro
          • hailuo-2.3/i2v-pro
          • hailuo-2.3-fast-pro/image-to-video
          • hailuo-2.3-fast/image-to-video
          • hailuo-2.3/i2v-standard
          • hailuo-02-i2v-standard
        • midjourney
          • midjourney-image-to-video
        • google
          • veo3.1
            • google/veo3.1-pro/image-to-video-official-stable
            • google/veo3.1-pro/reference-to-video-official-stable
            • google/veo3.1-fast/image-to-video-official-stable
            • google/veo3.1-lite/image-to-video-official-stable
            • google/veo3.1-fast/image-to-video-channel-low-price
            • google/veo3.1-fast/start-end-to-video-channel-low-price
            • google/veo3.1-pro/image-to-video-channel-low-price
            • google/veo3.1-pro/start-end-to-video-channel-low-price
        • sora
          • sora-2/image-to-video-pro-channel-low-price
          • sora-2/image-to-video-realistic-official-stable
          • sora-2/image-to-video-official-stable
          • sora-2/text-to-video-pro-official-stable
          • sora-2/image-to-video-pro-official-stable
          • sora-2/image-to-video-channel-low-price
        • wan
          • wan-2.6-reference-to-video-flash
          • wan-2.6-reference-to-video
          • wan-2.6-image-to-video-flash
          • wan-2.2/image-to-video
          • wan-2.5-preview/image-to-video
          • wan-2.2-video/start-to-end
          • wan-2.7-spicy/image-to-video
          • wan-2.7/image-to-video
        • ltx
          • ltx-2.3/image-to-video-lora
          • ltx-2.3/image-to-video
        • xai
          • grok
            • xai/grok-imagine/image-to-video-channel-low-price-v1.5
            • xai/grok-imagine/image-to-video-official-stable
          • xai/grok-imagine-video-v1.5/image-to-video-official-stable
        • alibaba
          • wan
            • alibaba/wan-2.6/image-to-video
        • pixverse
          • pixverse-v6/image-to-video
        • happyhorse
          • happyhorse-1.0/image-to-video
          • happyhorse-1.1/image-to-video
        • skyreels
          • skyreels-v4/image-to-video-std
          • skyreels-v4/image-to-video-fast
        • gemini
          • gemini-omni-flash/image-to-video/channel-low-price
        • Stephen Chow IP Video Gen(Seedance 2.0)
          • Stephen Chow IP Video Gen(Seedance 2.0)
        • Stephen Chow IP Video Gen
          • Stephen Chow IP Video Gen-Fast (Seedance 2.0 Fast)
        • MiniMax
          • MiniMax-H3 Image-to-Video (first/last frame)
        • flux
          • flux-3-video/image-to-video
        • MiniMax H3 fl2va RH插件流 支持文生、图生、首尾帧
          • MiniMax H3 fl2va RH插件流 支持文生、图生、首尾帧
      • reference-to-video
        • seedance-2.0/multimodal-video
          POST
        • seedance-v1-lite-reference-to-video
          POST
        • MiniMax-H3 Multimodal Reference-to-Video
          POST
        • seedance-2.0-fast/multimodal-video
          POST
        • wan-2.7-reference-to-video
          POST
        • seedance-2.5/multimodal-video Token
          POST
        • happyhorse-1.0/reference-to-video
          POST
        • seedance-2.5-global/multimodal-video Token
          POST
        • xai/grok-imagine-video/reference-to-video-official-stable
          POST
        • google/veo3.1-fast/reference-to-video-official-stable
          POST
        • Vidu-reference-to-video-q2
          POST
        • Vidu-reference-to-video-q3
          POST
        • skyreels-v4/omni-reference-fast
          POST
        • happyhorse-1.1/reference-to-video
          POST
        • skyreels-v4/omni-reference-std
          POST
        • Vidu-reference-to-video-q3-drama
          POST
        • kling-video-o1-std/refrence-to-video
          POST
        • seedance-2.0-global-mini/multimodal-video
          POST
        • kling-video-o3-std/reference-to-video
          POST
        • seedance-2.0-mini/multimodal-video
          POST
        • kling-video-o3-pro/reference-to-video
          POST
        • Vidu-reference-to-video-q3-ad
          POST
        • kling-video-o3-4k-reference-to-video
          POST
        • seedance-2.0-global/multimodal-video
          POST
        • Vidu-reference-to-video-q3-mix
          POST
        • seedance-2.0-global-fast/multimodal-video
          POST
        • xai/grok-imagine-video-v1.5/reference-to-video-official-stable
          POST
        • MiniMax H3 ref2va RH插件流 支持多参
          POST
      • text-to-video
        • Vidu
          • Vidu-text-to-video-q3-turbo
          • Vidu-text-to-video-q3-pro
          • Vidu-text-to-video-q2
        • kling
          • kling-v2.5-turbo-pro/text-to-video
          • kling-v3.0-std-text-to-video
          • kling-video-o1/text-to-video
          • kling-v3.0-pro-text-to-video
          • kling-v2.6-pro-text-to-video
          • kling-video-o3-std-text-to-video
          • kling-video-o3-pro-text-to-video
          • kling-v2.5-turbo-std/text-to-video
          • kling-v3-turbo-std-text-to-video
          • kling-v3-turbo-pro-text-to-video
          • kling-v3-4k-text-to-video
          • kling-video-o3-4k-text-to-video
          • kling-v2.6-std-text-to-video
        • seedance
          • seedance-2.0/text-to-video
          • seedance-2.5/text-to-video Token
          • seedance-v1.5-pro-text-to-video-fast
          • seedance-2.0-fast/text-to-video
          • seedance-2.5-global/text-to-video Token
          • seedance-v1.5-pro-text-to-video
          • seedance-2.0-global-mini/text-to-video
          • seedance-2.0-mini/text-to-video
          • seedance-2.0-global-fast/text-to-video
          • seedance-2.0-global/text-to-video
        • hailuo
          • hailuo-02-pro
          • hailuo-2.3-t2v-standard
          • hailuo-02-t2v-standard
          • hailuo-2.3-t2v-pro
          • hailuo-02-t2v-pro
        • google
          • veo3.1
            • google/veo3.1-pro/text-to-video-official-stable
            • google/veo3.1-fast/text-to-video-official-stable
            • google/veo3.1-fast/video-extend-official-stable
            • google/veo3.1-pro/video-extend-official-stable
            • google/veo3.1-lite/text-to-video-official-stable
            • google/veo3.1-lite/start-end-to-video-official-stable
            • google/veo3.1-fast/text-to-video-channel-low-price
            • google/veo3.1-pro/text-to-video-channel-low-price
        • xai
          • grok
            • xai/grok-imagine/text-to-video-official-stable
            • xai/grok-imagine/text-to-video-channel-low-price-v1.5
          • xai / grok-imagine-video-v1.5 / text-to-video-official-stable
        • wan
          • wan-2.7/text-to-video
          • wan-2.5-preview/text-to-video
          • wan-2.2/text-to-video
        • ltx
          • ltx-2.3/text-to-video
          • ltx-2.3/text-to-video-lora
        • alibaba
          • wan
            • alibaba/wan-2.6/text-to-video
        • sora
          • sora-2/text-to-video-official-stable
          • sora-2/text-to-video-channel-low-price
          • sora-2/text-to-video-pro-channel-low-price
        • pixverse
          • pixverse-v6/text-to-video
        • happyhorse
          • happyhorse-1.1/text-to-video
          • happyhorse-1.0/text-to-video
        • skyreels
          • skyreels-v4/text-to-video-std
          • skyreels-v4/text-to-video-fast
        • gemini
          • gemini-omni-flash/text-to-video/channel-low-price
        • MiniMax
          • MiniMax-H3 Text-to-Video
        • flux
          • flux-3-video/text-to-video
      • video-edit
        • wan-2.7/video-edit
        • happyhorse-1.0/video-edit
        • xai/grok-imagine/edit-video-official-stable
        • gemini-omni-flash/video-edit/channel-low-price
        • kling-video-o1-std/edit-video
        • kling-video-o3-std/video-edit
        • kling-video-o3-pro/video-edit
      • video-tools
        • volc-subtitle-erase/video(Refined version)
        • sora-upload-character-channel-low-price
        • volc-subtitle-erase/video(Standard Version)
        • rh-video-fps-increaser
        • rh-video-upscaler
        • vidu/short-play-q3-drama
        • kling-o3/element
        • vidu/short-play-q3-ad
        • pixverse-v6/transition
        • pixverse-v6/extend
        • topazlabs-video-frame-interpolation
        • topazlabs-video-astra
        • topazlabs-video-denoise
        • topazlabs-video-starlight
      • motion-control
        • bytedance/dreamactor-v2
        • kling-v2.6-std-motion-control
        • kling-v2.6-pro-motion-control
        • kling-v3.0-std-motion-control
        • kling-v3.0-pro-motion-control
      • audio-to-video
        • kling-lip-sync/identify-face
        • kling-lip-sync/lip-sync-video
      • video-extend
        • wan-2.7/video-extend
        • xai/grok-imagine-video/video-extend-official-stable
        • topazlabs-video-proteus
      • video-to-video
        • Wan2.2 Character Motion Transfer
        • flux-3-video/draft-enhance
        • flux-3-video/video-continuation
      • digital-human
        • kling-v2-ai-avatar-standard/image-audio-to-video
        • kling-v2-ai-avatar-pro/image-audio-to-video
    • 3D Generation & Processing
      • text-to-3D
        • hunyuan3d-v3.1/text-to-3d
      • 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
        • hitem3d-v15/image-to-3d
    • Image Generation & Processing
      • image-to-image
        • seedream
          • seedream-v4.5/image-to-image
          • seedream-v4/image-to-image
          • seedream-v5-lite/image-to-image
          • seedream-v5-pro/image-to-image
        • grok
          • grok-image/image-to-image/channel-low-price
        • f
          • 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
          • f-kontext-dev-lora
        • qwen
          • qwen-image-3.0/image-edit
          • qwen-image-3.0-pro/image-edit
          • qwen-image/edit-2511-lora
          • qwen-image/edit-2511
          • qwen-image-2.0/image-edit
          • qwen-image-2.0-pro/image-edit
        • z
          • z-image-turbo/image-to-image-lora
          • z-image-turbo/image-to-image
        • wan
          • wan-2.2/image-to-image
          • wan-2.5-preview/image-to-image
        • midjourney
          • midjourney-text-to-image-v8.1
          • midjourney-text-to-image-v6
        • nano
          • nano-banana-pro/edit-official-stable
          • nano-banana/edit-official-stable
          • nano-banana-pro/edit-ultra-official-stable
          • nano-banana2-gemini31flash/image-to-image-official-stable
          • nano-banana/edit-channel-low-price
          • nano-banana2-gemini31flash-lite/image-to-image-official-stable
          • nano-banana2-gemini31flash-lite/image-to-image-channel-low-price
          • nano-banana-pro/edit-channel-low-price
          • nano-banana2-gemini31flash/image-to-image-channel-low-price
        • gpt
          • gpt-image-1.5/edit-channel-low-price-[Deprecated] Please use gpt-image-2 instead
          • gpt-image-1.5/image-to-image-official-stable
          • gpt-image-2.0/edit-channel-low-price
          • gpt-image-2/image-to-image-official-stable
        • xai
          • grok
            • xai/grok-imagine-image/edit-official-stable
          • rhart
            • xai/rhart-imagine-image-quality/edit-official-stable
        • bytedance
          • jimeng
            • bytedance/jimeng-4.6/image-to-image
        • Dola
          • Dola-Seedream-5.0-pro/image-to-image
        • topazlabs
          • topazlabs-image-gigapixel-low-resolution-2
          • topazlabs-image-gigapixel-standard-2
      • text-to-image
        • seedream
          • seedream-v4.5/text-to-image
          • seedream-v4/text-to-image
          • seedream-v5-lite/text-to-image
          • seedream-v5-pro/text-to-image
        • grok
          • grok-image/text-to-image/channel-low-price
        • qwen
          • qwen-image-3.0/text-to-image
          • qwen-image/text-to-image-2512-lora
          • qwen-image-3.0-pro/text-to-image
          • qwen-image/text-to-image-2512
          • qwen-image-2.0/text-to-image
          • qwen-image-2.0-pro/text-to-image
        • z
          • z-image/turbo-lora
          • z-image/turbo
        • f
          • 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-krea-dev-lora
          • f-dev-lora
          • f-dev
        • wan
          • wan-2.2/text-to-image-lora
          • wan-2.5-preview/text-to-image
          • wan-2.7/text-to-image-pro
          • wan-2.7/text-to-image
        • midjourney
          • midjourney-text-to-image-v7
          • midjourney-text-to-image-niji7
          • midjourney-text-to-image-niji6
          • midjourney-text-to-image-v61
          • midjourney-text-to-image-v8.2-preview
        • nano
          • nano-banana-pro/text-to-image-official-stable
          • nano-banana/text-to-image-official-stable
          • nano-banana-pro/text-to-image-ultra-official-stable
          • nano-banana2-gemini31flash/text-to-image-official-stable
          • nano-banana/text-to-image-channel-low-price
          • nano-banana2-gemini31flash-lite/text-to-image-official-stable
          • nano-banana-pro/text-to-image-channel-low-price
          • nano-banana2-gemini31flash-lite/text-to-image-channel-low-price
          • nano-banana2-gemini31flash/text-to-image-channel-low-price
        • gpt
          • gpt-image-1.5/text-to-image-official-stable
          • gpt-image-1.5/text-to-image-channel-low-price-[Deprecated] Please use gpt-image-2 instead
          • gpt-image-2.0/text-to-image-channel-low-price
          • gpt-image-2/text-to-image-official-stable
        • xai
          • grok
            • xai/grok-imagine-image/text-to-image-official-stable
          • rhart
            • xai/rhart-imagine-image-quality/text-to-image-official-stable
        • bytedance
          • jimeng
            • bytedance/jimeng-4.6/text-to-image
        • Dola
          • Dola-Seedream-5.0-pro/text-to-image
      • image-tools
        • wan-2.7/image-edit-pro
        • wan-2.7/image-edit
        • topazlabs-image-gigapixel-text-and-shapes
      • reference-to-image
        • Vidu-reference-to-video-q2-pro
      • image-effects
        • topazlabs-image-gigapixel-high-fidelity-2
        • topazlabs-image-gigapixel-art-and-cgi
        • topazlabs-image-upscale-transparent
        • topazlabs-image-upscale-detail-faces
        • topazlabs-image-upscale-high-fidelity-v3
    • Audio Generation & Processing
      • text-to-audio
        • minimax/speech-2.8-hd
        • mureka-v7.6/generate-bgm
        • minimax/speech-02-hd
        • minimax/speech-02-turbo
        • minimax/speech-2.6-hd
        • minimax/speech-2.6-turbo
        • minimax/speech-2.8-turbo
        • minimax/music-2.5
        • minimax/voice-clone
        • minimax/music-2.6/text-to-instrumental
        • minimax/music-2.6/text-to-music
        • minimax/music-cover
        • minimax/music-cover-preprocess
        • minimax/music-2.6
        • doubao-seed-tts-2.0
        • doubao-seed-audio-1.0
        • mureka-v9/generate-bgm
        • kling-lip-sync/tts
        • mureka-v8/generate-bgm
        • qwen3-tts-instruct-flash
        • qwen3-tts-flash
      • text-to-music
        • suno-single-v5.5
        • suno-custom-v5.5
        • suno-single-v5
        • suno-custom-v5
        • suno-single-v4.5
        • suno-custom-v4.5
        • mureka-v7.6/generate-song
        • mureka-o2/generate-song
        • mureka-v8/generate-song
        • mureka-v9/generate-song
      • text-to-lyrics
        • suno-lyrics
        • mureka-ai/generate-lyrics
      • video-to-audio
        • Separate audio Other
        • Separate audio Vocals
        • Separate audio
      • upload-file
        • mureka-ai/files-upload
      • audio-to-audio
        • mureka-v7.6/extend-song
        • mureka-v8/extend-song
        • mureka-ai/vocal-clone
    • Other
      • seedream-v5-pro/layer-decomposition
      • MiniMax-H3 Multimodal Reference-to-Video Regeneration (768P->2K)
      • MiniMax-H3 Image-to-Video Regeneration (768P->2K)
      • MiniMax-H3-Context-IR (i2va)
      • MiniMax-H3 Text-to-Video Regeneration (768P->2K)
      • MiniMax-H3-Context-IR (t2va)
      • MiniMax-H3-Context-IR (r2va)
  • 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 'https://www.runninghub.ai/openapi/v2/alibaba/wan-2.7/reference-to-video' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data '{
    "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
Bodyapplication/json

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-07-30 07:05:27
Previous
seedance-2.0-fast/multimodal-video
Next
seedance-2.5/multimodal-video Token
Built with