Skip to Content
Cut.ProDocs
Clipping: clips

Rate a clip

Marks a clip as good (up) or bad (down, with the reason), or clears the vote with null. The votes teach the AI what to pick for you. A down on a clip the AI itself rated 5 or lower refunds part of the submission's credits, up to 20% of what it cost and within a monthly cap; the amount comes back in refunded_credits.

Authorization

apiKey
headerX-Api-Key<token>

Path Parameters

videoId*string

Video id, from POST /videos/info or GET /videos

submissionId*string

Submission id, from GET /videos/{videoId}/submissions

clipId*string

Clip id, from the submission's clip list

Match^[0-9]{1,20}$

Request Body

feedback: up, down or null to clear. reason, for a down: bad_cut (starts or ends in the wrong place), bad_duration, wrong_framing, caption_errors or other

  1. body

feedback: up, down or null to clear. reason, for a down: bad_cut (starts or ends in the wrong place), bad_duration, wrong_framing, caption_errors or other

feedback*|
Value in"up""down"
reason?string
Value in"bad_cut""bad_duration""wrong_framing""caption_errors""other"

Response Body

Response for status 200

application/json
  1. response
refunded_credits*number

Credits returned by this vote; 0 when none

POST
/videos/{videoId}/submissions/{submissionId}/clips/{clipId}/feedback
Example Request
curl -X POST 'https://api.cut.pro/api/v1/videos/string/submissions/string/clips/string/feedback' \  -H 'Content-Type: application/json' \  -d '{  "feedback": "up"}'
Example Response
{  "refunded_credits": 0}