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
  • Integration Example
    • Complete integration example
    • Complete Integration Example – Advanced Edition
    • Task Progress Display Example
    • Full Workflow Integration Example
  • 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
      POST
    • Start ComfyUI Task 2 - Advanced
      POST
    • Get Workflow JSON
      POST
    • Cancel ComfyUI Task
      POST
  • 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-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-std-image-to-video
          • kling-video-o3-4k-image-to-video
          • kling-video-o1/image-to-video
          • kling-v3.0-4k-image-to-video
          • kling-video-o1/start-to-end
          • kling-v2.5-turbo-std/image-to-video
          • kling-elements
          • kling-v2.5-turbo-pro/image-to-video
          • kling-video-o3-pro-image-to-video
          • kling-v3.0-pro-image-to-video
          • kling-video-o3-std-image-to-video
          • kling-v2.6-pro-image-to-video
        • seedance
          • seedance-v1.5-pro-image-to-video-fast
          • seedance-v1.5-pro-image-to-video
          • seedance-2.0-global/image-to-video
          • seedance-2.0-global-fast/image-to-video
        • hailuo
          • hailuo-02-standard
          • hailuo-02-i2v-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
        • google
          • veo3.1
            • google/veo3.1-fast/image-to-video-channel-low-price
            • google/veo3.1-lite/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
            • google/veo3.1-fast/image-to-video-official-stable
            • google/veo3.1-pro/start-end-to-video-channel-low-price
        • sora
          • sora-2/image-to-video-realistic-official-stable
          • sora-2/text-to-video-pro-official-stable
          • sora-2/image-to-video-pro-official-stable
          • sora-2/image-to-video-pro-channel-low-price
          • sora-2/image-to-video-official-stable
          • sora-2/image-to-video-channel-low-price
        • wan
          • wan-2.6-reference-to-video
          • wan-2.5-preview/image-to-video
          • wan-2.2-video/start-to-end
          • wan-2.6-reference-to-video-flash
          • wan-2.6-image-to-video-flash
          • wan-2.2/image-to-video
          • wan-2.7/image-to-video
        • ltx
          • ltx-2.3/image-to-video
          • ltx-2.3/image-to-video-lora
        • xai
          • grok
            • xai/grok-imagine/image-to-video-channel-low-price
            • xai/grok-imagine/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
      • reference-to-video
        • kling-video-o3-4k-reference-to-video
        • Vidu-reference-to-video-q2
        • kling-video-o1-std/refrence-to-video
        • seedance-v1-lite-reference-to-video
        • Vidu-reference-to-video-q3-mix
        • Vidu-reference-to-video-q3
        • wan-2.7-reference-to-video
        • kling-video-o3-pro/reference-to-video
        • kling-video-o3-std/reference-to-video
        • xai/grok-imagine-video/reference-to-video-official-stable
        • seedance-2.0-global/multimodal-video
        • seedance-2.0-global-fast/multimodal-video
        • happyhorse-1.0/reference-to-video
      • text-to-video
        • Vidu
          • Vidu-text-to-video-q2
          • Vidu-text-to-video-q3-pro
          • Vidu-text-to-video-q3-turbo
        • kling
          • kling-video-o3-4k-text-to-video
          • kling-video-o1/text-to-video
          • kling-v3-4k-text-to-video
          • kling-v2.5-turbo-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-v3.0-pro-text-to-video
          • kling-v3.0-std-text-to-video
          • kling-v2.5-turbo-std/text-to-video
        • seedance
          • seedance-v1.5-pro-text-to-video-fast
          • seedance-v1.5-pro-text-to-video
          • seedance-2.0-global/text-to-video
          • seedance-2.0-global-fast/text-to-video
        • hailuo
          • hailuo-02-pro
          • hailuo-02-t2v-standard
          • hailuo-2.3-t2v-standard
          • hailuo-2.3-t2v-pro
          • hailuo-02-t2v-pro
        • google
          • veo3.1
            • google/veo3.1-fast/text-to-video-channel-low-price
            • google/veo3.1-lite/start-end-to-video-official-stable
            • google/veo3.1-pro/text-to-video-channel-low-price
            • google/veo3.1-lite/text-to-video-official-stable
            • 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-official-stable
        • xai
          • grok
            • xai/grok-imagine/text-to-video-official-stable
            • xai/grok-imagine/text-to-video-channel-low-price
        • wan
          • wan-2.5-preview/text-to-video
          • wan-2.2/text-to-video
          • wan-2.7/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-pro-channel-low-price
          • sora-2/text-to-video-official-stable
          • sora-2/text-to-video-channel-low-price
        • pixverse
          • pixverse-v6/text-to-video
        • happyhorse
          • happyhorse-1.0/text-to-video
      • video-edit
        • kling-video-o1-std/edit-video
        • xai/grok-imagine/edit-video-official-stable
        • wan-2.7/video-edit
        • kling-video-o3-pro/video-edit
        • kling-video-o3-std/video-edit
        • happyhorse-1.0/video-edit
      • video-tools
        • pixverse-v6/extend
        • sora-upload-character-channel-low-price
        • pixverse-v6/transition
        • rh-video-fps-increaser
        • rh-video-upscaler
      • motion-control
        • kling-v2.6-pro-motion-control
        • bytedance/dreamactor-v2
        • kling-v2.6-std-motion-control
        • kling-v3.0-pro-motion-control
        • kling-v3.0-std-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
    • 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/image-to-image
          • seedream-v5-lite/image-to-image
          • seedream-v4.5/image-to-image
        • grok
          • grok-image/image-to-image/channel-low-price
        • f
          • f-2-klein-4b/edit
          • f-kontext-dev-lora
          • f-2-klein-4b/edit-lora
          • f-2-dev/edit-lora
          • f-2-dev/edit
          • f-2-klein-9b/edit
        • qwen
          • 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.5-preview/image-to-image
          • wan-2.2/image-to-image
        • midjourney
          • midjourney-text-to-image-v6
        • nano
          • nano-banana2-gemini31flash/image-to-image-channel-low-price
          • nano-banana2-gemini31flash/image-to-image-official-stable
          • nano-banana/edit-official-stable
          • nano-banana-pro/edit-official-stable
          • nano-banana-pro/edit-channel-low-price
          • nano-banana-pro/edit-ultra-official-stable
          • nano-banana/edit-channel-low-price
        • gpt
          • gpt-image-2/image-to-image-official-stable
          • gpt-image-2.0/edit-channel-low-price
          • gpt-image-1.5/edit-channel-low-price-[Deprecated] Please use gpt-image-2 instead
          • gpt-image-1.5/image-to-image-official-stable
        • xai
          • grok
            • xai/grok-imagine-image/edit-official-stable
      • text-to-image
        • seedream
          • seedream-v4/text-to-image
          • seedream-v4.5/text-to-image
          • seedream-v5-lite/text-to-image
        • grok
          • grok-image/text-to-image/channel-low-price
        • qwen
          • qwen-image/text-to-image-2512-lora
          • 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-klein-4b/text-to-image-lora
          • 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-dev
        • wan
          • wan-2.5-preview/text-to-image
          • wan-2.7/text-to-image-pro
          • wan-2.2/text-to-image-lora
          • wan-2.7/text-to-image
        • midjourney
          • midjourney-text-to-image-niji7
          • midjourney-text-to-image-niji6
          • midjourney-text-to-image-v61
          • midjourney-text-to-image-v7
        • nano
          • nano-banana2-gemini31flash/text-to-image-official-stable
          • nano-banana2-gemini31flash/text-to-image-channel-low-price
          • nano-banana/text-to-image-official-stable
          • nano-banana-pro/text-to-image-official-stable
          • nano-banana-pro/text-to-image-channel-low-price
          • nano-banana-pro/text-to-image-ultra-official-stable
          • nano-banana/text-to-image-channel-low-price
        • gpt
          • gpt-image-2/text-to-image-official-stable
          • gpt-image-2.0/text-to-image-channel-low-price
          • 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
        • xai
          • grok
            • xai/grok-imagine-image/text-to-image-official-stable
      • image-tools
        • wan-2.7/image-edit-pro
        • wan-2.7/image-edit
      • reference-to-image
        • Vidu-reference-to-video-q2-pro
          POST
    • Audio Generation & Processing
      • text-to-audio
        • kling-lip-sync/tts
        • minimax/speech-2.8-hd
        • minimax/speech-2.6-hd
        • minimax/speech-2.6-turbo
        • minimax/speech-2.8-turbo
        • minimax/music-2.5
        • minimax/voice-clone
        • minimax/speech-02-hd
        • minimax/speech-02-turbo
      • 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
      • text-to-lyrics
        • suno-lyrics
  • 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-04-23 02:17:48
Previous
wan-2.7/image-edit
Next
kling-lip-sync/tts
Built with