Intelligent Media Services:RegisterMediaInfo

The URL of the media asset to be registered in the corresponding system. Once registered, this URL cannot be changed and is attached to the IMS mediaId.

• OSS URL. Two formats are supported:

http(s)://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4

oss://example-bucket/example.mp4 (This format assumes by default that the OSS region is the same as the service registration area.)

• VOD media asset:

vod://***20b48fb04483915d4f2cd8ac****

The media type of the media asset. Valid values:

• image

• video

• audio

• text

When the value is "text", the businessType must be set to "subtitles" or "font".

Specify this field as needed. When the InputURL field is an OSS URL, the media type can also be automatically determined based on the file name extension (only for image, video, and audio file extensions). For the mapping between file extensions and media types, see File formats.

The business type of the media asset. Valid values:

• subtitles

• font

• watermark

• opening

• ending

• general

The title. If not provided, a default title is automatically generated based on the date.

• Maximum length: 128 bytes.

• UTF-8 encoded.

The content description.

• Maximum length: 1024 bytes.

• UTF-8 encoded.

The tags.

• Maximum number of tags: 16.

• Separate multiple tags with commas.

• Maximum length of a single tag: 32 bytes.

• UTF-8 encoded.

The cover image URL.

• Maximum length: 128 bytes.

• UTF-8 encoded.

The user data. Custom callback URL configuration is supported. For configuration instructions, see Configure a callback upon editing completion.

• Maximum length: 1024 bytes.

• UTF-8 encoded.

• Json format.

Specifies whether to overwrite an existing registered media asset. Default value: false.

• true: If the inputUrl is already registered, the existing media asset is deleted and a new media asset is registered.

• false: If the inputUrl is already registered, the new media asset is not registered. Duplicate inputUrl values are not supported.

The client token. A 32-character UUID that ensures the idempotence of the request.

The registration configuration.

By default, a sprite image is generated for the media asset. To disable this, set the NeedSprite field to false.

By default, a snapshot is generated. To disable this, set the NeedSnapshot field to false.

To specify the time for the cover image, configure CoverConfig, which contains the following field:

• StartTime: The time in seconds at which the cover image is captured from the media asset. Up to four decimal places are supported.

After media asset registration, to import the media asset into a custom search library, configure SearchLibName. For information about how to create and use a custom search library, see Use a custom search library.

The category ID.

The workflow ID.

The custom ID. Only lowercase letters, uppercase letters, digits, hyphens (-), and underscores (_) are supported. The length must be 6 to 64 characters. The ID must be unique for each user.

The intelligent tagging template. Valid values:

• S00000101-300080: A system template that includes NLP content understanding.

• S00000103-000001: A system template that includes NLP content understanding and all tagging capabilities.

• S00000103-000002: A system template that includes all tagging capabilities but does not include NLP content understanding.

For more information about tagging capabilities, see the documentation.

After this field is configured, an intelligent tagging analysis task is automatically initiated upon media asset registration. For billing information, see Billing of Smart Tag Standard Edition.