clips

Clip, its video and the edit state for an orientation

Creates the default edit for the orientation if missing (layout = orientation, one full-frame keyframe, subtitles = account preset). updateClipEdit is a partial patch, so reading first is optional.

get/api/clips/{id}

Request

  • Base URL: https://cliponit.app
  • URL: https://cliponit.app/api/clips/{id}
  • Auth: one of:
    • HTTP bearer
    • API key in cookie session
    • OAuth 2 (authorization code, authorization URL https://cliponit.app/oauth/authorize, token URL https://cliponit.app/oauth/token, scopes: clips)

Query parameters

orientation'vertical' | 'horizontal' | 'square' | 'portrait45'

vertical = 9:16 1080x1920 (TikTok/Reels/Shorts), horizontal = 16:9 1920x1080 (YouTube), square = 1:1 1080x1080 (feed), portrait45 = 4:5 1080x1350 (Instagram feed). auto-reframe supports vertical|horizontal only.

Which edit/export: vertical (9:16, default), horizontal (16:9), square (1:1) or portrait45 (4:5). Each clip has one independent edit per orientation.

Response

Clip + video + edit

Example response

{
  "clip": {
    "id": "6f1c2d6e-3b1a-4c0f-9a0e-2f5d1c7b8e90",
    "video_id": "6f1c2d6e-3b1a-4c0f-9a0e-2f5d1c7b8e90"
  },
  "video": {
    "id": "6f1c2d6e-3b1a-4c0f-9a0e-2f5d1c7b8e90"
  },
  "edit": {
    "keyframes": [
      {
        "t": 0,
        "layout": "vertical",
        "zones": [
          {
            "x": 0.3,
            "y": 0,
            "w": 0.4,
            "h": 1
          }
        ],
        "ease": "cut"
      }
    ],
    "subtitles": {
      "enabled": true,
      "color": "yellow",
      "case": "normal",
      "lang": "original",
      "overrides": [],
      "style": "karaoke",
      "font": "Inter",
      "position": "bottom",
      "size": 2,
      "words_per_line": 5,
      "animate": true
    },
    "music": {
      "music_id": "6f1c2d6e-3b1a-4c0f-9a0e-2f5d1c7b8e90"
    },
    "emojis": [
      {
        "emoji": "🔥"
      }
    ]
  }
}

Changes

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