{"uid":"cap_QcPObMVcw0I4glWBTd-ik","slug":"agents-vimmerse-net-vimmerse-reference-to-video-bdbf8859","name":"Vimmerse Reference to Video","description":"Generates video from **`image_urls`** (at least one) and **`prompt`**.\n\n**`option`:** `AutoR`, `KlingT3`, `HappyHorse`, `Grok`, `SeedanceFast`, `VeoReference`, `ViduReference`, `HeygenAgent`, `PikaScenes`, `MinimaxHailuo`\n\n**`duration`:** seconds (1–30).\n\n**`elements`:** optional. A string is one image URL (existing clients). A group is an array of 1 to 4 public image URLs for one subject. Index 0 is the frontal image. Indexes 1–3 are other angles.\n\n```json\n\"elements\": [\n  \"https://example.com/hero-front.png\",\n  [\"https://example.com/hero-front.png\", \"https://example.com/hero-side.png\"]\n]\n```","url":"https://agents.vimmerse.net/v2/video/reference-to-video?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"ReferenceToVideoRequest","required":["image_urls"],"properties":{"option":{"type":"string","title":"Video generation tool","default":"KlingT3"},"prompt":{"type":"string","title":"Prompt","default":""},"duration":{"type":"integer","title":"Duration (seconds)","default":5,"maximum":30,"minimum":1},"elements":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"title":"Element image groups","examples":[["https://example.com/hero-front.png"],[["https://example.com/hero-front.png","https://example.com/hero-side.png"]]],"description":"Optional element images. A string entry is one image URL, which is what existing clients send. A group is an array of 1 to 4 public image URLs for one subject: index 0 is the frontal image, indexes 1 to 3 are other angles. Group example: [[\"https://example.com/hero-front.png\",\"https://example.com/hero-side.png\"]]"},"quantity":{"type":"integer","title":"Quantity","default":1,"maximum":4,"minimum":1},"async_mode":{"type":"boolean","title":"Async Mode","default":false},"image_urls":{"type":"array","items":{"type":"string"},"title":"Reference image URLs","minItems":1,"description":"Public https URLs of reference images. At least one."},"webhook_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Webhook URL"},"aspect_ratio":{"type":"string","title":"Aspect Ratio","default":"16:9","pattern":"^(\\d+):(\\d+)$"}}},"responseSchema":{},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"2.4","displayCostAsset":"USDC","priceDynamic":true,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"dynamic","summary":"$2.4/call (dynamic — varies by input)","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_jrfp7n0952vSNaR3YbXdf","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.vimmerse.net","brandSlug":"agents-vimmerse-net-x402","brandBaseUrl":"https://agents.vimmerse.net","brandDocsUrl":null,"whatItDoes":"Generates a video clip from one or more reference images and a text prompt, with selectable AI model and duration.","exampleAgentPrompt":"Take this front-facing product image (https://example.com/product-front.png) and this side-angle image (https://example.com/product-side.png) and generate a 10-second 16:9 video using KlingT3 with the prompt 'the product slowly rotates on a sleek dark surface'.","exampleUseCases":[{"title":"Animate product photos for e-commerce","prompt":"I have two photos of my sneaker — a front shot at https://cdn.store.com/shoe-front.png and a side shot at https://cdn.store.com/shoe-side.png. Can you generate an 8-second video using KlingT3 with the prompt 'sneaker rotating on a clean white background, cinematic lighting'?"},{"title":"Bring a character illustration to life","prompt":"Animate this character illustration into a 5-second video — here's the image: https://art.mygame.com/hero-front.png. Use the prompt 'the hero stands tall and wind blows through their cape, dramatic lighting', and pick the ViduReference model."},{"title":"Create social media video from a single photo","prompt":"Turn this portrait photo (https://myphotos.net/portrait.jpg) into a short 6-second video with the prompt 'gentle head turn with soft bokeh background' using PikaScenes and a 9:16 aspect ratio for Instagram Reels."}],"resultDescription":"Returns a video generation result, which may include a media object ID, status, and video URL depending on async_mode. In synchronous mode the response contains the completed video data; in async mode you receive a job ID to poll until the video is ready.","failureModes":["No image_urls provided — request rejected with validation error","Invalid or inaccessible image URL — fetch failure or timeout","Unsupported option value — model not recognized","Duration out of range (< 1 or > 30 seconds) — validation error","Insufficient credits — payment/authorization failure","Timeout during video generation for long clips or complex models","Invalid aspect_ratio format — pattern mismatch error"],"whenToPreferThis":"Choose this endpoint when you need to generate a video grounded in one or more specific reference images rather than purely from text. It is ideal when visual consistency with existing assets (products, characters, scenes) is required. Use it when you want to choose a specific underlying video AI model (e.g., KlingT3, VeoReference, PikaScenes) and control duration and aspect ratio. Prefer this over text-to-video when the output must reflect the appearance of real images.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T00:42:16.938Z","isFirstParty":false,"canonicalSlug":"agents-vimmerse-net-vimmerse-reference-to-video-bdbf8859"}