Clipici

Clipici Whoami

Return the authenticated Clipici account: email, plan, minutes used/limit, watermark brands, default caption preset, referral code, glossary terms. Use this first to confirm the API key works.

Clipici Usage

Return current usage/quota: minutes_used, minutes_limit, bonus_minutes, minutes_remaining, plan, upload_limit_mb. Check this before uploading a long video — processing is blocked (HTTP 402) when minutes_remaining hits 0.

Clipici Create Clips

Upload a video to Clipici and start the AI clip-generation pipeline (transcribe → select best moments → cut → burn Romanian captions). Provide EITHER file_path (a local video — works only when this server runs locally over stdio) OR url (a publicly downloadable video URL; note YouTube page links won't work here). Optional: content_type_hint (tv|podcast|vlog| news), trim_start/trim_end (seconds, process only a window), a caption preset (caption_sty

Clipici Caption Video

Caption-only (bring-your-own-video): burn Romanian captions onto a video you already cut, without re-clipping it. Output is a single finished file on the job (no separate clips). Provide file_path (stdio) or url for the video; audio_file_path (stdio only) optionally supplies a separate audio track to transcribe. Returns {job_id, status, queue_position}; retrieve the result with clipici_get_job then clipici_download_job_output.

Clipici List Jobs

List your jobs (newest first), paginated. Optional status filter: pending|transcribing|analyzing|cutting|captioning|done|failed. Returns {jobs, total, page, limit}.

Clipici Get Job

Get a job's full detail, including its clips once processing is done.

Clipici Wait For Job

Poll a job until it finishes (status done/failed) or timeout_sec elapses, emitting live progress to the client. Clip generation takes minutes, so call this AFTER clipici_create_clips and allow a long tool timeout. Returns the final progress payload (or {status:"timeout"} if it ran out of time).

Clipici List Clips

List all clips produced by a job, with title, hook_text, timing, virality_score, aspect_ratio, status, and output/thumbnail URLs. Returns {clips: [...], count: N}.

Clipici Get Clip

Get one clip's full detail (incl. subtitle_text, social_copy, speakers).

Clipici Download Clip

Download a finished clip. With dest_path (stdio only) the MP4 is streamed to that local file/folder → {saved_path, bytes}. Without it, returns a presigned {download_url} (expires in ~1h). Optional watermark controls: platform (tiktok|reels|shorts|universal), brand_id ("off" or a brand UUID), position, size.

Clipici Download Job Output

Download a caption-only job's single output video. With dest_path (stdio) streams the MP4 to disk → {saved_path, bytes}; otherwise call clipici_get_job and use its output_url. Only valid for caption_only jobs.

Clipici Get Captions

Get a clip's captions as subtitle text. format = 'srt' or 'vtt'. Returns {format, content}.

Clipici Regenerate Clip

Re-render a clip with new settings (only the fields you pass change): aspect_ratio (9:16|1:1|16:9), caption_style/size/position, hook_overlay, hook_style, template_type (standard|split_screen|active_speaker|pip), caption_emojis, watermark_override ("off"|"@handle"|brand UUID). Returns {status:"regenerating", clip_id}; poll clipici_get_clip for completion.

Clipici Edit Subtitles

Replace a clip's caption phrases. subtitles is a list of {start, end, text, confidence?} (seconds). Marks the clip's captions as user-edited so later regenerations keep your text verbatim.

Clipici Restore Diacritics

Propose correct Romanian diacritics (ă â î ș ț) for a clip's current captions. Returns {engine, changed_indices, subtitles}. With apply=true the corrected captions are also saved (and the clip marked edited).

Clipici Trim Clip

Trim a clip to a new [start_time, end_time] window (seconds). Fast when the new range is within the existing clip; otherwise re-renders.

Clipici Split Clip

Split a clip into two at split_at (seconds relative to the clip start). Returns {status:"splitting", clip_a_id, clip_b_id}.

Clipici Merge Clips

Merge 2–5 clips from the same job into one montage clip (in the given order). Returns {status:"merging", clip_id}.

Clipici Export Aspect Ratios

Clone a clip into multiple aspect ratios in one go. aspect_ratios is a subset of ["9:16","1:1","16:9"] (default: all three). Returns the new variant clip ids.