Skip to main content
GET
https://api.pictory.ai
/
pictoryapis
/
v2
/
projects
/
{projectid}
Get Project by ID
curl --request GET \
  --url https://api.pictory.ai/pictoryapis/v2/projects/{projectid} \
  --header 'Authorization: <authorization>'
{
  "project_id": "202601180951110906f5645f5952e4211bee28ac6100ddd68",
  "projectName": "AI Video Creation Guide",
  "projectType": "1",
  "source": "script",
  "step": "STORYBOARD",
  "schemaVersion": "v3",
  "layout": "16:9",
  "scriptLanguage": "en",
  "thumbnail": "https://cdn.example.com/thumbnail.jpg",
  "videoURL": "https://cdn.example.com/video/AI_Video_Creation_Guide.mp4",
  "audioURL": "https://cdn.example.com/audio/AI_Video_Creation_Guide.mp3",
  "shareVideoURL": "https://video.pictory.ai/project-id/share-id",
  "srtFile": "https://cdn.example.com/subtitles/subtitles.srt",
  "vttFile": "https://cdn.example.com/subtitles/subtitles.vtt",
  "txtFile": "https://cdn.example.com/subtitles/subtitles.txt",
  "videoDuration": 21.98,
  "audioSpeed": 100,
  "videoVolume": 50,
  "voiceOverId": "20260119024822426ae1e237bfddc4598b72be30c0c93ec33",
  "smartTemplateId": "20250813042630669e658e159aa60455692c1dad5473adtd3",
  "brandId": "",
  "saveDate": "2026-01-19T09:23:21.131Z",
  "generatedDate": "2026-01-19T09:26:23.059Z",
  "scriptTxtSceneSettings": {
    "autoVisualSelection": true,
    "selectedValueSceneBreakChar": "Both",
    "autoHighlightKeywords": true,
    "maxLines": 2
  },
  "visualFilter": {
    "libraries": [],
    "styles": [],
    "categories": []
  },
  "scenes": [
    {
      "sceneId": "2026011809570315812dcab8bad504b84a76171a1dd620cc5",
      "projectId": "202601180951110906f5645f5952e4211bee28ac6100ddd68",
      "text": "Create Amazing AI Videos",
      "sentence": [
        { "text": "Create " },
        { "highlight": true, "text": "Amazing AI Videos" }
      ],
      "keywords": ["Amazing AI Videos"],
      "category": "TITLE",
      "sortOrder": 10001,
      "durationAuto": 5,
      "layoutId": "20250901134117bbb9d28f462ef350f3",
      "settings": {
        "hideText": true
      },
      "styleData": {
        "fontName": "Plus Jakarta Sans",
        "fontDisplayName": "Plus Jakarta Sans",
        "fontSize": "24",
        "fontColor": "rgb(255,255,255)",
        "textAlign": "center",
        "keywordColor": "rgb(245,240,162)",
        "textBackgroundColor": "rgba(0,0,0,0.35)",
        "textShadowColor": "rgba(0,0,0,1)",
        "textShadowWidthFr": 0.03,
        "maxLines": 2,
        "width": 0.7,
        "preset": "bottom-center"
      },
      "background": {
        "type": "image",
        "elementData": {
          "url": "https://images.example.com/photo.jpg",
          "preview_jpg": "https://images.example.com/photo.jpg",
          "thumb": "https://images.example.com/photo-thumb.jpg",
          "thumb_jpg": "https://images.example.com/photo-thumb.jpg",
          "library": "unsplash",
          "libraryItemId": "mR1CIDduGLc",
          "duration": 0
        },
        "styleData": {
          "kenBurns": "kb-364683-oqt0",
          "imageZoomPan": true,
          "width": 0.7,
          "aspectRatio": 1.78,
          "preset": "center-center",
          "colorOverlay": {
            "hide": false,
            "bgColor": "rgb(0,37,60)",
            "opacity": 0.5
          }
        },
        "settings": {}
      },
      "elements": [
        {
          "elementId": "2026011815294013646c92e549f6646c49f31274227faf54d",
          "type": "video",
          "isLogo": false,
          "hide": false,
          "elementData": {
            "url": "https://videos.example.com/clip.mp4",
            "preview_jpg": "https://videos.example.com/clip-preview.jpg",
            "thumb": "https://videos.example.com/clip-thumb.mp4",
            "thumb_jpg": "https://videos.example.com/clip-thumb.jpg",
            "library": "story_blocks",
            "libraryItemId": "0",
            "duration": 16
          },
          "settings": {
            "loopVideo": true,
            "muteClipAudio": true
          },
          "styleData": {
            "top": 4.89,
            "left": 3.96,
            "width": 0.9259,
            "aspectRatio": 1.8066,
            "preset": null,
            "height": null,
            "sourceDimensions": {
              "width": 0.9512,
              "aspectRatio": 1.7778,
              "relYPercent": -0.0273,
              "relXPercent": -0.0127
            },
            "colorOverlay": {
              "hide": false,
              "bgColor": "rgb(110,111,132)",
              "opacity": 0.3
            }
          }
        },
        {
          "elementId": "202601180957034073d8a97be18614182b23c87f8c7fb2382",
          "type": "text",
          "componentName": "main_title",
          "elementData": {
            "sentence": [
              {
                "text": "Create Amazing AI Videos",
                "decoration": ["decor-underline", "decor-bold"]
              }
            ]
          },
          "settings": {
            "textMode": "writeAnything"
          },
          "styleData": {
            "fontName": "Arial",
            "fontDisplayName": "Arial",
            "fontSize": "42",
            "fontColor": "rgb(255,255,255)",
            "fontWeight": 400,
            "textAlign": "left",
            "keywordColor": "rgba(248, 173, 151, 1)",
            "textBackgroundColor": "rgba(0,0,0,0)",
            "textShadowColor": "rgba(0,0,0,0)",
            "textShadowWidthFr": 0.03,
            "width": 0.9,
            "fullWidth": false,
            "preset": "bottom-left",
            "customFontId": null,
            "animation": {
              "textAnimation": [
                {
                  "name": "Typewriter",
                  "type": ["entry"],
                  "writingStyle": "character",
                  "direction": "up",
                  "speed": { "value": 1 }
                },
                {
                  "name": "None",
                  "type": ["exit"]
                }
              ],
              "textBgAnimation": []
            }
          }
        }
      ],
      "audios": [
        {
          "audio_id": "20260119024821485409b9abeb6c8b4b4cae9357ecbe637cfd67",
          "type": "voiceover",
          "voice": 3036,
          "version": "v6",
          "speed": 100,
          "loudness": 50,
          "clipUrl": "https://audios.example.com/voiceover.mp3",
          "isAudioLinked": true,
          "subScenes": {
            "duration": 1.53,
            "start": 0,
            "end": 1533,
            "word_markers": [
              [0, 300, "Create"],
              [350, 700, "Amazing"],
              [750, 950, "AI"],
              [1000, 1533, "Videos"]
            ]
          }
        }
      ]
    },
    {
      "sceneId": "202601180957031586203f72337a9493893722a4b07b5af7b",
      "text": "Transform your content with powerful AI tools",
      "sentence": [
        {
          "text": "Transform your content",
          "highlight": true,
          "decoration": ["decor-bold", "decor-underline"],
          "case": "none"
        },
        {
          "text": " with powerful ",
          "decoration": ["decor-bold", "decor-underline"],
          "case": "none"
        },
        {
          "text": "AI tools",
          "highlight": true,
          "decoration": ["decor-bold", "decor-underline"],
          "case": "none"
        }
      ],
      "keywords": ["Transform your content", "AI tools"],
      "category": "DEFAULT",
      "sortOrder": 10002,
      "settings": {
        "hideText": false
      },
      "background": {
        "type": "solid",
        "elementData": {
          "color": "rgb(69,123,113)"
        },
        "styleData": {}
      },
      "elements": []
    }
  ],
  "audios": [
    {
      "audioId": "202601180957049641f56b14fa78641359f69ccb5e03aac8c",
      "type": "background",
      "name": "Open Arms",
      "library": "melodie",
      "url": "https://tracks.example.com/background-music.mp3",
      "duration": 191,
      "loudness": 10,
      "speed": 100
    },
    {
      "audioId": "20260119024822426ae1e237bfddc4598b72be30c0c93ec33",
      "type": "voiceover",
      "name": "Abby",
      "library": "elevenlabs",
      "language": "en-US",
      "url": "https://audios.example.com/voiceover-full.mp3",
      "duration": 15.226,
      "loudness": 50,
      "speed": 100,
      "version": "v6",
      "time_markers": [1533, 3874, 8072, 9268, 10715, 12301, 13446, 15226],
      "word_markers": [
        [[0, 300, "Create"], [350, 700, "Amazing"], [750, 950, "AI"], [1000, 1533, "Videos"]],
        [[1533, 2100, "Transform"], [2150, 2400, "your"], [2450, 2900, "content"], [2950, 3200, "with"], [3250, 3600, "powerful"], [3650, 3774, "AI"], [3800, 4200, "tools"]]
      ]
    }
  ]
}

