- Ingest Integration Workflow
- Authentication
- MediaHub API
- Search API
- event
- search
- session
- query
- person
- slug
- object
- recording
- caption
- srt
- scene
- doc
- health
- apiv2
- appearance
- Get appearance list
- Get content click v2
- Get caption by source object
- Get TVU 264 status
- Get appearance relations
- Search captions by keyword
- Get scene change info v2
- Search events by source object and time
- Cross-type media content search (v2)
- Appearance search
- Get latest event for source objects
- Get appearance name suggestions
- Get recordings for an event object
- Get media files
- Get media files by IDs
- Get name suggestions
- Auto complete
- Search user source objects
- Search persons by source object
- Search person face appearances
- Search person track by source object
- Get settings
- Get search suggestions
- Get supported languages
- Get recorded files
- Search words
- import test
- ai search
- extract
- public
- MediaMind Story Creation
- Object API
- GraphQL
- RESTful
- status
- 文档
- Grid API
- getSession
- getDeviceList
- addPackToken
- removePackToken
- queryPairedR
- queryPairedT
- queryPairedToken
- getGridMetadata
- updateGridMetadata
- deleteExt
- getThumbnail
- listSocialAccount
- startPushLive
- stopPushLive
- addEvent
- deleteEvent
- listEvent
- queryEvent
- batchHandleEvent
- getStatus
- queryPairedTGeoByRid
- setLiveParameters
- startLive
- stopLive
- addExt
- getAvailableDevice
- listShareAccount
- getRealTimeLiveParameters
- Producer API
- Channel API
- UsageService API
- Media Service For Producer
- Partyline API
- party
- join
- party status
- checkV2
- gallery join
- get by code
- page
- join anywhere
- meetingAnywhere
- anywhere join
- queryByRtilCode
- queryByPartyCode
- listCurrentPartyByUserID
- command managerMute
- Receiver Join party_ccR
- Receiver Join party_ppR
- Receiver leave party
- Receiver start gallery
- status
- reset status
- delete
- getOnlineUserList
- listPartyMembers
- reportUserChange
- create
- update
- check
- checkInvite
- voIPStaus
- party
- Commentator API
- Workflow API
- shortcut API
- ScteService API
- MOS Gateway API
- Export api
- Input&Output Module API
- public
- Export
- Media Info
- Create a new slug and trigger recording.POST
- versionGET
- Update an existing slug and its recording configuration.POST
- metadataGET
- upload-to-zypePOST
- estimate-video-sizePOST
- estimate-video-sizeGET
- 查询Object信息POST
- Get object information from the search index by object ID.GET
- Create a new objectPOST
- Update an existing object.PUT
- Delete an object (requires authentication).DELETE
- Query detailed object information by a list of object IDs.POST
- Query all objects bound to a given tangible ID.GET
- Check whether a specific feature is enabled for a set of objects.POST
- Check whether the specified user is an admin or owner of the given object.POST
- Unlink (detach) a tangible from an object.POST
- Bind a tangible to an object.POST
- Copy an object and bind the copy to a new tangible.POST
- Place a hold on an object to reserve it for exclusive use by an application.POST
- Release a previously held object.POST
- Create a new tangible and bind it to an existing object in a single operation.POST
- Schemas
- Schemas
- Pet
- Category
- controllers.QueryAnalyzeReq
- PageShortcut
- Tag
- MediaProfileDTO
- controllers.GenMarkSrtBySIDReq
- ResultRunOutputVO
- UserShortcutQuery
- controllers.QuerySuggestReq
- TriggerRequest
- RunOutputVO
- Object
- controllers.AutoGenerateFileResp
- ResultVoid
- controllers.ApiCapTagParm
- AgentUpdateWorkFlowDTO
- controllers.QuerySynonymsReq
- Shortcut
- RunInputVO
- RunOutPutDTO
- controllers.ApiClickParm
- Input
- GetUserShortcutRequest
- ResultPageInfoRunInputVO
- controllers.CheckHealthResponse
- RunInputDTO
- Output
- controllers.ApiFaceFrameParm
- ShortcutUpdateRequest
- models.AutoGenerateReq
- PageInfoRunInputVO
- controllers.DrawFaceFrameResp
- AgentWorkFlowDTO
- ResultRunInputVO
- controllers.ApiFramePersonParm
- SortField
- controllers.DrawFaceFrameRetuen
- SourceObjectListDTO
- controllers.ApiGetFaceParm
- AddSourceObjectDTO
- controllers.FaceGlobalListResp
- controllers.ApiGetSrtByPeerIdParm
- LoginUser
- controllers.FaceInfoReturnData
- controllers.ApiGetSrtParm
- OutputLiveVo
- ProjectRecordVo
- ResponseResultProjectRecordVo
- controllers.FaceListResp
- models.QueryHintsReq
- models.SceneInfoRequest
- controllers.FramePersonInfoResp
- controllers.CapReturnHandleData
- controllers.GenMarkSrtReq
- controllers.CapTagResp
- models.SearchCapWithTagsReq
- controllers.GenUploadSrt
- controllers.ClickQueryResp
- controllers.GetFaceAssetNumResp
- controllers.ClickQueryReturnData
- controllers.GetLangReq
- controllers.GetMarkerResp
- controllers.GetObjectByTangibleResp
- controllers.FaceFrameResp
- controllers.GetObjectFeatureConfResp
- controllers.GetRRSTaskListResp
- controllers.GetRecordContentResp
- controllers.GetRecordingInfoResp
- controllers.FramePersonResp
- controllers.GetStoreInfoByGroupIdReq
- controllers.GetFacePosition
- controllers.GetStoreInfoByGroupIdResp
- controllers.GetFaceResp
- controllers.GetFaceReturnData
- controllers.GetTagValueByTaskIdResp
- controllers.GetFaceReturnDataList
- controllers.HealthReturnData
- controllers.MergeListResp
- controllers.NameSuggestMergeListResp
- controllers.PersonFaceAssetNumReq
- controllers.PersonInfoV3Resp
- controllers.PersonListResp
- controllers.PersonNameResp
- controllers.QueryAnalyzeResp
- controllers.QueryHintsResp
- controllers.GetSrtResp
- controllers.QuerySuggestResp
- controllers.QuerySynonymsResp
- controllers.SceneChangeInfoReturn
- controllers.SearchCombtagsCaptionResp
- controllers.SearchDurationIntervalReq
- controllers.SearchMediaByMpdResp
- controllers.SearchDurationIntervalResp
- controllers.SearchMediaByTsResp
- controllers.SearchMediaByUidResp
- controllers.SearchMediaObjectResp
- controllers.SearchPersonListResp
- controllers.SearchSlugCapWithTagsResp
- controllers.QuerySubTittle
- controllers.SearchSlugWithTagsResp
- controllers.SearchStoryResp
- controllers.SimpleMarkSrtReq
- controllers.SlotStrengthResp
- controllers.SearchTaskIntervalReq
- controllers.SearchCapWithTagsTittle
- controllers.StoryGlobalListResp
- controllers.SearchTaskIntervalResp
- controllers.StoryListResp
- controllers.StoryReturnData
- controllers.SubstanceListReturnData
- controllers.TestInterResponse
- controllers.TaskOperationIntervalReq
- controllers.UpdatePortraitReq
- controllers.UpdatePortraitResp
- controllers.UrlAddrResp
- controllers.UrlInfoResp
- controllers.UrlReturnData
- models.EsAdminInfo
- models.EsFaceFrameStateData
- controllers.SrtSubTittle
- models.EsFeatureInfo
- models.EsGpsInfo
- models.EsMarkerReturnData
- models.EsObjectData
- models.EsObjectFeature
- controllers.SuggestParm
- models.EsOwnerInfo
- models.EsPlaceholdersData
- models.EsStoryData
- models.EsSynonymsData
- models.FaceAssetNumReturnData
- models.FaceInfoQReq
- models.GetObjectByTangibleReq
- models.GetObjectFeatureConfReq
- models.FileListItem
- models.HlStory
- models.MMAStoreGroup
- models.MarkerQReq
- models.MediaObjectByUidQReq
- models.MediaObjectQReq
- models.MediaObjectResult
- models.PeerIdAgg
- models.PeerIdBuckets
- models.PilotQReq
- models.RRSTaskCompleteList
- models.RRSTaskListQInfo
- models.RRSTaskListQReqFilter
- models.RecordContentQReq
- models.RestoreDuration
- models.SearchCombTagCaptionReq
- models.RestoreInfo
- models.SearchMediaByMpdReq
- models.SearchMediaByTsReq
- models.SearchStoryWithTagsReq
- models.Size
- models.UrlInfoData
- models.UserUsage
- service.AnaData
- models.SearchCapReturnData
- Sample Schemas
- Producer
- Schemas
- SourceSwitchVo
- PlayListItem
- UserSingularApp
- SourcePVWSwitchVo
- PlayList
- VideoMotion
- ProgramGang
- UpdateAISettingRequest
- PlayReq
- PlayAllClipPlayerRequest
- UserCustomSource
- AudioTransactionReqVo
- ProgramSource
- FileInfo
- ProgramPlaylist
- AddSourceParam
- ProgramPlaylistQuery
- StopLiveRequest
- UploadSourceThumbnailRequest
- Overlay
- OverlayRequest
- SourceParamVo
- ClipPlayer
- Program
- CreateRTPFECSourceParam
- ProgramGraphicUrl
- OverlayPIP
- ProgramQuery
- ProgramVO
- ProgramInput
- Slot
- PvwPgm
- RTILUser
- AddOrRemoveMembersRequest
- CreateSRTSourceParam
- FileUploadResponseForS3
- ProgramFeaturesInput
- SourceDelayRequest
- ProgramTeamMember
- SlaveProgramAndFeature
- GangOperateRequest
- FileInfoQueryRequest
- StudioLogo
- UploadSourceResult
- ProgramPrivateServer
- Features
- OverlayLogo
- ObjectResource
- ProgramFeature
- ProductionUser
- ProgramButton
- LBand
- FileSourceActionVo
- LocalVideo
- UploadFile
- OverlayUrl
- UploadSourceRequest
- Transition
- Schemas
- Response
- ResponseResult
- Result«Map«Object»»
- Obj
- controllers.SubstanceListClickReq
- PublicDestination
- controllers.ActiveSearchResp
- 记录不存在
- Record not found
- ProcessResultObject
- MmaRecordingParam
- AudioPaddingInfo
- sortOptions
- OutputDTO
- ObjectDetailsInfo
- controllers.AgentSearchItems
- 参数不正确
- Invalid input
- UpdateVideoEncoderReq
- RrsRecordingParam
- VideoPaddingInfo
- Result
- ProcessResultListObjectDetailsInfo
- controllers.AgentSearchReq
- ReTranscribe
- CreateSlugRecordParam
- ThumbnailBaseInfo
- Map«Object»
- GraphqlResult
- controllers.AgentSearchResp
- UpdateSlugRecordParam
- VideoBaseInfo
- AudioEncoderParam
- key
- UpdateObjectParam
- controllers.AutoCompleteResp
- SourceObj
- SourceFile
- EditEncodingProfileDTO
- Result«CheckPartyVo»
- ProcessResult
- controllers.CapReturnData
- Destination
- VideoEncoderParam
- CheckPartyVo
- CopyObjectParam
- controllers.CaptionResp
- StopPreviewParam
- Transcribe
- ProfileApiVo
- TagValueVo
- DeleteObject
- controllers.CaptionSearchReq
- ResponseResultProfileApiVo
- CommonPartyInfo
- ProcessResultBoolean
- controllers.CaptionSearchResp
- VideoInfo
- OutputQueryDTO
- ProcessResultMapBoolean
- PublicExportReq
- controllers.CaptionSearchResult
- BasePreviewVO
- PublicLongexportReq
- OutputVo
- CheckObjectFeature
- EnableOutputDTO
- controllers.ContentV2Item
- Attribute
- EstimateVideoSizeReq
- PageResultOutputVo
- CheckObjectAdmin
- controllers.ContentV2Resp
- ExportAudioReqV2
- ResultPageResultOutputVo
- ObjTgbRelation
- controllers.EventItem
- MergeVideoReq
- CreateOutputDTO
- HoldObjectParam
- ProjectRecord
- controllers.EventRecordingsResp
- OutputEncodingProfilePairDTO
- ReleaseObjectParam
- CutJsonReqV2
- controllers.EventResp
- UpdateAudioEncoderReq
- PairVo
- CreateTangibleAndBind
- PublicExportRes
- controllers.FetchAllObjectTagResp
- ResponseResultBasePreviewVO
- PublicLongexportRes
- ResponseResultListPairVo
- AdminInfo
- controllers.GenMarkSrtResp
- EstimateVideoSizeRes
- EncodingProfileDTO
- OwnerInfo
- controllers.GetInterValReq
- ExportAudioResV2
- PairDetailVO
- FeatureInfo
- DisableOutputDTO
- controllers.GetIntervalResp
- MergeVideoRes
- ResponseResultListPairDetailVO
- GeoInfo
- controllers.GetObjectDetailResp
- AudioEncoderRes
- ObjectRecyclingBin
- CutJsonRes
- controllers.GetObjectTagSuggestionResp
- GetThumbnailResV2
- EncodingTier
- CreateObjectAttr
- controllers.GetRecordingInfoV2Resp
- GetMetadataRes
- ResponseResultListSingleTierEncodingProfileRes
- NestedObjects
- controllers.GetScteMarkerInfoResp
- SingleTierEncodingProfileRes
- OperatorInfo
- ObjectConnectInfo
- controllers.GetSummarizationResp
- VideoEncoderRes
- TangibleInfo
- controllers.GetVersionResponse
- QueryEncodingProfileVO
- TagInfo
- controllers.LatestEventResp
- ResponseResultQueryEncodingProfileVO
- TypeInfo
- controllers.MediaFileByIdsReq
- Audio
- controllers.MediaFileByIdsResp
- DestinationLiveDTO
- LabelAndValue
- MapBoolean
- controllers.MediaFileResp
- ProfileTemplateVo
- controllers.MediafileItem
- ResponseResultProfileTemplateVo
- controllers.NameSuggestionResp
- Video
- controllers.ObjectItem
- UpdateSourceObjectDTO
- controllers.ObjectResp
- PermissionDTO
- ObjectInfoDTO
- controllers.PersonInfoItem
- ResponseResultObjectInfoDTO
- controllers.PersonInfoResp
- ProjectDTO
- UpdateProjectDTO
- controllers.PersonItem
- controllers.PersonListClickResp
- ResponseResultSourceSearchPageVo
- controllers.PersonResp
- SourceSearchObject
- WhiteBalanceAdjustDTO
- controllers.PersonTrackItem
- SourceSearchPageVo
- RgbDTO
- controllers.PersonTrackResp
- SourceSearchTag
- AddSourceObjectParam
- WhiteBalanceDTO
- controllers.PublicSearchItem
- controllers.PublicSearchResp
- ConnectDTO
- controllers.RecordedFileResp
- ResponseResultString
- controllers.RecordingInfoReturnData
- OutputProjectQueryDTO
- controllers.ReturnData
- ActiveOutput
- controllers.SceneChangeInfoItem
- OutputEncodingPairs
- controllers.SceneChangeInfoResp
- OutputProjectApiVo
- controllers.SearchCombtagsResp
- PageInfoOutputProjectApiVo
- controllers.SearchMediaByIdsResp
- StreamProfile
- ResponseResultPageInfoOutputProjectApiVo
- controllers.SearchObjectByMediaResp
- CreateProjectDTO
- SourceAttrPO
- SwitchConnectDTO
- controllers.SearchObjectTagsResp
- ResponseResultOutputProjectApiVo
- ResponseResultProjectRecord
- controllers.SearchPersonNameWithTagsResp
- controllers.SearchSummarizationResp
- controllers.SearchWordsResp
- SourceObjectListParam
- controllers.SettingsResp
- DestinationVO
- OrderItem
- controllers.SuggestionResp
- PageResultDestinationVO
- controllers.SupportLangItem
- ResultPageResultDestinationVO
- controllers.SupportLangResp
- ResultDestinationVO
- controllers.Tvu264StatusItem
- DestinationObjectEncodingProfileDTO
- controllers.Tvu264StatusResp
- controllers.UpdateActivityReq
- AudioOffsetDTO
- controllers.UpdateActivityResp
- controllers.UpdateClickCntResp
- controllers.UpdateClickReq
- controllers.WebPersonReturnData
- ResponseResultWhiteBalanceDetailVO
- controllers.WordsItem
- WhiteBalanceDetailVO
- controllers.WordsResp
- Scopes
- models.AccessPermission
- models.AccessPermissionV2
- Vector
- ScopeInfo
- models.AppearanceAffiliated
- models.AppearanceAffiliatedContent
- models.AppearanceContent
- StreamProfileParam
- models.AppearanceData
- models.AppearanceEvent
- BasePreviewDTO
- WhiteBalanceParentDTO
- models.AppearanceFilter
- ResultOutputDTO
- models.AppearanceListItem
- models.AppearanceListResponse
- models.AppearanceRelationItem
- models.AppearanceRelations
- models.AppearanceRelationsRequestV2
- models.AppearanceRelationsResponse
- models.AppearanceRelationsResult
- models.AppearanceSearchFilter
- models.AppearanceSearchRequest
- models.AppearanceSearchResponse
- models.AppearanceSearchResult
- models.AppearanceSuggestionRequestV2
- models.AppearanceSuggestionResponse
- models.AutoSearchReq
- models.CriteriasCondition
- models.EsCapfullReturnData
- models.EsCapfullReturnDataV3
- models.EsObjectTagData
- models.EsWordsData
- models.EventCondition
- models.EventObjectRecordingsResult
- models.FetchAllObjectTagReq
- models.FetchObjectTagReq
- models.GetIntervalItems
- models.GetObjectReq
- models.GpsInfo
- models.HintData
- models.HintRetureData
- models.HitSlug
- models.HostAppearance
- models.LocationInfo
- models.MatchCaptionRet
- models.MatchFaceRet
- models.MatchListRet
- models.MatchLogoRet
- models.MatchResult
- models.MatchSlugRet
- models.MediaFileRet
- models.MediaFileRetrunData
- models.MediaInfo
- models.MediaItem
- models.ObjectDetail
- models.ObjectQReq
- models.ObjectReturnData
- models.ObjectTagSuggestionReq
- models.PersonInfo
- models.PersonReturnData
- models.PersonTrackInfo
- models.PreViewMediaInfo
- models.PubSearchBaseReq
- models.PubSearchFilters
- models.PubSearchTsRange
- models.RecordingInfoQReq
- models.SceneChangeInfoData
- models.ScteMarkerInfoReq
- models.ScteMarkerInfoResult
- models.SearchAssetResult
- models.SearchBaseTagsReq
- models.SearchDurationRange
- models.SearchFileFormatByPathReq
- models.SearchFilters
- models.SearchLocation
- models.SearchMediaByIdsReq
- models.SearchMediaByIdsReturnData
- models.SearchMediaFileBySourceObjectId
- models.SearchObjectByUserId
- models.SearchObjectIdByMediaReq
- models.SearchPersonNameWithTagsReq
- models.SearchSummarizationRequest
- models.SearchTags
- models.SearchTsRange
- models.SortOptions
- models.SourceCondition
- models.SubStanceV2
- models.SummarizationItem
- models.SummarizationRequest
- models.TangibleAttributeData
- models.TermsItem
- models.TimestampRange
- models.Tvu264StatusData
- Schemas
Get a thumbnail image from a video
GET
https://api.tvunetworks.com/thumbnail
Offset (milliseconds fromthe beginning of the stream), uploads it to the TVU image server, and returns the
server-relative path. The caller prepends the image server's base URL to form the
full HTTP URL.
LivePath (an HLS playlist or MPD URL) or VodUrl(a direct video file URL). When both are present,
VodUrl takes precedence. Theservice locates the correct TS segment from the playlist index, downloads it, runs
ffmpeg to extract the frame, then uploads the JPEG.1099) if Offset falls outside the available recordingrange or if the source segment is corrupt.
Error Codes#
| Code | Message | Cause |
|---|---|---|
1000 | success | Thumbnail is available at ImagePath |
1018 | the request param abnormal. | LivePath is malformed or cannot be parsed |
1019 | init aws s3 sdk failed, please contact TVU Support. | S3 SDK initialization failed for the source bucket |
1024 | open or create file fail. | Failed to read the generated local thumbnail file |
1050 | (locate ts source failed) | Cannot find the TS segment at the requested Offset |
1077 | upload fail | Generated thumbnail failed to upload to the image server |
1086 | get source ts signature url fail. | Failed to generate a signed URL for the source TS file |
1099 | Media processing encountered an exception. Please retry... | Thumbnail generation (ffmpeg) failed; possibly invalid time offset |
Request
Query Params
Header Params
Responses
🟢200
application/json
Bodyapplication/json
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.tvunetworks.com/thumbnail?LivePath=https%3A%2F%2Fmma-video-new.s3.us-east-1.amazonaws.com%2Fts%2FPRODUCER_RECORDINGS%2Fsource-001%2Flive-001%2F1%2Fplay.m3u8&VodUrl=https%3A%2F%2Fmedia-export-bucket.s3.us-east-1.amazonaws.com%2Fexport%2Fclip_20231114_30s.mp4&Offset=15000' \
--header 'SID: 92575d36dcb631ac94745e6b157de17a5a13d65b31e44869f06854ab928dd80235d4daae8696b4a92a7be5f802c45a219648701fc9ca59f44e9c0f022d5d38a7'Response Response Example
success
{
"ErrorCode": 1000,
"ErrorMessage": "success",
"ImagePath": "/export/4B999DC458FBC4C80000000000000002/00_13_12.jpg",
"Resolution": "1920x1080"
}Modified at 2026-06-15 13:53:30