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 GET Default Transcription Settings

Develop Env
https://dev.your-api-server.com
Develop Env
https://dev.your-api-server.com
GET
/v1/jobs/{{job_id}}
The response depends on job status. View variations by selecting a response from the Example Response section's top-right dropdown.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://dev.your-api-server.com/v1/jobs/{{job_id}}' \
--header 'Authorization: {{access_token}}' \
--header 'X-Pictory-User-Id: {{X-Pictory-User-Id}}'
Response Response Example
200 - Default Transcription Settings - Default Transcription Settings
{
    "success": true,
    "data": {
        "transcript": [
            {
                "uid": "6e12aac1-0dab-4229-90aa-238c62846e4c",
                "words": [
                    {
                        "uid": "d9f11114-5165-42d7-af5f-3b62e53613dc",
                        "word": "",
                        "start_time": 0,
                        "end_time": 0.5,
                        "sentence_index": 0,
                        "is_pause": true,
                        "pause_size": "small",
                        "state": "active"
                    },
                    {
                        "uid": "279fbfb5-5af4-4022-b694-65253056323e",
                        "word": "",
                        "start_time": 0.5,
                        "end_time": 0.91,
                        "sentence_index": 0,
                        "is_pause": true,
                        "pause_size": "small",
                        "state": "active"
                    },
                    {
                        "uid": "4039e0b1-a830-45d6-bf69-5818a7277779",
                        "word": "Once",
                        "start_time": 0.91,
                        "end_time": 1.24,
                        "sentence_index": 0
                    },
                    {
                        "uid": "450519e7-cd99-4069-ab16-ccf47e1a8567",
                        "word": "again,",
                        "start_time": 1.24,
                        "end_time": 1.5,
                        "sentence_index": 0
                    },
                    {
                        "uid": "eeab416b-32fa-4f9e-97fe-c60be94354f0",
                        "word": "I",
                        "start_time": 1.5,
                        "end_time": 1.52,
                        "sentence_index": 0
                    },
                    {
                        "uid": "bfd7c5ff-af14-4517-ac47-5625b7ed85cc",
                        "word": "want",
                        "start_time": 1.52,
                        "end_time": 1.75,
                        "sentence_index": 0
                    },
                    {
                        "uid": "a2ef4844-6c71-426c-a18c-d0f3e7cbe95f",
                        "word": "to",
                        "start_time": 1.75,
                        "end_time": 1.86,
                        "sentence_index": 0
                    },
                    {
                        "uid": "80711754-e98b-4bd2-9502-602a086d7d33",
                        "word": "welcome",
                        "start_time": 1.86,
                        "end_time": 2.4,
                        "sentence_index": 0
                    },
                    {
                        "uid": "4a747060-44f6-40da-a411-a1df566dc3ae",
                        "word": "Prime",
                        "start_time": 2.4,
                        "end_time": 2.53,
                        "sentence_index": 0
                    },
                    {
                        "uid": "4250a08b-cd07-43f3-a33a-95f5c1832fc3",
                        "word": "Minister",
                        "start_time": 2.53,
                        "end_time": 2.84,
                        "sentence_index": 0
                    },
                    {
                        "uid": "51d7ebd7-3aba-498c-9323-26a522d55e3c",
                        "word": "Trudeau",
                        "start_time": 2.84,
                        "end_time": 3.16,
                        "sentence_index": 0
                    },
                    {
                        "uid": "1b6c5081-99f0-4947-b292-1f168b7eb751",
                        "word": "to",
                        "start_time": 3.16,
                        "end_time": 3.33,
                        "sentence_index": 0
                    },
                    {
                        "uid": "018c0dc0-e018-41b9-8a92-f539ea2a4ada",
                        "word": "the",
                        "start_time": 3.33,
                        "end_time": 3.4,
                        "sentence_index": 0
                    },
                    {
                        "uid": "e1ddd92b-9050-49a2-b4a9-d9b161e88bf0",
                        "word": "White",
                        "start_time": 3.4,
                        "end_time": 3.59,
                        "sentence_index": 0
                    },
                    {
                        "uid": "78541110-268c-4e92-8512-eacc9cfae50e",
                        "word": "House.",
                        "start_time": 3.59,
                        "end_time": 4.37,
                        "sentence_index": 0
                    }
                ]
            },
            {
                "uid": "11ba91cf-f673-4abf-a239-b2632e86df63",
                "words": [
                    {
                        "uid": "b40edb1a-d56a-4b83-bb45-dfb2d47b373a",
                        "word": "We",
                        "

Request

Header Params
Authorization
string 
required
Example:
{{access_token}}
X-Pictory-User-Id
string 
required
Used for logging purposes
Example:
{{X-Pictory-User-Id}}

Responses

🟢200Default Transcription Settings
application/json
Body
success
boolean 
required
data
object 
required
transcript
array [object {2}] 
required
url
string 
required
mediaInfo
object 
required
job_id
string 
required
🟢200Transcription in Progress
Modified at 2024-07-10 08:41:40
Previous
/v1/transcription
Next
/v1/transcription/highlights
Built with