​
Overview

Retrieve comprehensive details about a specific project using its unique identifier. This endpoint returns the complete project configuration, including storyboard data, video URLs, audio settings, script information, and rendering details.
You need a valid API key to use this endpoint. Get your API key from the API Access page in your Pictory dashboard.

​
API Endpoint

GET https://api.pictory.ai/pictoryapis/v2/projects/{projectid}

​
Request Parameters

​
Path Parameters

​
projectid
string
required
The unique identifier of the project to retrieve. Can be either a string (for v3 schema projects) or an integer (for v2 schema and earlier projects).Example: 20251222191648030d7df02f5b4054d4ca8831f1369459e25

​
Headers

​
Authorization
string
required
API key for authentication (starts with pictai_)
Authorization: YOUR_API_KEY

​
Response

The response contains detailed project information including configuration, media URLs, metadata, and all video elements such as scenes, backgrounds, text overlays, video clips, and audio tracks.

​
Video Elements Structure

A Pictory project contains multiple video elements organized hierarchically. Understanding this structure is essential for working with project data.
Do not modify project fields if their usage is unclear. Incorrect modifications can cause unexpected behavior or corrupt your project. If you have questions about specific fields or their intended use, please contact our support team at [email protected] before making changes.

​
Scenes

The scenes array contains all scenes in the project. Each scene represents a segment of the video with its own visual content, text, and audio. Scene Properties:
  • sceneId - Unique identifier for the scene
  • text - The display text/narration for the scene
  • sentence - Array of text segments with formatting options (highlight, decoration, case)
  • category - Scene type: TITLE, DEFAULT, or EMPHASIS
  • sortOrder - Numeric order of the scene in the video
  • durationAuto - Auto-calculated duration in seconds
  • keywords - Array of highlighted keywords from the text
  • layoutId - Template layout applied to the scene

