Cut.ProDocs
Submissions

Submit a video for clipping

Queues a video for AI clipping. Credits are deducted immediately upon submission. Returns a submission_id to track progress.

Poll GET /clips/{videoId}/submissions/{submissionId} until status is completed or failed, then retrieve the generated clips from GET /clips/{videoId}/submissions/{submissionId}/clips.

Authorization

apiKey
X-Api-Key<token>

In: header

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

POST
/clips
curl -X POST "https://example.com/clips" \  -H "Content-Type: application/json" \  -d '{    "video_id": "string"  }'
{  "submission_id": "string",  "video_id": "string",  "status": "queued",  "credits_charged": 0}

Delete a video DELETE

Permanently deletes a video from your library along with all its submissions and generated clips. This action cannot be undone. Returns `409` if a submission is currently processing.

Analyze a video POST

Fetches metadata for a public video URL and calculates the exact credit cost before you commit to clipping. No credits are charged. Use this as a pre-flight check before calling `POST /clips`. When `credits_unlimited` is `true`, this workspace is on free usage: `credits_cost` still tells you what the job is worth, but submitting it will not move your balance. Rate-limited to **10 requests per minute** per user.