TikTok for Developers

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:

  1. Videos stored on BytePlus can be directly submitted for moderation without the need for repeated uploads.
  2. Mini drama videos uploaded via the TikTok open API swill be automatically synchronized to BytePlus.
  3. 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

  • 0 - 500 TB,0.01 USD/GB
  • 500 TB - 2.5 PB,0.0075 USD/GB
  • Greater than 2.5PB, 0.0065 USD/GB

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

BytePlus Account ID, to be used in subsequent bindings on the Developer Portal and Open API requests

AccessKeyID

The access key ID (AK) corresponding to your BytePlus account

SecretAccessKey

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:

  • AccessKeyID and SecretAccessKey are 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:

  1. Navigate to the Industry solutions page from the sidebar of your app page.
  2. Find the Media asset management module and click the Activate button.
  3. 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:

  1. Account ID: Log in to your BytePlus account, then locate your Account ID in the profile information panel.
  1. AccessKeyID and SecretAccessKey:
  • 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:

  1. Go to the Industry solutions tab of your app page.
  2. Click the Manage accounts button in the Media asset management card.
  3. Click the Connect BytePlus account button on the media asset management page.
  4. Enter your BytePlus account's information then click Connect:
    1. Account ID
    2. AccessKeyID
    3. 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
    • 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

    • Subtitle format
    • 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.

  • Explanation of media asset moderation timelines
  • 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

  • For more information regarding media asset moderation categories, please refer to the TikTok Community Guidelines.
  • 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.

  • Basic playback controls: Supports a series of basic operations such as play, pause, and resume playback
  • Precise seek (seek): Allows users to jump to any position in the video by dragging the progress bar
  • Buffered jump: When jumping, the buffered video content will not be cleared, thus enabling a fast and smooth dragging experience
  • Replay and resume playback: Supports manually triggering replay after video playback ends, and can also record the user's playback progress to resume playing from the last watched position
  • Speed playback: Supports multiple speed playback (such as 0.5x, 1.5x, 2x)
  • Seamless clarity switching: When a video contains multiple levels of clarity, it allows users to switch smoothly without lag or interruption
  • Soundtrack switching: Supports switching between multiple M4A soundtracks

Audio and video control

  • Volume adjustment and mute: Supports adjusting video volume
  • Audio-only playback: For DASH video files or common audio files such as MP3 and AAC, supports playing only audio
  • Fill mode: Supports cropping or filling video frames to adapt to different display ratios
  • Picture rotation and mirroring: Supports rotation at four angles of 0°, 90°, 180°, 270°, as well as horizontal or vertical mirroring

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:

  1. Users select the episode to play within the mini app.
  2. Mini app obtains the corresponding album_id and episode_id.
  3. Call the BytePlus player to initiate playback.
  4. The platform verifies the play's ownership, moderation status, listing status, and account binding status.
  5. 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.

Was this document helpful?
TikTok for Developers