​
Scene Text Styling (styleData)

Each scene has a styleData object controlling text appearance:
FieldDescription
fontNameFont family name (e.g., Arial, Plus Jakarta Sans)
fontDisplayNameDisplay name of the font
fontSizeFont size in pixels
fontColorText color in RGB format (e.g., rgb(255,255,255))
fontWeightFont weight (e.g., 400 for normal, 700 for bold)
textAlignText alignment: left, center, or right
keywordColorHighlight color for keywords in RGBA format
textBackgroundColorBackground color behind text in RGBA format
textShadowColorText shadow color in RGBA format
textShadowWidthFrText shadow width as a fraction
maxLinesMaximum number of text lines displayed
widthText container width as a fraction (0-1)
presetText position preset: bottom-left, bottom-center, center-center, etc.
customFontIdID reference for custom uploaded fonts
animationText animation settings (entry/exit animations)

​
Background Elements (background)

Each scene has a background object that defines the visual backdrop. The background type determines the content: Image Background (type: "image"): 
{
  "type": "image",
  "elementData": {
    "url": "https://...",           // Full resolution image URL
    "preview_jpg": "https://...",   // Preview image URL
    "thumb": "https://...",         // Thumbnail URL
    "thumb_jpg": "https://...",     // Thumbnail JPG URL
    "library": "unsplash",          // Source library (unsplash, story_blocks, getty, uploads)
    "libraryItemId": "mR1CIDduGLc", // Library item identifier
    "duration": 0                   // Duration (0 for images)
  },
  "styleData": {
    "kenBurns": "kb-364683-oqt0",   // Ken Burns animation effect ID
    "imageZoomPan": true,           // Enable zoom/pan animation
    "width": 0.7,                   // Display width as fraction
    "aspectRatio": 1.78,            // Image aspect ratio
    "preset": "center-center",      // Position preset
    "colorOverlay": {               // Optional color overlay
      "hide": false,
      "bgColor": "rgb(0,37,60)",
      "opacity": 0.5
    }
  }
}
Video Background (type: "video"): 
{
  "type": "video",
  "elementData": {
    "url": "https://...",           // Video URL (480p quality)
    "preview_jpg": "https://...",   // Preview thumbnail image
    "thumb": "https://...",         // Thumbnail video (180p)
    "thumb_jpg": "https://...",     // Thumbnail image
    "library": "story_blocks",      // Source: story_blocks, getty, pexels, uploads
    "libraryItemId": "120818",      // Library item identifier
    "description": "Video title",   // Video description
    "duration": 10                  // Video duration in seconds
  },
  "styleData": {
    "imageZoomPan": true            // Enable zoom/pan animation
  },
  "settings": {
    "loopVideo": true               // Loop video playback
  }
}
Solid Color Background (type: "solid"): 
{
  "type": "solid",
  "elementData": {
    "color": "rgb(69,123,113)"      // Background color in RGB
  },
  "styleData": {}
}

