studio.create_social_clip
Make one short as a NEW studio project from a range of an existing project: the finished scenes in the range are trimmed copies (no footage is generated or billed again), the captions move with them and the new project takes the target preset's shape. The source project is not changed. Free. Use the start_ms, end_ms and composition_version from studio.suggest_social_clips. Calling again within 24 hours with the same range, preset and version returns the same project (replayed: true) instead of a second copy; after 24 hours the same call makes a new project. Refuses, creating nothing: a composition_version that is no longer current (409 SIMPLER_STUDIO_CLIPS_STALE_VERSION names the current version; suggest again or resend with it), the same short made within 24 hours whose project was since deleted (409 SIMPLER_STUDIO_CLIPS_EARLIER_SHORT_GONE; move start_ms or end_ms by a few milliseconds to make it again), a range outside one stretch of finished footage or outside 5 to 60 s (shorter still when the preset's own limit is lower), read-only tokens and viewer roles. Next: video.export_create with the returned project_id and the same preset.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | Optional name for the new project (a suggestion's title). | |
| end_ms | Yes | Where the short ends on the source timeline, in milliseconds (a suggestion's end_ms). | |
| start_ms | Yes | Where the short starts on the source timeline, in milliseconds (a suggestion's start_ms). | |
| project_id | Yes | The source studio project (vp_...) the suggestion came from. | |
| target_preset | No | The export preset the short is for (default shorts_9x16); the new project takes its shape. | |
| composition_version | No | The source composition_version the range was chosen on (the suggest result carries it). When the source has changed since, nothing is created and the answer names the current version. |