1. reference-to-image
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
      POST
    • Initiate Quick Create Task
      POST
  • 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
        • skyreels-v3/reference-to-video
        • Vidu-reference-to-video-q3
        • seedance-2.0/multimodal-video
        • Vidu-reference-to-video-q2
        • seedance-2.0-fast/multimodal-video
        • kling-video-o1-std/refrence-to-video
        • seedance-v1-lite-reference-to-video
        • skyreels-v4/omni-reference
        • Vidu-reference-to-video-q3-mix
      • 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
          POST
      • 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
      POST
    • Check Task Output
      POST
    • Get Webhook Event Details
      POST
    • Resend Specific Webhook Event
      POST
    • Query generation result (V2)
      POST
  • 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-image

Vidu-reference-to-video-q2-pro

POST
/openapi/v2/vidu/reference-to-video-q2-pro
Vidu Q2 Pro is the flagship evolution for high-precision video synthesis. It redefines "Reference-to-Video" by supporting multi-modal inputs, including up to 7 images or 2 video clips as control sources. Featuring its signature "AI Acting" capability, it delivers cinematic 1080p visuals with flawless subject consistency and subtle emotional nuances. It is the definitive tool for professionals seeking complete control over video editing and recurring character consistency.

Request

Authorization
Header Params

Body Params application/jsonRequired

Example
{
    "prompt": "Let the character in @Picture1 recreate the scene from @Video1.",
    "imageUrls": [
        "https://www.runninghub.cn/view?filename=4bfe72ddf7cd8a14033f137baea4602ba59ca4aa097e6b165d9a75be0f547454.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3Njk1ODY3MzY1NjAsInRzIjoxNzY4OTgxOTM2NTYwLCJzaWduIjoiNDE3NGI3ZTgyODk5N2ZjOWZjOTQ5Yjg3YWE2ZGEwN2MifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.38298866106307117"
    ],
    "videos": [
        "https://ys-static-1252422369.cos.ap-beijing.myqcloud.com/assets/oEABfZQgCGAeWDNcF39vNLb900ngAB2IIgHlgI.MOV"
    ],
    "aspectRatio": "16:9",
    "resolution": "720p",
    "duration": "5",
    "movementAmplitude": "auto"
}

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/vidu/reference-to-video-q2-pro' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "Let the character in @Picture1 recreate the scene from @Video1.",
    "imageUrls": [
        "https://www.runninghub.cn/view?filename=4bfe72ddf7cd8a14033f137baea4602ba59ca4aa097e6b165d9a75be0f547454.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3Njk1ODY3MzY1NjAsInRzIjoxNzY4OTgxOTM2NTYwLCJzaWduIjoiNDE3NGI3ZTgyODk5N2ZjOWZjOTQ5Yjg3YWE2ZGEwN2MifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.38298866106307117"
    ],
    "videos": [
        "https://ys-static-1252422369.cos.ap-beijing.myqcloud.com/assets/oEABfZQgCGAeWDNcF39vNLb900ngAB2IIgHlgI.MOV"
    ],
    "aspectRatio": "16:9",
    "resolution": "720p",
    "duration": "5",
    "movementAmplitude": "auto"
}'

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-03-10 12:42:16
Previous
kling-lip-sync/tts
Next
midjourney-text-to-image-niji6
Built with