clips

Trigger clip-suggestion analysis

Analyze a video for its best short-form moments — returns ranked clip suggestions with trims, hooks, titles, captions, hashtags, and platform fit for turning long footage into shorts. Async: returns 202; poll GET /media/:id/suggestions for the ranked results.

post/v1/media/{id}/suggestions

Request

  • Base URL: https://api.cueframe.ai
  • URL: https://api.cueframe.ai/v1/media/{id}/suggestions
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.cueframe.ai/api/auth/mcp/authorize, token URL https://api.cueframe.ai/api/auth/mcp/token, scopes: media:write)
    • API key in header PAYMENT-SIGNATURE

Path parameters

idstring required

Response

Analysis triggered.

status'queued' | 'running' | 'complete' | 'failed' required
alreadyRunningboolean

Changes

No recorded changes to this operation across all 1 revision of this API.