@cliptude/cli 0.1.18 → 0.1.21
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/cliptude_mcp/server.py +10 -7
- package/package.json +1 -1
- package/pyproject.toml +1 -1
package/cliptude_mcp/server.py
CHANGED
|
@@ -208,9 +208,12 @@ def build_server(*, with_http_auth: bool = False):
|
|
|
208
208
|
"plan_ready, get_narration (numbered sentences), get_kind_catalog (compact first), write the "
|
|
209
209
|
"plan, check_plan until valid, lock_plan, continue_job, then get_plan_report. Before giving the user "
|
|
210
210
|
"the editor link, open_editor_project and look at EVERY frame with view_scenes (0 to the end): replace "
|
|
211
|
-
"any dead body or gore, other brands, logos, game or
|
|
211
|
+
"any dead body or gore, other brands, logos, album art, footage of a game, match or show the video is not about, title cards, pictures whose place or era "
|
|
212
212
|
"contradicts the story (a search naming a place can return a namesake elsewhere), near-black frames, clips floating in black bars, broken AI pictures and any picture held over ~8 s, in a free revision, then review again. Generic "
|
|
213
|
-
"shots of places name the story's setting (\"empty bed mud house\", not \"empty bed dark room\").
|
|
213
|
+
"shots of places name the story's setting (\"empty bed mud house\", not \"empty bed dark room\"). A video "
|
|
214
|
+
"about a video game, sport, creator or TV show searches the real thing (\"GTA 6 gameplay driving\", "
|
|
215
|
+
"\"Bellingham Real Madrid goal\", \"Kai Cenat stream\"): its own footage is the footage, broadcaster and "
|
|
216
|
+
"channel logos included, never real-world stand-ins for it. True "
|
|
214
217
|
"stories (real events and people) set sense.true_story and sense.people and never search for people: a "
|
|
215
218
|
"stranger on screen is taken for the real person (check_plan refuses it, stand_in_person; a dated topic "
|
|
216
219
|
"naming people counts as true unless true_story is false, and its year is the default era). See the "
|
|
@@ -772,7 +775,7 @@ def build_server(*, with_http_auth: bool = False):
|
|
|
772
775
|
script_id: Annotated[str, Field(min_length=8, description="script_id / job_id from draft_product_script, once script_ready")],
|
|
773
776
|
aspect_ratio: Annotated[str, Field(description="16:9 (YouTube), 9:16, 1:1 or 4:5")] = "16:9",
|
|
774
777
|
) -> dict[str, Any]:
|
|
775
|
-
"""Start BUILDING the video from the approved script on the same job id: voiceover, sourcing, motion graphics, and the merchant's real product photos composited into the closing product boards. This does not render the final MP4: when the build is done (ready_for_review) review it, show the user the editor_url and wait for their go-ahead before render_project. Returns {job_id, status, stage, editor_url, estimated_minutes} immediately;
|
|
778
|
+
"""Start BUILDING the video from the approved script on the same job id: voiceover, sourcing, motion graphics, and the merchant's real product photos composited into the closing product boards. This does not render the final MP4: when the build is done (ready_for_review) review it, show the user the editor_url and wait for their go-ahead before render_project. Returns {job_id, status, stage, editor_url, estimated_minutes, credits_reserved, credits} immediately (credits: charged so far, held while it builds, and the full-generation estimate); quote them to the user. Never wait in this call. Poll get_product_video_status."""
|
|
776
779
|
try:
|
|
777
780
|
return _client().render_product_video(script_id, aspect_ratio=aspect_ratio)
|
|
778
781
|
except Exception as exc:
|
|
@@ -785,7 +788,7 @@ def build_server(*, with_http_auth: bool = False):
|
|
|
785
788
|
def get_product_video_status(
|
|
786
789
|
job_id: Annotated[str, Field(min_length=8, description="Job id from draft_product_script / render_product_video")],
|
|
787
790
|
) -> dict[str, Any]:
|
|
788
|
-
"""Stage of a product video (script_drafting, script_ready, producing, ready_for_review, rendered, failed) with the script once written, the editor_url to preview, the MP4 URL once rendered, and next_step telling you what to do."""
|
|
791
|
+
"""Stage of a product video (script_drafting, script_ready, producing, ready_for_review, rendered, failed) with the script once written, the editor_url to preview, the MP4 URL once rendered, credits {charged, reserved, estimate, estimate_with_buffer} and next_step telling you what to do. The editor's export_credits_due is 0 until a first export exists (the first export of a video is free)."""
|
|
789
792
|
try:
|
|
790
793
|
return _client().get_product_video_status(job_id)
|
|
791
794
|
except Exception as exc:
|
|
@@ -971,7 +974,7 @@ def build_server(*, with_http_auth: bool = False):
|
|
|
971
974
|
Field(description="Local picture (JPG/PNG/WEBP/GIF, up to 15 MB) or clip (MP4/MOV/WEBM/M4V, up to 300 MB). Stdio / local MCP only: on a remote host (mcp.cliptude.com) use start_media_upload + finish_media_upload, which work from any agent that can run curl."),
|
|
972
975
|
],
|
|
973
976
|
) -> dict[str, Any]:
|
|
974
|
-
"""Send a picture or clip you found yourself to a plan job. The file goes straight to Cliptude's storage on signed URLs (no storage keys needed) and is checked to be a real picture or video. Returns {keep, file, media_type, size}: put {"keep": "<id>"} as a beat's media or a graphic's picture slot, with start_s/end_s on a beat to play only part of a clip."""
|
|
977
|
+
"""Send a picture or clip you found yourself to a plan job. The file goes straight to Cliptude's storage on signed URLs (no storage keys needed) and is checked to be a real picture or video, and for nudity and gore (refused). Returns {keep, file, media_type, size, notes?}: put {"keep": "<id>"} as a beat's media or a graphic's picture slot, with start_s/end_s on a beat to play only part of a clip. notes say where a clip runs into a title or logo card or a weapon aimed at someone: trim it with start_s/end_s as they say."""
|
|
975
978
|
try:
|
|
976
979
|
return _client().upload_plan_media(job_id, path)
|
|
977
980
|
except Exception as exc:
|
|
@@ -1004,7 +1007,7 @@ def build_server(*, with_http_auth: bool = False):
|
|
|
1004
1007
|
key: Annotated[str, Field(min_length=1, description="key from start_media_upload")],
|
|
1005
1008
|
upload_id: Annotated[str, Field(min_length=1, description="upload_id from start_media_upload")],
|
|
1006
1009
|
) -> dict[str, Any]:
|
|
1007
|
-
"""Close an upload after every part is PUT. Cliptude checks it is a real picture or video and returns {keep, file, media_type, size}: put {"keep": "<id>"} as a beat's media or a graphic's picture slot (start_s/end_s on a beat to play part of a clip)."""
|
|
1010
|
+
"""Close an upload after every part is PUT. Cliptude checks it is a real picture or video (nudity and gore are refused) and returns {keep, file, media_type, size, notes?}: put {"keep": "<id>"} as a beat's media or a graphic's picture slot (start_s/end_s on a beat to play part of a clip). notes say where a clip runs into a title or logo card or a weapon aimed at someone: trim it as they say."""
|
|
1008
1011
|
try:
|
|
1009
1012
|
return _client().finish_media_upload(job_id, key=key, upload_id=upload_id)
|
|
1010
1013
|
except Exception as exc:
|
|
@@ -1145,7 +1148,7 @@ def build_server(*, with_http_auth: bool = False):
|
|
|
1145
1148
|
start_s: Annotated[float, Field(ge=0, description="First second to show")] = 0.0,
|
|
1146
1149
|
end_s: Annotated[float | None, Field(description="Stop before this second (default: the end)")] = None,
|
|
1147
1150
|
) -> list[str | Image]:
|
|
1148
|
-
"""See what the timeline shows, without opening any link: numbered contact sheets of every picture, a frame of every clip and
|
|
1151
|
+
"""See what the timeline shows, without opening any link: numbered contact sheets of every picture, a frame of every clip and every board (graphic) drawn as the export draws it, with the footage under it and anything on top, with the narration under each, plus a legend (tile, item_id, start_s, end_s, words, said, flags: REPEATED PICTURE, HELD, AI STILL, DARK, BARS, BARE BOARD, BOARD PENDING). Up to 24 tiles per call; call again from next_start_s. When the answer has boards_pending, the boards are still rendering: call again with the same start_s in about a minute. Use it to review a built video yourself (other brands, wrong pictures, repeats, leftover text, boards with no picture, wrong or placeholder text on a board) before giving the user the editor link, and again after run_agent to check the change."""
|
|
1149
1152
|
try:
|
|
1150
1153
|
data = _client().view_scenes(project_id, start_s=start_s, end_s=end_s)
|
|
1151
1154
|
except Exception as exc:
|
package/package.json
CHANGED
package/pyproject.toml
CHANGED