Clip Model

Clip objects are returned in the clips array when GET /workflow-results/{triggerId} finishes with status: "Completed" and in the clip field from GET /clip. Use id as clipId for update and render calls. Workflow result responses return the basic clip fields listed below. GET /clip returns the latest saved clip document and can include additional metadata, source URLs, subtitle configuration, and legacy aliases. Fields are included when available, so some values may be omitted on a given clip. Use renderedUrl as the preview video when present, then call POST /render when you need a finalized export.

Basic Example

{
  "id": "0e3b1690-3bad-42cc-810d-87fd433054b8",
  "title": "Startup Founder: You're Your Startup's Biggest Threat",
  "bio": "An experienced startup founder and investor explains a key startup risk.",
  "keywords": ["startup", "founder psychology", "self-awareness"],
  "people": ["Startup Founder"],
  "duration": 51.724999,
  "startTimestamp": 0.0,
  "endTimestamp": 51.724999,
  "timestampBoundary": {
    "start": 0.0,
    "end": 30.0
  },
  "aspectRatio": "16:9",
  "renderedUrl": "https://cdn.overlap.ai/fe249157-6be2-4fce-9aec-961f800604f1.mp4",
  "thumbnailURL": "https://cdn.overlap.ai/thumbnails/ce99b3c5-4d5d-4cc4-ae69-b835d23fe77a_thumb.jpg",
  "viralityScore": 89.5
}

Basic Properties

These fields may appear in clips returned from workflow result endpoints and GET /clip.

Property	Type	Description
`id`	string	Unique identifier for the clip. Use this as `clipId` for `/update-clip` and `/render`.
`title`	string	Clip title.
`bio`	string	Short contextual description for the clip.
`keywords`	string[]	Keywords or tags associated with the clip.
`people`	string[]	People or speakers featured in the clip.
`duration`	number	Total duration of the clip in seconds.
`startTimestamp`	number	Timestamp, in seconds, where the clip starts in the source video.
`endTimestamp`	number	Timestamp, in seconds, where the clip ends in the source video.
`timestampBoundary`	object	Object defining the clipping boundary.
`timestampBoundary.start`	number	Start boundary, in seconds, for clip extraction.
`timestampBoundary.end`	number	End boundary, in seconds, for clip extraction.
`aspectRatio`	string	Clip aspect ratio, such as `"16:9"` or `"9:16"`.
`renderedUrl`	string	Public preview video URL when available. May be omitted if the clip has not been rendered or does not have a preview URL yet.
`rawUrl`	string	Raw clip URL when available.
`thumbnailURL`	string	Thumbnail image URL.
`transcriptUrl`	string	JSON transcript URL when available.
`fps`	number	Frames per second when available.
`videoHeight`	number	Video height in pixels when available.
`videoResolution`	string	Video resolution when available, such as `"1920x1080"`.
`viralityScore`	number	Score estimating predicted clip performance.

Additional `GET /clip` Properties

These fields are returned only by GET /clip when they exist on the saved clip document. They are not part of the basic clip object returned by workflow result endpoints.

{
  "companyId": "org_2yCncPJwBymLmSQlC9Vwk6rHG3e",
  "createdAt": "Tue, 09 Jun 2026 07:08:02 GMT",
  "sourceUrl": "https://storage.googleapis.com/overlap-source-videos/source.mp4",
  "subtitleConfig": {
    "fontSize": "28",
    "maxCharsPerLine": 20,
    "subtitleY": 50,
    "speakerStyles": {
      "0": {
        "fontColor": "#ffffff",
        "fontFamily": "TheBoldFont",
        "animationStyle": "spring-word"
      }
    }
  }
}

Property	Type	Description
`url`	string	Public clip video URL when available.
`publicURL`	string	Public clip video URL when available. Often the same asset as `url` or `extendedClipURL`.
`extendedClipURL`	string	Public URL for the generated or extended clip media.
`renderedThumbnailUrl`	string	Thumbnail image URL generated during rendering.
`wordTranscriptJSON`	string	Word-level transcript JSON URL when available. Often the same asset as `transcriptUrl`.
`companyId`	string	Company or organization id that owns the clip.
`enterpriseId`	string	Enterprise organization id when the clip belongs to an enterprise account.
`teamId`	string	Team identifier associated with the clip.
`workflowId`	string	Workflow id that produced the clip when available.
`runId`	string	Workflow run id or generation run id when available.
`taskId`	string	Generation task id associated with the clip.
`taskID`	string	Legacy uppercase alias for `taskId`.
`sourceId`	string	Source media id associated with the clip.
`sourceID`	string	Legacy uppercase alias for `sourceId`.
`sourceInputId`	string	Source input id when the clip was produced from a workflow input.
`clipHash`	string	Stable hash for the generated clip media or transcript source when available.
`createdAt`	string	Creation timestamp for the saved clip document.
`normalizedUrl`	string	Normalized or proxied source video URL when available.
`originalUrl`	string	Original source media URL submitted to Overlap.
`sourceUrl`	string	Source media URL associated with the clip.
`speakers`	string[]	Speaker names or identifiers when speaker data is available.
`subtitleConfig`	object	Subtitle rendering configuration, including optional base style fields and `speakerStyles`.
`subtitleId`	string	Identifier for the selected subtitle preset when available.
`subtitleY`	number	Subtitle vertical position when stored separately from `subtitleConfig`.

Some clip responses include legacy aliases, such as taskID with taskId or sourceID with sourceId. Prefer the camelCase fields in new integrations.

Get Results

Retrieve clips after a workflow completes

Update Clip

Save editable fields before rendering

Render Clip

Render a finalized export

Workflows

Clip

Analytics

Misc

Basic Example

Basic Properties

Additional `GET /clip` Properties

Get Results

Update Clip

Render Clip

​Basic Example

​Basic Properties

​Additional GET /clip Properties

​Related Endpoints

Get Results

Update Clip

Render Clip

Basic Example

Basic Properties

Additional `GET /clip` Properties

Related Endpoints