Docs
Media Asset Management
The mini drama media asset library and player capabilities are used to help you complete mini drama content hosting, moderation, listing, and playback. You can use BytePlus to host episode videos, manage media asset content through TikTok's developer platform, and integrate the mini drama player within the mini app to play moderated and listed episodes.
Integration process
Developers need to complete two parts of integration:
Module | Description |
Media Asset Library Access | Complete the preparation of the BytePlus account, binding to TikTok's developer platform, as well as the upload, moderation, and listing of dramas/episodes. |
Mini Drama Player Integration | Integrate the specified BytePlus player within the mini app and connect to the platform's play control logic. |
Instructions
Media Asset Library Access
BytePlus provides video hosting solutions for mini dramas, including video storage, hosting, and playback capabilities. After BytePlus video management is integrated with the mini drama media asset library on the TikTok devleoper platform side, you can reduce the costs of duplicate uploads and duplicate moderation:
- Videos stored on BytePlus can be directly submitted for moderation without the need for repeated uploads.
- Mini drama videos uploaded via the TikTok open API swill be automatically synchronized to BytePlus.
- The moderation status, launch status, and playback status of the drama series on TikTok will be synchronized and participate in playback control.
Regarding video playback, developers need to integrate the specified player capabilities on the mini drama mini app side and pass in the drama ID and episode ID. The platform will perform playback control based on the moderation status, launch status, and account binding relationship to ensure that content that has not passed moderation or has not been launched cannot be played.
Prepare your BytePlus account
BytePlus is a platform that offers AI products and cloud services for enterprises. This section explains how to set up a BytePlus account and bind it to your mini drama app on the Developer Portal.
Byteplus Video on Demand (VoD) pre-registration and activation
After launching your mini drama business on the Developer Portal, you should complete the cooperation contract signing and account registration on BytePlus platform as soon as possible. This process is expected to take 1 week. This facilitates the submission and moderation of drama content during subsequent integration, and helps avoid affecting the progress of subsequent development and launch. To support developers in better operating on the platform, preferential pricing plans are also offered for developers engaged in the mind dramas business.
Category | Charging method | Advertising rate | Preferential cooperative price |
Content Storage | Storage x Duration Billing | 0.017 USD/GiB/Month | 50% discount, 0.0085 USD/GiB/Month |
Traffic fees | Graduated Pricing | Regional gradient pricing or global traffic flat rate | ≤ 2.5PB, about 1.6 discount; > 2.5PB, about 1.4 discount
|
Player | Pay annually | Standard Edition: Free Advanced Edition: 8300 USD/year | Give away the premium player |
To contact BytePlus, please submit this communications form. For more information about Byteplus VOD, please refer to the BytePlus website.
Byteplus account configuration and usage
Configuration item | Description |
BytePlus account | is used to host, store, and play mini drama videos |
| BytePlus Account ID, to be used in subsequent bindings on the Developer Portal and Open API requests |
| The access key ID (AK) corresponding to your BytePlus account |
| The secret access key (SK) corresponding to your BytePlus account |
Video storage space | Used to store mini drama episode videos. All episodes under a single drama must belong to the same BytePlus account. |
Play domain configuration | If the playback link requires domain name binding, certificate, or CNAME configuration, please first complete the corresponding configuration on the BytePlus side. |
Precautions:
AccessKeyIDandSecretAccessKeyare used for TikTok Open Platform to call BytePlus capabilities. Please keep them properly to avoid leakage.- If AK/SK expires or changes later, you need to re-verify your account on the TikTok Open Platform; otherwise, it may affect moderation, listing, and playback.
- Developers can either upload episode videos to BytePlus on their own or have the platform transfer and store videos to BytePlus via the Open API provided by the TikTok Open Platform.
Bind your BytePlus account, then use open APIs to complete the upload, moderation, and listing of media content
Activate media asset management capability
Go to your app page on the Developer Portal:
- Navigate to the Industry solutions page from the sidebar of your app page.
- Find the Media asset management module and click the Activate button.
- Note that mini drama video storage and hosting services will be provided and charged by BytePlus, an independent cloud services platform separate from TikTok. Click Connect to proceed.
Locate BytePlus account credentials
Binding requires the following information from the BytePlus account: Account ID, AccessKeyID and SecretAccessKey.
To find your account credentials on BytePlus, do the following:
- Account ID: Log in to your BytePlus account, then locate your Account ID in the profile information panel.
AccessKeyIDandSecretAccessKey:
- Log in to your BytePlus account, then go to the profile information panel and enter the IAM page.
- On the User page, click on the username to enter the User detail page.
- On the User detail page, you can find the Access Key ID and Secret Access Key. You can also create new access keys.
During binding, the TikTok's developer platform will verify whether the AK/SK matches your BytePlus account. After verification passes, the account will appear in the list of bound accounts.
For the sake of developer information security, after successful binding, the developer platform will no longer display AccessKeyID and SecretAccessKey in plain text, but only display desensitized key information.
Bind BytePlus account to mini drama app
Next, you'll need to bind your BytePlus account to your mini drama app:
- Go to the Industry solutions tab of your app page.
- Click the Manage accounts button in the Media asset management card.
- Click the Connect BytePlus account button on the media asset management page.
- Enter your BytePlus account's information then click Connect:
- Account ID
- AccessKeyID
- SecretAccessKey
Important: TikTok stores your AccessKeyID and SecretAccessKey securely. You won't see them in plain text after setup.
If verification is successful, your account will appear in the list of bound accounts. Make sure that the account displays as Connected.
If you need to update the key, click Edit AK&SK to re-verify.
Complete the upload, moderation, and listing of mini drama media asset content via openAPI
Note: All video-related operations (including subsequent playback in mini apps) require your AccessKeyID and SecretAccessKey from the BytePlus account binding. If this information is changes, please update it promptly on the Developer Portal; otherwise, all open API calls related to videos will become invalid, and videos will not play properly in mini apps.
- All operations (upload, moderation, and listing) must be completed via open APIs, please refer to:
- Media asset submission format requirements for moderation:
- Video format
- Subtitle format
- Explanation of media asset moderation timelines
- For more information regarding media asset moderation categories, please refer to the TikTok Community Guidelines.
Type | Supported formats | Size limit |
Video | MP4, FLV, ASF (WMV), RM, RMVB, MPEG, MOV, AVI, FLASH, MPEG-TS (MTS), M4S, M3U8, MKV | Single file must not exceed 20 GB |
Audio | MP3, M4A, WAV, WMA, AMR, AAC, OGG | Single file must not exceed 20 GB |
Typ | Supported formats |
Single language, English only | English videos can be uploaded directly, and optional cheating software subtitle packages can be uploaded |
Multilingual | Video and corresponding cheating software subtitle package, with subtitles supporting four file formats: VVT, SRT, ASS, and TTML, among which subtitles must include English. |
Category | Description | Moderation timelines |
Normal | We recommend uploading non-pending mini dramas to make 500-1000 mini dramas available for online viewing on TikTok Minis | 2 weeks |
Urgent | We recommend uploading in-progress shows (new shows launching for the first time and existing shows with recent consumption), with each organization limited to uploading 35 shows per day | 1-3 working days |
Primary category | Secondary classification | Platform-specific moderation standards and prohibited content explanation |
Safety and Civility | Violence and Crime | We prohibit threatening, encouraging, or glorifying violence, promoting criminal activities, or instructing others to engage in harmful behavior. |
Hatred and Discrimination | We prohibit posting hate speech or engaging in behavior that attacks others based on protected attributes such as race, religion, gender, sexual orientation, and more. | |
Violent/Hate Organization | We prohibit terrorists, extremists, and criminal organizations from being present on the platform, and we prohibit recruiting for or promoting them. | |
Harassment and Bullying | We prohibit remarks that demean appearance, doxxing, sexual harassment, or organized bullying. We allow reasonable criticism of political figures, but we prohibit remarks that cause serious harm. | |
Abuse and Exploitation | We strictly prohibit any content that displays or promotes the sexual exploitation of adolescents or adults, or smuggling. | |
Mental and Behavioral Health | Suicide and Self-Harm | We prohibit displaying, glamorizing, promoting, or providing content related to suicide, self-harm, or other dangerous self-injurious behavior. |
Disordered Eating, Risky Weight Management, and Body Image | We prohibit promoting eating disorders, dangerous weight loss or weight gain methods, or sensationalizing harmful body-related behavior. | |
Dangerous Activity and Challenges | We prohibit displaying or encouraging dangerous and risky behaviors, harmful online challenges, or activities that may cause injury. | |
Sensitive and Mature Themes | Body Exposure and Sexualized Behaviors | We prohibit nudity, real or simulated sexual activity, the promotion of sexual services, and strongly suggestive sexual content. |
Shocking and Graphic Content | We prohibit posting extremely bloody, violent, cruel, or severely disturbing physiological or emotional content. | |
Animal Abuse | We prohibit displaying or promoting content involving the mutilation, neglect, abuse, or killing of animals. | |
Integrity and Authenticity | Misinformation and Election Integrity | We strictly prohibit publishing rumors that may cause significant harm to individuals or society, as well as false or misleading information. |
AI Generated Content (AIGC) | We require clear labeling when AI or editing techniques are used to create realistic depictions of characters or scenes. The use of AIGC to mislead the public or harm individuals is strictly prohibited. | |
Intellectual Property and Originality | We prohibit reproduction and plagiarism, including publishing non-original material without proper rights or authorization. | |
Deceptive Behavior & Fake Engagement | We prohibit artificially generating fake traffic, such as buying likes, followers, views, or other forms of engagement through third-party services or means, or attempts to deceive the recommendation algorithm system. | |
Regulated Goods, Services, and Commercial Activities | Controlled and Prohibited Items | We prohibit illegal marketing or trading of prohibited or high-risk items such as drugs, weapons, and counterfeit goods. Note: Qualified allowlisted merchants/enterprise accounts may sell certain specific controlled products under strict control. |
Commercial Disclosure and Paid Marketing | When promoting a brand, product, or business, TikTok's official "Content Disclosure Settings" must be used to indicate that it is commercial or ponsored Content, and all brand content must also comply with TikTok's "Brand Content Policy", "Advertising Creative Policy", and "Industry Access Policy". | |
Frauds and Scams | We prohibit content that harms users’ economic interests, including scams, fraud, and misleading financial schemes. | |
Privacy and Security | Personal Information | We prohibit sharing other people’s private data, such as identity information, addresses, or financial data, in ways that may cause harm. |
Platform Security | We prohibit any attempt to hack, crack, reverse engineer, or otherwise endanger the TikTok system or its underlying architecture. |
Mini Drama Player Integration
Your app is required to play reviewed mini drama episodes using the official TikTok Minis player (VePlayer) to protect copyright safety and provide a consistent playback experience. This player is tailored to the mini dramas industry and contains a playback control page.
Core features
The core capabilities of the player include but are not limited to the following. For more information about the player, refer to the BytePlus VOD Player SDK doc.
Function | Description |
Broadcast control | The player provides refined playback control functions.
|
Audio and video control |
|
Access method
When playing an episode, developers should initiate playback based on album_id and episode_id, and should not directly use the original video address to bypass the platform's playback control.
Follow the recommended process:
- Users select the episode to play within the mini app.
- Mini app obtains the corresponding
album_idandepisode_id. - Call the BytePlus player to initiate playback.
- The platform verifies the play's ownership, moderation status, listing status, and account binding status.
- Play after verification passes; when verification fails, display a non-playable prompt.
Playback rules
Playback is jointly determined by the moderation status and the launch status.
Scene | Play results |
The drama version has not been submitted for moderation | Unplayable |
Drama version is under moderation | Unplayable |
Any mini drama shell element or any mini drama fails moderation | All episodes in this version are unavailable for playback |
The drama version has passed moderation but has not been launched | Unplayable |
The drama version has passed moderation and is now live | Can be played via the BytePlus player |
The show has been taken off the shelves | Unplayable |
The bound BytePlus account has been deleted or is invalid | Related shows may not be playable and need to be re-verified and re-launched |
Handling playback failures
Failure scenario | Developer handling method |
The drama has not passed moderation or has not been launched | Confirm that the target version has passed moderation and been successfully launched. |
A certain episode failed moderation | Resubmit for moderation after correcting the non-compliant content; other episodes under this version are also unavailable for playback. |
BytePlus account expired or unbound | Rebind or verify the BytePlus account, and relaunch the drama version. |
Video resource is unavailable | Check the video ID, account binding relationship, and resource status on the BytePlus side. |
The player has not been connected as required | After the player is connected, re-verify the playback link. |
Compatibility of existing apps
For existing mini drama apps that have already been launched, the platform provides a transitional compatibility plan. The scope of compatibility, validity period, and supplementary requirements shall be subject to the platform's notice. Newly added mini dramas shall directly integrate with BytePlus player capabilities.
Frequently Asked Questions
Why is the Activate button not clickable?
The qualification for accessing the mini drama industry has not been approved yet. Please first complete the application for industry qualification, and after approval, return to Industry solutions to activate the media asset management capability.
Can a drama use multiple BytePlus accounts, or videos from different spaces under the same BytePlus account?
No, it is not allowed. A drama can only be bound to the same space of the same BytePlus account, and all episode videos under this drama must belong to this space.
Can a BytePlus account be used by multiple apps?
Yes. TikTok's developer platform apps and BytePlus accounts support many-to-many binding.
Can a drama version that has passed moderation but not been listed be played?
No. Moderation approval only indicates that the version is eligible for listing, while playback also requires that the version has been listed.
If a particular episode fails moderation, can other episodes that have passed moderation be played?
No. As long as any drama shell element or any episode within a drama version fails moderation, all episodes under that version cannot be played.
Can a self-developed player be used?
Playing mini drama mini apps requires using the specified BytePlus player access method to ensure that the platform's playback control logic can take effect.
What should I do if the BytePlus AK/SK expires?
Needs to be updated and re-verified on the developer platformAccessKeyID and SecretAccessKey.