Create a character-swapped starting frame
Composes a clean starting frame for a clone by applying the prompt to the character image, optionally grounded in the source video’s first frame. Supply exactly one of characterImageUrl (a public HTTPS image) or characterId (a previously created character’s id, from createCharacter or GET /v1/characters) to identify the character; supplying both or neither is a validation error. The returned image is guaranteed to be a clean cinematic frame with no text overlays, captions, subtitles, watermarks, or platform UI, regardless of what is present in the source video or requested prompt. All other URLs must be public HTTPS. Synchronous; typically completes within a minute. Shares the daily clone admission limit.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Instructions for composing the starting frame (pose, framing, scene).
1Public HTTPS URL of the character identity image. http:// URLs are rejected. Exactly one of characterImageUrl or characterId must be supplied.
Id of a previously created character (from createCharacter or GET /v1/characters) whose stored image should be used. Exactly one of characterImageUrl or characterId must be supplied.
Optional public HTTPS URL of the source video whose opening frame should ground the composition.