## Basic tool info Model name: xai/grok-imagine-r2v Model description: Create short cinematic videos from a text prompt, guided by up to 16 reference images for consistent style and subjects. Built by xAI. Model cover: https://cdn.wiro.ai/uploads/models/xai-grok-imagine-r2v-cover.mp4 Model categories: - tool - partner - xai - image-to-video - nogpu-pipeline Run Task Endpoint (POST): https://api.wiro.ai/v1/Run/xai/grok-imagine-r2v Get Task Detail Endpoint (POST): https://api.wiro.ai/v1/Task/Detail ## Model Inputs: - name: inputImage label: Reference Images help: Required. Reference images to guide style and content. Max 20MiB each. Supported: jpg, jpeg, png. Max 7 images. type: combinefileinput default: xai-grok-image-r2v-input-1-1.jpg,xai-grok-image-r2v-input-1-2.jpg,xai-grok-image-r2v-input-1-3.jpg - name: prompt label: Prompt help: Required. Text description of the desired video. Use , , etc. to reference specific images. type: textarea default: Cinematic, sweeping crane shot transitioning from extreme macro to a vast wide-angle landscape. The shot begins at ground level on a bed of dry brown autumn leaves and pine needles, focusing tightly on a vibrant green oak leaf covered in perfectly spherical, physically accurate water droplets. The droplets subtly vibrate with a gentle breeze, reflecting the ambient light. The camera smoothly tilts up and tracks forward, seamlessly racking focus to reveal a serene, misty autumn wetland. Small, still pools of deep blue water perfectly reflect the sky, surrounded by vibrant golden marsh grasses and scattered pine trees. In the distance, rolling green and yellow forested hills rise toward a towering, rugged rocky mountain peak set against a dramatic, heavy cloudy sky. Flawless depth-of-field transition, perfectly stable water reflections, and rigid environmental geometry throughout the camera movement. - name: duration label: Duration help: Required. Video duration in seconds. type: select default: 5 options: - value: "5" label: 5 seconds - value: "10" label: 10 seconds - name: aspectRatio label: Aspect Ratio help: Required. type: select default: 16:9 options: - value: "16:9" label: 16:9 (Landscape) - value: "9:16" label: 9:16 (Portrait) - value: "1:1" label: 1:1 (Square) - value: "4:3" label: 4:3 - value: "3:4" label: 3:4 - value: "3:2" label: 3:2 - value: "2:3" label: 2:3 - name: resolution label: Resolution help: Required. type: select default: 480p options: - value: "480p" label: 480p - value: "720p" label: 720p ## Model Parameter Inspires: - prompt: Cinematic, sweeping crane shot transitioning from extreme macro to a vast wide-angle landscape. The shot begins at ground level on a bed of dry brown autumn leaves and pine needles, focusing tightly on a vibrant green oak leaf covered in perfectly spherical, physically accurate water droplets. The droplets subtly vibrate with a gentle breeze, reflecting the ambient light. The camera smoothly tilts up and tracks forward, seamlessly racking focus to reveal a serene, misty autumn wetland. Small, still pools of deep blue water perfectly reflect the sky, surrounded by vibrant golden marsh grasses and scattered pine trees. In the distance, rolling green and yellow forested hills rise toward a towering, rugged rocky mountain peak set against a dramatic, heavy cloudy sky. Flawless depth-of-field transition, perfectly stable water reflections, and rigid environmental geometry throughout the camera movement. - inputImage: https://cdn.wiro.ai/uploads/sampleinputs/xai-grok-image-r2v-input-1-1.jpg,https://cdn.wiro.ai/uploads/sampleinputs/xai-grok-image-r2v-input-1-2.jpg,https://cdn.wiro.ai/uploads/sampleinputs/xai-grok-image-r2v-input-1-3.jpg - prompt: Cinematic, slow-motion tracking shot moving through a dense, sunlit field of vibrant yellow tulips. A young woman with long dark hair, wearing an elegant white strapless gown with sheer, ruffled lace sleeves, walks gracefully through the blooming flowers. The delicate fabric of her dress catches the gentle breeze, displaying flawless cloth physics. She approaches a young man dressed in a dark black tunic and white turban, who is standing calmly on a dirt path intersecting the field, holding the reins of a majestic white horse with a black and gold saddle. The camera smoothly orbits the scene, maintaining a shallow depth of field that beautifully blurs the foreground and background tulips into a bright, warm bokeh. Highly detailed textures on the lace, the horse\'s realistic muscle movements, and perfectly stable floral geometry throughout the shot. - inputImage: https://cdn.wiro.ai/uploads/sampleinputs/xai-grok-image-r2v-input-2-1.jpg,https://cdn.wiro.ai/uploads/sampleinputs/xai-grok-image-r2v-input-2-2.jpg,https://cdn.wiro.ai/uploads/sampleinputs/xai-grok-image-r2v-input-2-3.jpg - prompt: Cinematic, slow-motion medium tracking shot on a brightly lit city street. The background is a highly detailed, weathered yellow wall densely covered in vibrant red graffiti, torn layers of paper, and a large, prominent poster featuring a winged man holding a gold trophy with the clearly legible text \'UN SOFFIO DI FIATO\'. Standing confidently in front of the wall are two stylish Black women. The woman on the left leans slightly against the textured wall; she wears a black leather jacket draped over her shoulder, a red crop top over a white collared shirt, and baggy, faded blue jeans. In her hands, she holds a vintage silver and dark leather rangefinder camera, her fingers naturally turning the metallic lens ring. A gold pocket watch with a purple face hangs from a delicate gold chain attached to her jeans\' belt loop, swaying with accurate pendulum physics. Beside her stands the second woman with an afro puff, wearing a maroon leather jacket, a white cutout top, and black cargo pants, casually holding a delicate sprig of tiny purple heather flowers. The camera captures the deep textures of the leather, denim, and peeling street art. Flawless spatial consistency: the background posters, graffiti, and text remain perfectly rigid and do not warp or hallucinate as the camera slowly moves. - inputImage: https://cdn.wiro.ai/uploads/sampleinputs/xai-grok-image-r2v-input-3-1.jpg,https://cdn.wiro.ai/uploads/sampleinputs/xai-grok-image-r2v-input-3-2.jpg,https://cdn.wiro.ai/uploads/sampleinputs/xai-grok-image-r2v-input-3-3.jpg - prompt: Cinematic, sweeping crane shot transitioning from ground level to the high canopy within a dense, lush green forest of towering, moss-covered trees. The shot begins at a low angle, sharply focused on the smooth planks of a sturdy wooden footbridge. Standing alert on the edge of the bridge is a small, highly detailed brown and white bird with distinct black neck bands and a bright yellow-ringed eye. The bird darts its head with rapid, flawless avian mechanics, its feathers ruffling slightly in a gentle breeze. The camera smoothly cranes upward and tracks forward, leaving the bridge and pushing seamlessly through the vibrant green foliage. Dappled sunlight dynamically shifts across the leaves with accurate lighting physics. As the camera reaches the mid-canopy, the focus softly racks to reveal a fluffy grey koala clinging securely to a thin, gently swaying branch. The koala’s thick fur is highly textured and moves naturally in the wind. The koala slowly turns its head to look at the camera, chewing on a green leaf with perfectly realistic jaw and facial mechanics. Flawless spatial consistency, rigorous depth-of-field transitions, and perfectly stable anatomical and environmental geometry without hallucinating or morphing. - inputImage: https://cdn.wiro.ai/uploads/sampleinputs/xai-grok-image-r2v-input-4-1.jpg,https://cdn.wiro.ai/uploads/sampleinputs/xai-grok-image-r2v-input-4-2.jpg,https://cdn.wiro.ai/uploads/sampleinputs/xai-grok-image-r2v-input-4-3.jpg ## Integration Header Prepare ```bash # Sign up Wiro dashboard and create project export YOUR_API_KEY="{{useSelectedProjectAPIKey}}"; export YOUR_API_SECRET="XXXXXXXXX"; # unix time or any random integer value export NONCE=$(date +%s); # hmac-SHA256 (YOUR_API_SECRET+Nonce) with YOUR_API_KEY export SIGNATURE="$(echo -n "${YOUR_API_SECRET}${NONCE}" | openssl dgst -sha256 -hmac "${YOUR_API_KEY}")"; ``` ## Run Command - Make HTTP Post Request ```bash curl -X POST "https://api.wiro.ai/v1/Run/xai/grok-imagine-r2v" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "inputImage": [ "xai-grok-image-r2v-input-1-1.jpg", "xai-grok-image-r2v-input-1-2.jpg", "xai-grok-image-r2v-input-1-3.jpg" ], "prompt": "Cinematic, sweeping crane shot transitioning from extreme macro to a vast wide-angle landscape. The shot begins at ground level on a bed of dry brown autumn leaves and pine needles, focusing tightly on a vibrant green oak leaf covered in perfectly spherical, physically accurate water droplets. The droplets subtly vibrate with a gentle breeze, reflecting the ambient light. The camera smoothly tilts up and tracks forward, seamlessly racking focus to reveal a serene, misty autumn wetland. Small, still pools of deep blue water perfectly reflect the sky, surrounded by vibrant golden marsh grasses and scattered pine trees. In the distance, rolling green and yellow forested hills rise toward a towering, rugged rocky mountain peak set against a dramatic, heavy cloudy sky. Flawless depth-of-field transition, perfectly stable water reflections, and rigid environmental geometry throughout the camera movement.", "duration": "5", "aspectRatio": "16:9", "resolution": "480p", "callbackUrl": "You can provide a callback URL; Wiro will send a POST request to it when the task is completed." }'; ``` ## Run Command - Response ```json { "errors": [], "taskid": "2221", "socketaccesstoken": "eDcCm5yyUfIvMFspTwww49OUfgXkQt", "result": true } ``` ## Get Task Detail - Make HTTP Post Request with Task ID ```bash curl -X POST "https://api.wiro.ai/v1/Task/Detail" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "taskid": "2221" }'; ``` ## Get Task Detail - Make HTTP Post Request with Socket Access Token ```bash curl -X POST "https://api.wiro.ai/v1/Task/Detail" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "tasktoken": "eDcCm5yyUfIvMFspTwww49OUfgXkQt" }'; ``` ## Get Task Detail - Response ```json { "total": "1", "errors": [], "tasklist": [ { "id": "2221", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "socketaccesstoken": "eDcCm5yyUfIvMFspTwww49OUfgXkQt", "parameters": {}, "debugoutput": "", "debugerror": "", "starttime": "1734513809", "endtime": "1734513813", "elapsedseconds": "6.0000", "status": "task_postprocess_end", "createtime": "1734513807", "canceltime": "0", "assigntime": "1734513807", "accepttime": "1734513807", "preprocessstarttime": "1734513807", "preprocessendtime": "1734513807", "postprocessstarttime": "1734513813", "postprocessendtime": "1734513814", "outputs": [ { "id": "6bc392c93856dfce3a7d1b4261e15af3", "name": "0.png", "contenttype": "image/png", "parentid": "6c1833f39da71e6175bf292b18779baf", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "size": "202472", "addedtime": "1734513812", "modifiedtime": "1734513812", "accesskey": "dFKlMApaSgMeHKsJyaDeKrefcHahUK", "url": "https://cdn1.wiro.ai/6a6af820-c5050aee-40bd7b83-a2e186c6-7f61f7da-3894e49c-fc0eeb66-9b500fe2/0.png" } ], "size": "202472" } ], "result": true } ``` ## Kill Task - Make HTTP Post Request with Task ID ```bash curl -X POST "https://api.wiro.ai/v1/Task/Kill" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "taskid": "534574" }'; ``` ## Kill Task - Make HTTP Post Request with Socket Access Token ```bash curl -X POST "https://api.wiro.ai/v1/Task/Kill" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "socketaccesstoken": "ZpYote30on42O4jjHXNiKmrWAZqbRE" }'; ``` ## Kill Task - Response ```json { "errors": [], "tasklist": [ { "id": "534574", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "name": "", "socketaccesstoken": "ZpYote30on42O4jjHXNiKmrWAZqbRE", "parameters": { "inputImage": "https://api.wiro.ai/v1/File/mCmUXgZLG1FNjjjwmbtPFr2LVJA112/inputImage-6060136.png" }, "debugoutput": "", "debugerror": "", "starttime": "1734513809", "endtime": "1734513813", "elapsedseconds": "6.0000", "status": "task_cancel", "cps": "0.000585000000", "totalcost": "0.003510000000", "guestid": null, "projectid": "699", "modelid": "598", "description": "", "basemodelid": "0", "runtype": "model", "modelfolderid": "", "modelfileid": "", "callbackurl": "", "marketplaceid": null, "createtime": "1734513807", "canceltime": "0", "assigntime": "1734513807", "accepttime": "1734513807", "preprocessstarttime": "1734513807", "preprocessendtime": "1734513807", "postprocessstarttime": "1734513813", "postprocessendtime": "1734513814", "pexit": "0", "categories": "["tool","image-to-image","quick-showcase","compare-landscape"]", "outputs": [ { "id": "6bc392c93856dfce3a7d1b4261e15af3", "name": "0.png", "contenttype": "image/png", "parentid": "6c1833f39da71e6175bf292b18779baf", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "size": "202472", "addedtime": "1734513812", "modifiedtime": "1734513812", "accesskey": "dFKlMApaSgMeHKsJyaDeKrefcHahUK", "foldercount": "0", "filecount": "0", "ispublic": 0, "expiretime": null, "url": "https://cdn1.wiro.ai/6a6af820-c5050aee-40bd7b83-a2e186c6-7f61f7da-3894e49c-fc0eeb66-9b500fe2/0.png" } ], "size": "202472" } ], "result": true } ``` ## Cancel Task - Make HTTP Post Request (For tasks on queue) ```bash curl -X POST "https://api.wiro.ai/v1/Task/Cancel" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "taskid": "634574" }'; ``` ## Cancel Task - Response ```json { "errors": [], "tasklist": [ { "id": "634574", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "name": "", "socketaccesstoken": "ZpYote30on42O4jjHXNiKmrWAZqbRE", "parameters": { "inputImage": "https://api.wiro.ai/v1/File/mCmUXgZLG1FNjjjwmbtPFr2LVJA112/inputImage-6060136.png" }, "debugoutput": "", "debugerror": "", "starttime": "1734513809", "endtime": "1734513813", "elapsedseconds": "6.0000", "status": "task_cancel", "cps": "0.000585000000", "totalcost": "0.003510000000", "guestid": null, "projectid": "699", "modelid": "598", "description": "", "basemodelid": "0", "runtype": "model", "modelfolderid": "", "modelfileid": "", "callbackurl": "", "marketplaceid": null, "createtime": "1734513807", "canceltime": "0", "assigntime": "1734513807", "accepttime": "1734513807", "preprocessstarttime": "1734513807", "preprocessendtime": "1734513807", "postprocessstarttime": "1734513813", "postprocessendtime": "1734513814", "pexit": "0", "categories": "["tool","image-to-image","quick-showcase","compare-landscape"]", "outputs": [ { "id": "6bc392c93856dfce3a7d1b4261e15af3", "name": "0.png", "contenttype": "image/png", "parentid": "6c1833f39da71e6175bf292b18779baf", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "size": "202472", "addedtime": "1734513812", "modifiedtime": "1734513812", "accesskey": "dFKlMApaSgMeHKsJyaDeKrefcHahUK", "foldercount": "0", "filecount": "0", "ispublic": 0, "expiretime": null, "url": "https://cdn1.wiro.ai/6a6af820-c5050aee-40bd7b83-a2e186c6-7f61f7da-3894e49c-fc0eeb66-9b500fe2/0.png" } ], "size": "202472" } ], "result": true } ``` ## Task Status Information This section defines the possible task status values returned by the API when polling for task completion. ### Completed Task Statuses (Polling can stop) These indicate that the task has reached a terminal state — either success or failure. Once any of these is received, polling should stop. - task_postprocess_end : Task completed successfully and post-processing is done. - task_cancel : Task was cancelled by the user or system. ### Running Task Statuses (Continue polling) These statuses indicate that the task is still in progress. Polling should continue if one of these is returned. - task_queue : Task is waiting in the queue. - task_accept : Task has been accepted for processing. - task_assign : Task is being assigned to a worker. - task_preprocess_start : Preprocessing is starting. - task_preprocess_end : Preprocessing is complete. - task_start : Task execution has started. - task_output : Output is being generated.