​
Scene Elements (elements)

The elements array within each scene contains overlay elements placed on top of the background. Each element has a type that determines its content. Video Element (type: "video"): Video clips placed as overlays within a scene:
FieldDescription
elementIdUnique identifier for the element
typeElement type: video
isLogoWhether this video is used as a logo
hideWhether the element is hidden
settings.loopVideoLoop the video clip
settings.muteClipAudioMute the video’s audio
elementData.urlVideo file URL (480p quality)
elementData.preview_jpgPreview thumbnail image
elementData.thumbThumbnail video URL (180p)
elementData.thumb_jpgThumbnail image URL
elementData.librarySource library: story_blocks, getty, pexels, uploads
elementData.libraryItemIdLibrary item identifier
elementData.durationVideo duration in seconds
styleData.topVertical position (percentage from top)
styleData.leftHorizontal position (percentage from left)
styleData.widthElement width as fraction (0-1)
styleData.heightElement height (null for auto)
styleData.aspectRatioDisplay aspect ratio
styleData.presetPosition preset (null for custom position)
styleData.sourceDimensionsOriginal source dimensions and offsets
styleData.colorOverlayColor overlay settings (bgColor, opacity, hide)
Text Element (type: "text"): Text overlays placed within a scene:
FieldDescription
elementIdUnique identifier for the element
typeElement type: text
componentNameComponent role: main_title, story_text, etc.
settings.textModeMode: useStoryText (from scene) or writeAnything (custom)
elementData.sentenceArray of text segments with formatting
Text Sentence Structure: 
{
  "sentence": [
    {
      "text": "Hello World",
      "highlight": true,              // Apply keyword highlighting
      "decoration": ["decor-bold", "decor-underline"],  // Text decorations
      "case": "none"                  // Text case transformation
    }
  ]
}
Text Element Styling (styleData):
FieldDescription
fontNameFont family
fontDisplayNameFont display name
fontSizeFont size in pixels
fontColorText color (RGB format)
fontWeightFont weight (400=normal, 700=bold)
textAlignAlignment: left, center, right
keywordColorHighlight color (RGBA)
textBackgroundColorBackground color (RGBA)
textShadowColorShadow color (RGBA)
textShadowWidthFrShadow width fraction
topVertical position (null for preset)
leftHorizontal position (null for preset)
widthContainer width (0-1)
maxLinesMaximum display lines
fullWidthUse full width container
presetPosition preset
customFontIdCustom font reference
animationAnimation configuration
Text Animation Structure: 
{
  "animation": {
    "textAnimation": [
      {
        "name": "Typewriter",         // Animation name
        "type": ["entry"],            // Type: entry or exit
        "writingStyle": "character",  // Style: character, word, or line
        "direction": "up",            // Animation direction
        "speed": { "value": 1 }       // Animation speed
      },
      {
        "name": "None",
        "type": ["exit"]
      }
    ],
    "textBgAnimation": []             // Background animations
  }
}

