## Basic tool info Model name: bytedance-research/Lance-Text-to-Video Model description: Turn a detailed scene description into a short video clip. Lance Text to Video can also animate a still image or rewrite an existing video. Model cover: https://cdn.wiro.ai/uploads/models/bytedance-research-lance-text-to-video-cover.webp Model categories: - persistent - model - video-to-video - image-to-video - text-to-video Model tags: - video - edit Run Task Endpoint (POST): https://api.wiro.ai/v1/Run/bytedance-research/lance-text-to-video Get Task Detail Endpoint (POST): https://api.wiro.ai/v1/Task/Detail ## Model Inputs: - name: prompt label: prompt help: The prompt to generate the image or video from. type: textarea default: An adorable kangaroo wearing purple overalls and cowboy boots takes a pleasant stroll through the bustling streets of Mumbai, India, during a winter storm. The kangaroo's fur is soft and fluffy, with large, expressive eyes and a playful smile. It hops along confidently, its overalls and boots adding a touch of whimsy to the scene. The background features a mix of colorful Indian street vendors, rickshaws, and tall buildings, with the storm clouds casting dramatic shadows. The storm is fierce yet beautiful, with heavy rain and strong winds, creating a dynamic and enchanting atmosphere. The kangaroo pauses occasionally to inspect its surroundings, adding a sense of curiosity and wonder. A mid-shot with a slightly elevated camera angle, capturing both the kangaroo and the vibrant cityscape. - name: width label: width help: width-help type: number default: 848 - name: height label: height help: height-help type: number default: 480 - name: frames label: frame-number help: frame-number-help type: number default: 50 - name: steps label: inferencesteps help: inferencesteps-help type: number default: 30 - name: scale label: guidancescale help: guidancescale-help type: float default: 5.0 - name: seed label: seed help: seed-help type: text default: 0 ## Model Parameter Inspires: - prompt: A polished palace boxing scene frames a panda in a luxurious scarlet robe facing an exposed-servo robot in a white marble ring with gold details, fountain spray, and blooming flowers. The fighters stay large and clear in frame. steady camera. Each exchange uses visible defensive guards, controlled strikes, and brief pauses that make every punch easy to follow. - prompt: A premium fantasy-film shot shows a pastel horse appearing in a dreamy cloud valley filled with luminous stars and floating petals. The main subject fills at least two-thirds of the frame and remains the clear visual focus. The setting stays bright and visually rich, with airy depth, polished contrast, and a refined cinematic atmosphere that supports the subject without overwhelming it. Lively eyes, soft blinking, and delicate expression changes create a warm, engaging on-camera presence. The scene is colorful, richly detailed, and highly aesthetic, with dramatic sky depth and crystalline highlights. the camera glides sideways while the starfield pulses and the unicorn steps out of the glow. - prompt: An adorable kangaroo wearing purple overalls and cowboy boots takes a pleasant stroll through the bustling streets of Mumbai, India, during a winter storm. The kangaroo's fur is soft and fluffy, with large, expressive eyes and a playful smile. It hops along confidently, its overalls and boots adding a touch of whimsy to the scene. The background features a mix of colorful Indian street vendors, rickshaws, and tall buildings, with the storm clouds casting dramatic shadows. The storm is fierce yet beautiful, with heavy rain and strong winds, creating a dynamic and enchanting atmosphere. The kangaroo pauses occasionally to inspect its surroundings, adding a sense of curiosity and wonder. A mid-shot with a slightly elevated camera angle, capturing both the kangaroo and the vibrant cityscape. - prompt: High-angle drone shot gliding slowly forward over the historic Porto hillside. Cars move smoothly along the winding asphalt road, with a few vehicles disappearing into the tunnel while others drive past the crosswalk. Pedestrians are seen walking up and down the steep stone staircases and along the sidewalks. The warm, golden hour sunlight casts long, soft shadows across the terracotta rooftops and white building facades, creating a hazy, cinematic atmosphere. A gentle breeze subtly sways the green ivy covering the stone walls and the leaves of the scattered trees. In the distance, a few seagulls fly lazily across the sky above the large palace on the hill. The movement is fluid and realistic, capturing the vibrant life of the city. ## 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/bytedance-research/lance-text-to-video" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "prompt": "An adorable kangaroo wearing purple overalls and cowboy boots takes a pleasant stroll through the bustling streets of Mumbai, India, during a winter storm. The kangaroo's fur is soft and fluffy, with large, expressive eyes and a playful smile. It hops along confidently, its overalls and boots adding a touch of whimsy to the scene. The background features a mix of colorful Indian street vendors, rickshaws, and tall buildings, with the storm clouds casting dramatic shadows. The storm is fierce yet beautiful, with heavy rain and strong winds, creating a dynamic and enchanting atmosphere. The kangaroo pauses occasionally to inspect its surroundings, adding a sense of curiosity and wonder. A mid-shot with a slightly elevated camera angle, capturing both the kangaroo and the vibrant cityscape.", "width": 848, "height": 480, "frames": 50, "steps": 30, "scale": "5.0", "seed": "0", "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.