Create a character-swapped starting frame
Edits the supplied firstFrame image with google/gemini-3.1-flash-image through the caller’s tenant-scoped Vercel AI Gateway key. The first frame supplies pose, framing, lighting, background, and composition; the required characterId supplies the replacement identity. The returned image is generated with a server-enforced instruction to remove text overlays, captions, subtitles, watermarks, and platform UI. firstFrame 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
Public HTTPS URL of the source video's extracted first-frame image. This image supplies the pose, framing, lighting, background, and composition to preserve. http:// URLs are rejected.
Id of a previously created character (from createCharacter or GET /v1/characters) whose stored image supplies the replacement identity.
Instructions for composing the starting frame (pose, framing, scene).
1