Analyze a video
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.
Authorization
apiKey In: header
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
application/json
curl -X POST "https://example.com/clips/info" \ -H "Content-Type: application/json" \ -d '{ "url": "string" }'{ "video_id": "string", "title": "string", "description": "string", "author": "string", "platform": "string", "duration": 0, "thumbnail_url": "string", "credits_cost": 0, "credits_original": 0, "discount_percent": 0, "force_watermark": true, "current_balance": 0, "credits_unlimited": true}Submit a video for clipping POST
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`.
List submissions GET
Returns a paginated list of all clipping submissions for a video, newest first. Use this to audit past runs, find a specific submission ID, or check whether a job is still in progress.