Trim Video

​

Description

This endpoint allows users to trim a video from a specified URL based on start and end timestamps. The trimmed video is then uploaded to R2 storage, and the URL of the trimmed video is returned.

​

Endpoint

POST /api/v1/trim-video

​

Headers

• Content-Type: application/json
• Authorization: Bearer <API_KEY> (required)

​

Request Body

{
  "videoUrl": "string", // Required. The URL of the video to trim. Only MP4 videos are supported.
  "startTimestamp": "string", // Required. The start time of the trim in HH:MM:SS format.
  "endTimestamp": "string" // Required. The end time of the trim in HH:MM:SS format.
}

​

Responses

​

Success (200)

Returns the URL of the trimmed video and the number of credits used.

{
  "trimmedVideoUrl": "string", // URL of the trimmed video
  "creditsUsed": "number" // Number of credits used for this operation
}

• X-RateLimit-Limit: The rate limit for the user.
• X-RateLimit-Remaining: The remaining number of requests for the user.

​

Bad Request (400)

Returned if the request is invalid or missing required parameters.

{
  "error": "Error message describing the issue"
}

​

Internal Server Error (500)

Returned if there’s an error during the video trimming process.

{
  "error": "Failed to trim video"
}

​

Example Request

curl -X POST https://app.dumplingai.com/api/v1/trim-video \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
  "videoUrl": "https://example.com/video.mp4",
  "startTimestamp": "00:00:10",
  "endTimestamp": "00:00:30"
}'

​

Example Response

{
  "trimmedVideoUrl": "https://storage.example.com/trimmed-videos/abcdef123456.mp4",
  "creditsUsed": 5
}

​

Notes

• The timestamp format should be HH:MM:SS (e.g., 00:01:15 for 1 minute and 15 seconds).
• Credits used are calculated based on the duration of the output video (20 credits per minute, rounded up).
• Output videos are limited to 200MB in size. You can reduce the size of the output video by trimming a smaller portion of the input video.
• The trimmed video is temporarily stored (~24 hours).

​

Rate Limiting

Rate limit headers (X-RateLimit-Limit and X-RateLimit-Remaining) are included in the response to indicate the user’s current rate limit status.