Pictory
  1. API Reference
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
      • Step2: Upload Project
      • Step3: Update Variables
      • Step 4: Get Video Preview
      • Step 5: Render Video
      • Step 6: GET Video Download URL
  • 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. API Reference

/v1/media/generateUrl

Develop Env
https://dev.your-api-server.com
Develop Env
https://dev.your-api-server.com
POST
/v1/media/generateUrl
This endpoint is part of Pictory's AI video editing flow. For that flow, you must first obtain an upload URL with this call, then upload your video directly. Publicly accessible download links won't work. Get the URL from the response.
    "signedUrl": "https://pictory-api-prod.s3.us-east-2.amazonaws.com/98c434bd-763d-424d-9403-9159e3703919/testvideo.mp4?Content-Type=video/mp4&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA2GVAALU3GNWKJFPD/20230718/us-east-2/s3/aws4_request&X-Amz-Date=20230718T141711Z&X-Amz-Expires=3600&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEO3//////////wEaCXVzLWVhc3QtMiJIMEYCIQCts7FRnEsAReDqVhSxrx2uiyrb0y4Nug8Qzekz7V1+WAIhANRsQbrtNyM68ly1eb0IT0Y5CapFpMjbadbOhxrR2qibKoYDCHYQBBoMNzAxNDg4OTc5MjU0Igz87EPRq3kZvk2wNNQq4wK1tk2lrCW9sN/Ie4iuStBAqnSMBYDicxexlO8S90Ga9TtanmrR0uBE8w+OnHm+omBPjJI4ucWzRtN6RM9r36TJl09NPCMK9+f+pMjq3h7Fh+QJQVDl1EFsWBuKuFaYrEZotA6Tyrl2u5kI4FBrUCQrMYtFtN6ZaWetllgO7QEEo9LdUXAbBYD+9Y/uZK+jWTkDDGOE1qZFe4hL9M2RKdz830lP4hZA/ErYO3cGUS4l0kcBw3PqUlkzPuyYTHj0ZbDUhvNLK6snVESRskkxJvjQQJ9PmXmMH3zsfyacJrNLGQqcdwoHSt3jTfgZL7arogBN+I2BcCEMrV3ZvEL7fc/Lk484ekpzM125LH78nkB3u3Wf0OIF16O4OgqiNcXNLrhDDyc+M34c8JKZyNw1SJU/+qcZ05SPmps3ktjh06KcjtD+/fiIfdEq2bb1wUWwuOqTOIRDzWpeEgtIKmcLcF1g9ZbHMMKX2qUGOp0BEEJd5c1UWV/Jgr75pHl/pjvx5iq7IuCM7EhBeWJnxBvGWj8sFE51YvPthP9BJmt81KIpRsiZBa+nYk4VCCIDsz+CkFssbmREk56SDE0+M5SY9oCrCmqOSYvJbsTTXtgI0XgXjUryZH0qzcsJ/FnfnzoRvy5j163x39XQWZHtDpqrDVdNgFnCqTIW1ErmbVrEmVTpOvzvZHoiAhfptw==&X-Amz-Signature=8d187d5c25de3b294324bb3ebfdefb8a06aded99f6ca824cca3388af827ac7f6&X-Amz-SignedHeaders=host;x-amz-acl&x-amz-acl=public-read",
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://dev.your-api-server.com/v1/media/generateUrl' \
--header 'Authorization: {{access_token}}' \
--header 'X-Pictory-User-Id: {{X-Pictory-User-Id}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "fileName":"{{file_name}}", //File name set in Postman environment for reuse in another call
    "contentType": "video/mp4" //Allowed type: video/mp4
}'
Response Response Example
{
    "success": true,
    "data": {
        "signedUrl": "https://pictory-api-prod.s3.us-east-2.amazonaws.com/98c434bd-763d-424d-9403-9159e3703919/testvideo.mp4?Content-Type=video%2Fmp4&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA2GVAALU3GNWKJFPD%2F20230718%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20230718T141711Z&X-Amz-Expires=3600&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEO3%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLWVhc3QtMiJIMEYCIQCts7FRnEsAReDqVhSxrx2uiyrb0y4Nug8Qzekz7V1%2BWAIhANRsQbrtNyM68ly1eb0IT0Y5CapFpMjbadbOhxrR2qibKoYDCHYQBBoMNzAxNDg4OTc5MjU0Igz87EPRq3kZvk2wNNQq4wK1tk2lrCW9sN%2FIe4iuStBAqnSMBYDicxexlO8S90Ga9TtanmrR0uBE8w%2BOnHm%2BomBPjJI4ucWzRtN6RM9r36TJl09NPCMK9%2Bf%2BpMjq3h7Fh%2BQJQVDl1EFsWBuKuFaYrEZotA6Tyrl2u5kI4FBrUCQrMYtFtN6ZaWetllgO7QEEo9LdUXAbBYD%2B9Y%2FuZK%2BjWTkDDGOE1qZFe4hL9M2RKdz830lP4hZA%2FErYO3cGUS4l0kcBw3PqUlkzPuyYTHj0ZbDUhvNLK6snVESRskkxJvjQQJ9PmXmMH3zsfyacJrNLGQqcdwoHSt3jTfgZL7arogBN%2BI2BcCEMrV3ZvEL7fc%2FLk484ekpzM125LH78nkB3u3Wf0OIF16O4OgqiNcXNLrhDDyc%2BM34c8JKZyNw1SJU%2F%2BqcZ05SPmps3ktjh06KcjtD%2B%2FfiIfdEq2bb1wUWwuOqTOIRDzWpeEgtIKmcLcF1g9ZbHMMKX2qUGOp0BEEJd5c1UWV%2FJgr75pHl%2Fpjvx5iq7IuCM7EhBeWJnxBvGWj8sFE51YvPthP9BJmt81KIpRsiZBa%2BnYk4VCCIDsz%2BCkFssbmREk56SDE0%2BM5SY9oCrCmqOSYvJbsTTXtgI0XgXjUryZH0qzcsJ%2FFnfnzoRvy5j163x39XQWZHtDpqrDVdNgFnCqTIW1ErmbVrEmVTpOvzvZHoiAhfptw%3D%3D&X-Amz-Signature=8d187d5c25de3b294324bb3ebfdefb8a06aded99f6ca824cca3388af827ac7f6&X-Amz-SignedHeaders=host%3Bx-amz-acl&x-amz-acl=public-read",
        "url": "https://pictory-api-prod.s3.us-east-2.amazonaws.com/98c434bd-763d-424d-9403-9159e3703919/testvideo.mp4",
        "key": "98c434bd-763d-424d-9403-9159e3703919/testvideo.mp4"
    }
}

Request

Header Params
Authorization
string 
required
Example:
{{access_token}}
X-Pictory-User-Id
string 
required
Used for logging purposes
Example:
{{X-Pictory-User-Id}}
Body Params application/json
fileName
string 
required
contentType
string 
required
Examples

Responses

🟢201/v1/media/generateUrl
application/json
Body
success
boolean 
required
data
object 
required
signedUrl
string 
required
url
string 
required
key
string 
required
Modified at 2024-07-10 08:41:40
Previous
/v1/job/{job_id}
Next
Upload video to Pictory
Built with