​
Audio Elements

Scene-Level Audio (scene.audios): Each scene can have voiceover audio with word-level timing:
FieldDescription
audio_idUnique audio clip identifier
typeAudio type: voiceover
voiceVoice ID number
versionVoice version (e.g., v6)
speedPlayback speed percentage (100 = normal)
loudnessVolume level (0-100)
clipUrlURL to the audio clip file
subScenes.durationAudio duration in seconds
subScenes.startStart time in milliseconds
subScenes.endEnd time in milliseconds
subScenes.word_markersArray of [start_ms, end_ms, word] for each word
isAudioLinkedWhether audio is linked across scenes
Project-Level Audio (audios):
FieldDescription
audioIdUnique audio identifier
typeType: background (music) or voiceover
nameAudio/voice name
urlAudio file URL
librarySource: melodie, elevenlabs, polly
durationTotal duration in seconds
loudnessVolume level (0-100)
speedPlayback speed percentage
languageLanguage code (for voiceover)
word_markersNested array of word timing per scene
time_markersArray of scene end timestamps (ms)

​
Media Libraries

The library field indicates the source of visual content:
LibraryDescription
unsplashUnsplash stock photos
story_blocksStoryblocks stock video/images
gettyGetty Images stock content
pexelsPexels stock photos/videos
melodieMelodie background music
elevenlabsElevenLabs AI voices
pollyAmazon Polly text-to-speech
uploadsUser-uploaded content

​
Response Examples

