Pictory
  1. Bulk Video Generation APIs
Pictory
  • API Flows
    • Text to Video API Flow
      • Step 1: Authenticate
      • Step 2: Generate Video Preview from Text
      • Step 3: GET Video Preview & Default Settings
      • Step 4: Render Video
      • Step 4: Render PUT
      • Step 5: GET Video Download URL
    • Video Editing API Flow
      • Step 1: Authenticate
      • Step 2: Obtain Pictory Upload URL
      • Step 3: Upload video to Pictory
      • Step 4: v2 Transcribe Uploaded Video
      • Step 5: GET Default Transcription & Highlights Settings
      • Step 6: Render Video
      • Step 7: GET Video Download URL
    • Bulk Video Generation APIs
      • Step 1: Authenticate
        POST
      • Step2: Upload Project
        POST
      • Step3: Update Variables
        POST
      • Step 4: Get Video Preview
        GET
      • Step 5: Render Video
        PUT
      • Step 6: GET Video Download URL
        GET
  • API Reference
    • /v1/oauth2/token
      POST
    • /v1/video/storyboard
      POST
    • /v1/job/{job_id}
      GET
    • /v1/media/generateUrl
      POST
    • Upload video to Pictory
      PUT
    • /v2/transcription (Transcript & Highlights)
      POST
    • /v2 GET Default Transcription & Highlights Settings
      GET
    • /v1/transcription
      POST
    • /v1 GET Default Transcription Settings
      GET
    • /v1/transcription/highlights
      POST
    • /v2/transcription/highlights
      POST
    • /v1 GET Default Highlight Settings
      GET
    • /v1/video/storyboard/fonts
      GET
    • Create Template
      POST
    • Update Template
      PUT
    • Get Templates
      GET
    • Create Template Video
      POST
    • Get Template By Id
      GET
    • Delete Template By Id
      DELETE
    • /v1/video/render
      POST
    • v1/media/search
      GET
  1. Bulk Video Generation APIs

Step 1: Authenticate

Develop Env
https://dev.your-api-server.com
Develop Env
https://dev.your-api-server.com
POST
/v1/oauth2/token
Prior to working with the APIs, request a client_id and client_secret from the Pictory sales team.
Authenticate using client credentials and an API key. Obtain an access token from the token endpoint and include it as an Authorization header in each request. Invalid or expired tokens will yield a 401 Unauthorized response. Tokens expire in 1 hour.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://dev.your-api-server.com/v1/oauth2/token' \
--header 'client_id: {{client_id}}' \
--header 'client_secret: {{client_secret}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "client_id": "{{client_id}}", //Provided by Pictory sales team. Set the value in your environment file
    "client_secret": "{{client_secret}}" //Provided by Pictory sales team. Set the value in your environment file
}'
Response Response Example
{
    "access_token": "<<ACCESS TOKEN>>",
    "expires_in": 3600,
    "token_type": "Bearer"
}

Request

Header Params
client_id
string 
required
Example:
{{client_id}}
client_secret
string 
required
Example:
{{client_secret}}
Body Params application/json
client_id
string 
required
client_secret
string 
required
Examples

Responses

🟢200Step 1: Authenticate
application/json
Body
access_token
string 
required
expires_in
integer 
required
token_type
string 
required
Modified at 2024-07-10 08:41:40
Previous
Step 7: GET Video Download URL
Next
Step2: Upload Project
Built with