clips

List clip suggestions for a media item

Required permission: media:read

get/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:read)
    • API key in header PAYMENT-SIGNATURE

Path parameters

idstring required

Query parameters

limitinteger

Page size (1..100), default 20. Out-of-range or unparseable clamps into the range.

afterstring

Opaque cursor from the previous page's pagination.nextCursor. Forward-only.

platformstring

Only suggestions cut for this delivery platform.

formatstring

Only suggestions in this output format.

topicstring

Only suggestions matching this topic label.

Response

Clip suggestions envelope.

status'idle' | 'generating' | 'completed' | 'failed' required
createdAtstring nullable required
analyzedAtstring nullable required
jobIdstring nullable required
topicsstring[] required

Changes

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