Set thumbnail
Sets the thumbnail for a video. Send multipart/form-data with a file field to upload a custom image (JPG/PNG/WebP, max 5 MB), or send JSON with { "selectGeneratedThumbnail": true, "thumbnailFileName": "thumbnail_1.jpg" } to pick a generated frame.
Authorization
BearerAuth AuthorizationBearer <token>
Pass the raw API key as a Bearer token (Authorization: Bearer <key>). Publishable keys start with mvi_pub_ (playback-scoped). Other prefixes denote private/admin keys for general REST routes. GET /v1/embeds/{embedId}/playback accepts publishable keys only.
In: header
Path Parameters
id*string
Video UUID.
Format
uuidTypeScript Definitions
Use the request body type in TypeScript.
file?unknown
Image file (JPG, PNG or WebP). Max 5 MB.
Response Body
application/json
application/json
application/json
curl -X POST "https://api.moviie.ai/v1/videos/497f6eca-6276-4993-bfeb-53cbbbba6f08/thumbnail" \ -H "Content-Type: application/json" \ -d '{ "selectGeneratedThumbnail": true, "thumbnailFileName": "thumbnail_1.jpg" }'{
"success": true
}{
"error": "Resource not found",
"code": "NOT_FOUND"
}{
"error": "Resource not found",
"code": "NOT_FOUND"
}