START & GET TEXT-TO-VIDEO JOB (ASYNC) =====================================

ACTION DESCRIPTION
--------------------------------
 TEXT-TO-VIDEO generates a video from a text prompt

STEP-BY-STEP SETUP
--------------------------------

 0) Set-up an account on KLING AI and get your ASSET & SECRET KEY

 1) In the plugin settings, set your ASSET KEY & SECRET KEY

 2) Set up the action "START TEXT-TO-VIDEO JOB" in the workflow.
   Inputs Fields :
       - PROMPT : A required string for the positive text prompt (max 2500 characters)
       - MODEL NAME : A string for the model name (e.g., "kling-v1", "kling-v1-6")
       - NEGATIVE PROMPT NAME : An optional string for the negative text prompt (max 2500 characters).
       - CFG SCALE  : A float between 0 and 1 for video flexibility. Defaulting to "0.5".
       - MODE  : A string with options "std" (Standard) or "pro" (Professional).
       - CAMERA CONTROL  : Predefined camera movements can be categorized into specific types: "simple", "down_back", "forward_up", "right_turn_forward", and "left_turn_forward". The "simple" type allows a selection of one out of six options for camera movement through the "config" parameter. The "down_back" type makes the camera descend and move backward, which corresponds to a pan-down and zoom-out motion. For this type, the "config" parameter must be set to "None." The "forward_up" type moves the camera forward while tilting up, resulting in a zoom-in and pan-up effect, and also requires the "config" parameter to be set to "None." The "right_turn_forward" type rotates the camera to the right while advancing forward, requiring the "config" parameter to be set to "None." Similarly, the "left_turn_forward" type rotates the camera to the left while advancing forward, with the "config" parameter also needing to be "None."  Valid values: simple | down_back | forward_up | right_turn_forward | left_turn_forward
       - ASPECT RATIO  : A string for the aspect ratio (e.g., "16:9", "9:16", "1:1").
       - DURATION  : A number for the duration in seconds.
       - CALLBACK URL  : The callback notification address for the result of this task. If configured, the server will actively notify when the task status changes

   Output Fields :
     - TASK ID : ID of the task to poll.

 3) Set up the action "GET TEXT-TO-VIDEO JOB RESULT" in a recurring workflow ('Do every x seconds'), to poll the operation completion status on a regular basis.
   Configure this recurring workflow to retrieve the results once the  status is 'succeed', using Only When' Event Condition,
   Inputs Fields :
     - TASK ID : ID of the task to poll, returned by "START TEXT-TO-VIDEO JOB" action.
   Output Fields :
     - STATUS : Task status, Enum values：submitted、processing、succeed、failed
     - ASSET ID : Generated video ID; globally unique.    
     - ASSET URL : URL for generating videos，such as https://p1.a.kwimgs.com/bs2/upload-ylab-stunt/special-effect/output/HB1_PROD_ai_web_46554461/-2878350957757294165/output.mp4(To ensure information security, generated images/videos will be cleared after 30 days. Please make sure to save them promptly      
     - DURATION : Total video duration, unit: s (seconds)

IMPLEMENTATION EXAMPLE
======================
Feel free to browse the app editor in the Service URL for an implementation example.

ADDITIONAL INFORMATION
======================
 N/A

TROUBLESHOOTING
================
Any plugin related error will be posted to the the Logs tab, "Server logs" section of your App Editor.
Make sure that "Plugin server side output" and "Plugin server side output" is selected in "Show Advanced".

> Server Logs Details: https://manual.bubble.io/core-resources/bubbles-interface/logs-tab#server-logs

PERFORMANCE CONSIDERATIONS
===========================

GENERAL
-------------
 N/A

QUESTIONS ?
===========
Contact us at [email protected] for any additional feature you would require or support question.