Bulk Video Generation Usecase

Steps to generate Bulk Videos are given below:

STEP 1: Create Project File

Create the Video Template from the Pictory Web App. Mention the text variables you want to customize as {{...}}

STEP 2: Download Project File

Download the project file with extension .pictai from projects section.


STEP 3: Upload the project and GET Template Id

API EndPoint: https://api.pictory.ai/pictoryapis/v1/templates

Sample API Request

curl --location 'https://api.pictory.ai/pictoryapis/v1/templates' \
--header 'X-Pictory-User-Id: <YOUR_USER_ID>' \
--header 'Authorization: <ACCESSTOKEN> ' \
--header 'Content-Type: application/octet-stream' \
--data '@FileName.pictai'

Sample API Response

{
    "templateId": "20240527091000991sKaqhDfBxdREvFs",
    "name": "Pending Loan Payment(",
    "language": "en",
    "audio": {
        "musicUrl": "BACKGROUND_MUSIC_URL",
        "musicVolume": 0.1,
        "aiVoice": {
            "speaker": "AI_VOICE_SPEAKER",
            "speed": 100,
            "amplifyLevel": 0
        }
    },
    "scenes": [
        {
            "sceneId": "20240527090959872RhZaJ4Lyp1jYb18",
            "subtitles": [
                {
                    "text": "Dear {{customer_name}},"
                }
            ],
            "backgroundVisual": {
                "visualUrl": "https://media.gettyimages.com/id/1460325253/video/handshake-congratulations-and-business-people-meeting-welcome-or-thank-you-for-success.mp4?b=1&s=mp4-640x640-gi&k=20&c=yAbN8GJxxWDVsj-yX-iV4vG_k4-_7IJdBA94D2M30T0=",
                "type": "video"
            }
        },
    ],
    "variables": {
        "customer_name": "CUSTOMER_NAME",
        "payment_date": "PAYMENT_DATE",
        "loan_account_number": "LOAN_ACCOUNT_NUMBER",
        "customer_support_number": "CUSTOMER_SUPPORT_NUMBER",
        "support_email_id": "SUPPORT_EMAIL_ID"
    }
}

To modify the scene text or visual URL, use PUT Template API.


Step 5: Update Variables and Generate Preview

You can update the text variables using the from-template API Request.

curl --location 'https://api.pictory.ai/pictoryapis/v1/video/from-template' \
--header 'X-Pictory-User-Id: <YOUR_PICTORY_USER_ID>' \
--header 'Authorization: <YOUR_ACCESS_TOKEN>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "templateId": "20240529110124913jThMoLFesQuJa9C",
     "variables": {
        "customer_name": "Pete Bennette",
        "payment_date": "27-May-2024",
        "loan_account_number": "0977699670 ",
        "customer_support_number": "180007343922323",
        "support_email_id": "[email protected]"
    }
}'

RESPONSE
{
    "success": true,
    "data": {
        "jobId": "981e84c8-bd06-4a65-a791-d4a3da315c2a"
    }
}

Step 6: Check Video Preview and Generate Video.

You can check video preview status by passing jobId in GET Job API and use Render API to generate the Final Video.