{
  "project_id": "202601180951110906f5645f5952e4211bee28ac6100ddd68",
  "projectName": "AI Video Creation Guide",
  "projectType": "1",
  "source": "script",
  "step": "STORYBOARD",
  "schemaVersion": "v3",
  "layout": "16:9",
  "scriptLanguage": "en",
  "thumbnail": "https://cdn.example.com/thumbnail.jpg",
  "videoURL": "https://cdn.example.com/video/AI_Video_Creation_Guide.mp4",
  "audioURL": "https://cdn.example.com/audio/AI_Video_Creation_Guide.mp3",
  "shareVideoURL": "https://video.pictory.ai/project-id/share-id",
  "srtFile": "https://cdn.example.com/subtitles/subtitles.srt",
  "vttFile": "https://cdn.example.com/subtitles/subtitles.vtt",
  "txtFile": "https://cdn.example.com/subtitles/subtitles.txt",
  "videoDuration": 21.98,
  "audioSpeed": 100,
  "videoVolume": 50,
  "voiceOverId": "20260119024822426ae1e237bfddc4598b72be30c0c93ec33",
  "smartTemplateId": "20250813042630669e658e159aa60455692c1dad5473adtd3",
  "brandId": "",
  "saveDate": "2026-01-19T09:23:21.131Z",
  "generatedDate": "2026-01-19T09:26:23.059Z",
  "scriptTxtSceneSettings": {
    "autoVisualSelection": true,
    "selectedValueSceneBreakChar": "Both",
    "autoHighlightKeywords": true,
    "maxLines": 2
  },
  "visualFilter": {
    "libraries": [],
    "styles": [],
    "categories": []
  },
  "scenes": [
    {
      "sceneId": "2026011809570315812dcab8bad504b84a76171a1dd620cc5",
      "projectId": "202601180951110906f5645f5952e4211bee28ac6100ddd68",
      "text": "Create Amazing AI Videos",
      "sentence": [
        { "text": "Create " },
        { "highlight": true, "text": "Amazing AI Videos" }
      ],
      "keywords": ["Amazing AI Videos"],
      "category": "TITLE",
      "sortOrder": 10001,
      "durationAuto": 5,
      "layoutId": "20250901134117bbb9d28f462ef350f3",
      "settings": {
        "hideText": true
      },
      "styleData": {
        "fontName": "Plus Jakarta Sans",
        "fontDisplayName": "Plus Jakarta Sans",
        "fontSize": "24",
        "fontColor": "rgb(255,255,255)",
        "textAlign": "center",
        "keywordColor": "rgb(245,240,162)",
        "textBackgroundColor": "rgba(0,0,0,0.35)",
        "textShadowColor": "rgba(0,0,0,1)",
        "textShadowWidthFr": 0.03,
        "maxLines": 2,
        "width": 0.7,
        "preset": "bottom-center"
      },
      "background": {
        "type": "image",
        "elementData": {
          "url": "https://images.example.com/photo.jpg",
          "preview_jpg": "https://images.example.com/photo.jpg",
          "thumb": "https://images.example.com/photo-thumb.jpg",
          "thumb_jpg": "https://images.example.com/photo-thumb.jpg",
          "library": "unsplash",
          "libraryItemId": "mR1CIDduGLc",
          "duration": 0
        },
        "styleData": {
          "kenBurns": "kb-364683-oqt0",
          "imageZoomPan": true,
          "width": 0.7,
          "aspectRatio": 1.78,
          "preset": "center-center",
          "colorOverlay": {
            "hide": false,
            "bgColor": "rgb(0,37,60)",
            "opacity": 0.5
          }
        },
        "settings": {}
      },
      "elements": [
        {
          "elementId": "2026011815294013646c92e549f6646c49f31274227faf54d",
          "type": "video",
          "isLogo": false,
          "hide": false,
          "elementData": {
            "url": "https://videos.example.com/clip.mp4",
            "preview_jpg": "https://videos.example.com/clip-preview.jpg",
            "thumb": "https://videos.example.com/clip-thumb.mp4",
            "thumb_jpg": "https://videos.example.com/clip-thumb.jpg",
            "library": "story_blocks",
            "libraryItemId": "0",
            "duration": 16
          },
          "settings": {
            "loopVideo": true,
            "muteClipAudio": true
          },
          "styleData": {
            "top": 4.89,
            "left": 3.96,
            "width": 0.9259,
            "aspectRatio": 1.8066,
            "preset": null,
            "height": null,
            "sourceDimensions": {
              "width": 0.9512,
              "aspectRatio": 1.7778,
              "relYPercent": -0.0273,
              "relXPercent": -0.0127
            },
            "colorOverlay": {
              "hide": false,
              "bgColor": "rgb(110,111,132)",
              "opacity": 0.3
            }
          }
        },
        {
          "elementId": "202601180957034073d8a97be18614182b23c87f8c7fb2382",
          "type": "text",
          "componentName": "main_title",
          "elementData": {
            "sentence": [
              {
                "text": "Create Amazing AI Videos",
                "decoration": ["decor-underline", "decor-bold"]
              }
            ]
          },
          "settings": {
            "textMode": "writeAnything"
          },
          "styleData": {
            "fontName": "Arial",
            "fontDisplayName": "Arial",
            "fontSize": "42",
            "fontColor": "rgb(255,255,255)",
            "fontWeight": 400,
            "textAlign": "left",
            "keywordColor": "rgba(248, 173, 151, 1)",
            "textBackgroundColor": "rgba(0,0,0,0)",
            "textShadowColor": "rgba(0,0,0,0)",
            "textShadowWidthFr": 0.03,
            "width": 0.9,
            "fullWidth": false,
            "preset": "bottom-left",
            "customFontId": null,
            "animation": {
              "textAnimation": [
                {
                  "name": "Typewriter",
                  "type": ["entry"],
                  "writingStyle": "character",
                  "direction": "up",
                  "speed": { "value": 1 }
                },
                {
                  "name": "None",
                  "type": ["exit"]
                }
              ],
              "textBgAnimation": []
            }
          }
        }
      ],
      "audios": [
        {
          "audio_id": "20260119024821485409b9abeb6c8b4b4cae9357ecbe637cfd67",
          "type": "voiceover",
          "voice": 3036,
          "version": "v6",
          "speed": 100,
          "loudness": 50,
          "clipUrl": "https://audios.example.com/voiceover.mp3",
          "isAudioLinked": true,
          "subScenes": {
            "duration": 1.53,
            "start": 0,
            "end": 1533,
            "word_markers": [
              [0, 300, "Create"],
              [350, 700, "Amazing"],
              [750, 950, "AI"],
              [1000, 1533, "Videos"]
            ]
          }
        }
      ]
    },
    {
      "sceneId": "202601180957031586203f72337a9493893722a4b07b5af7b",
      "text": "Transform your content with powerful AI tools",
      "sentence": [
        {
          "text": "Transform your content",
          "highlight": true,
          "decoration": ["decor-bold", "decor-underline"],
          "case": "none"
        },
        {
          "text": " with powerful ",
          "decoration": ["decor-bold", "decor-underline"],
          "case": "none"
        },
        {
          "text": "AI tools",
          "highlight": true,
          "decoration": ["decor-bold", "decor-underline"],
          "case": "none"
        }
      ],
      "keywords": ["Transform your content", "AI tools"],
      "category": "DEFAULT",
      "sortOrder": 10002,
      "settings": {
        "hideText": false
      },
      "background": {
        "type": "solid",
        "elementData": {
          "color": "rgb(69,123,113)"
        },
        "styleData": {}
      },
      "elements": []
    }
  ],
  "audios": [
    {
      "audioId": "202601180957049641f56b14fa78641359f69ccb5e03aac8c",
      "type": "background",
      "name": "Open Arms",
      "library": "melodie",
      "url": "https://tracks.example.com/background-music.mp3",
      "duration": 191,
      "loudness": 10,
      "speed": 100
    },
    {
      "audioId": "20260119024822426ae1e237bfddc4598b72be30c0c93ec33",
      "type": "voiceover",
      "name": "Abby",
      "library": "elevenlabs",
      "language": "en-US",
      "url": "https://audios.example.com/voiceover-full.mp3",
      "duration": 15.226,
      "loudness": 50,
      "speed": 100,
      "version": "v6",
      "time_markers": [1533, 3874, 8072, 9268, 10715, 12301, 13446, 15226],
      "word_markers": [
        [[0, 300, "Create"], [350, 700, "Amazing"], [750, 950, "AI"], [1000, 1533, "Videos"]],
        [[1533, 2100, "Transform"], [2150, 2400, "your"], [2450, 2900, "content"], [2950, 3200, "with"], [3250, 3600, "powerful"], [3650, 3774, "AI"], [3800, 4200, "tools"]]
      ]
    }
  ]
}

​
Code Examples

Replace YOUR_API_KEY with your actual API key that starts with pictai_
curl --request GET \
  --url 'https://api.pictory.ai/pictoryapis/v2/projects/YOUR_PROJECT_ID' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'accept: application/json' | python -m json.tool