logo
RunComfy
  • ComfyUI
  • TrainerNew
  • Models
  • API
  • Pricing
discord logo
MODELS
Explore
All Models
LIBRARY
Generations
MODEL APIS
API Docs
API Keys
ACCOUNT
Usage

Wan 2.7 Reference to Video: High-Fidelity Reference-Based Video Generation on playground and API | RunComfy

wan-ai/wan-2.7/reference-to-video

Transform image, video, or audio references into full HD videos with precise motion control, strong subject fidelity, and consistent scene composition. Ideal for character-driven content, branded video localization, and instruction-based clip editing.

modelApiDoc_tableOfContents

modelApiDoc_nav1GetStartedmodelApiDoc_nav2AuthenticationmodelApiDoc_nav3ApiReferencemodelApiDoc_navSubmitRequestmodelApiDoc_navMonitorStatusmodelApiDoc_navRetrieveResultsmodelApiDoc_navCancelRequestmodelApiDoc_nav4FileInputsmodelApiDoc_navHostedFilemodelApiDoc_nav5SchemamodelApiDoc_navInputSchemamodelApiDoc_navOutputSchema

modelApiDoc_h2GetStarted

modelApiDoc_getStartedBeforeModelwan-ai/wan-2.7/reference-to-videomodelApiDoc_getStartedAfterModel modelApiDoc_getStartedMid modelApiDoc_schemaLinkmodelApiDoc_getStartedAfterSchema

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/wan-ai/wan-2.7/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Use the reference to keep the same product shape, materials, and colors; generate a 5-second clip with natural motion, medium framing, soft daylight, and a smooth camera follow."
  }'

modelApiDoc_h2Authentication

modelApiDoc_authP1 YOUR_API_TOKEN modelApiDoc_authP2 modelApiDoc_profilemodelApiDoc_authP3 Authorization modelApiDoc_authP4 Authorization: Bearer $YOUR_API_TOKENmodelApiDoc_authP5

modelApiDoc_h3ApiReference

modelApiDoc_h3SubmitRequest

modelApiDoc_submitBody

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/wan-ai/wan-2.7/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Use the reference to keep the same product shape, materials, and colors; generate a 5-second clip with natural motion, medium framing, soft daylight, and a smooth camera follow."
  }'

modelApiDoc_h3MonitorStatus

modelApiDoc_monitorBody

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

modelApiDoc_h3RetrieveResults

modelApiDoc_retrieveBody

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

modelApiDoc_h3CancelRequest

modelApiDoc_cancelBody

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

modelApiDoc_h2FileInputs

modelApiDoc_h3HostedFile

modelApiDoc_hostedFileBody

modelApiDoc_h2Schema

modelApiDoc_h3InputSchema

{
  "type": "object",
  "title": "modelApiDoc_navInputSchema",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "title": "Prompt",
      "description": "",
      "type": "string",
      "maxLength": 5000,
      "default": "Use the reference to keep the same product shape, materials, and colors; generate a 5-second clip with natural motion, medium framing, soft daylight, and a smooth camera follow."
    },
    "reference_image_urls": {
      "title": "Reference Image URLs",
      "description": "Reference image URLs for character or object appearance. Pass multiple images for multi-subject generation. Max 20 MB each. Combined total of reference images + reference videos must not exceed 5.",
      "type": "array",
      "items": {
        "type": "string",
        "format": "image_uri"
      },
      "maxItems": 5,
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7338/media-files/ref-promo.webp"
      ]
    },
    "reference_video_urls": {
      "title": "Reference Video URLs",
      "description": "Reference video URLs for character or object appearance and motion. Pass multiple videos for multi-subject generation. Max 100 MB each. Combined total of reference images + reference videos must not exceed 5.",
      "type": "array",
      "items": {
        "type": "string",
        "format": "video_uri"
      },
      "maxItems": 5
    },
    "negative_prompt": {
      "title": "Negative Prompt",
      "description": "Content to avoid in the video.",
      "type": "string",
      "maxLength": 500
    },
    "aspect_ratio": {
      "title": "Aspect Ratio (W:H)",
      "description": "",
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1",
        "4:3",
        "3:4"
      ],
      "default": "16:9"
    },
    "resolution": {
      "title": "Resolution",
      "description": "Output video resolution tier.",
      "type": "string",
      "enum": [
        "720p",
        "1080p"
      ],
      "default": "1080p"
    },
    "duration": {
      "title": "Duration",
      "description": "Output video duration in seconds (2-10).",
      "type": "integer",
      "enum": [
        2,
        3,
        4,
        5,
        6,
        7,
        8,
        9,
        10
      ],
      "default": 5
    },
    "multi_shots": {
      "title": "Multi Shots",
      "description": "When true, enables intelligent multi-shot segmentation. When false, generates a single continuous shot.",
      "type": "boolean",
      "default": false
    },
    "seed": {
      "title": "Seed",
      "description": "",
      "type": "integer",
      "minimum": 0,
      "maximum": 2147483647,
      "default": 0
    }
  }
}

modelApiDoc_h3OutputSchema

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "modelApiDoc_outDescImage"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "modelApiDoc_outDescVideo"
      },
      "images": {
        "type": "array",
        "description": "modelApiDoc_outDescImages",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "modelApiDoc_outDescVideos",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}
Follow us
  • LinkedIn
  • Facebook
  • Instagram
  • Twitter
Support
  • Discord
  • Email
  • System Status
  • Affiliate
Video Models
  • Elevenlabs Music
  • Wan 2.6 Flash
  • Seedance 1.0 Pro Fast
  • Hailuo 2.3 Fast Standard
  • Wan 2.6
  • Seedance 2.0 Pro
  • View All Models →
Image Models
  • Seedream 4.5
  • Nano Banana Pro
  • Nano Banana 2 Edit
  • Flux 2 Dev
  • Flux 2 Flash Edit
  • GPT Image 2 Image Edit
  • View All Models →
Legal
  • Terms of Service
  • Privacy Policy
  • Cookie Policy
RunComfy
Copyright 2026 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.