Musik zu TikTok-Beiträgen über die API hinzufügen
Die API for Business von TikTok fügt Musik aus der Commercial Music Library hinzu: post_info.music_sound_info nimmt bei Video- und Fotobeiträgen die music_sound_id eines Tracks entgegen, bei Videos außerdem Lautstärke, Start und Ende des Tracks in Millisekunden sowie die Lautstärke des eigenen Tons des Videos. Fotobeiträge können zusätzlich auto_add_music für empfohlene Musik verwenden. Track-IDs stammen von GET /discovery/cml/trending_list/.
easyCoexistence veröffentlicht TikTok-Videos und Fotobeiträge mit publish_tiktok_post aus Claude, ChatGPT oder Ihrem eigenen Code, sofort oder zu einem festen Zeitpunkt bis zu 90 Tage im Voraus.
Die beliebtesten Tracks, die /discovery/cml/trending_list/ zurückgibt, alle vorab für organische Inhalte und Werbeanzeigen freigegeben.
Wertebereich von music_sound_volume und video_original_sound_volume; über die API stehen beide standardmäßig auf 0, während die TikTok-App bei 50 beginnt.
Songs in der Commercial Music Library von TikTok, der global vorab freigegebenen Bibliothek, die Unternehmen für kommerzielle Aktivitäten auf TikTok nutzen.
Wo Kreationen mit Musik aus der Musikliste für TikTok-Werbeanzeigen ausgespielt werden dürfen, sofern die Rechteinhaber keine gesonderte Erlaubnis erteilen.
Die einzige post_mode, in der der Fotoendpunkt der Content Posting API auto_add_music anwendet, auf developers.tiktok.com.
Welche Musikfelder nehmen die Veröffentlichungs-Endpoints von TikTok entgegen?
Beide Endpoints übergeben Musik unter post_info im Feld music_sound_info und benennen einen Track über seine ID aus der Commercial Music Library. Darüber hinaus unterscheiden sie sich: Der Video-Endpoint bietet Mischregler, der Foto-Endpoint einen Schalter, mit dem TikTok die Musik auswählen kann. Nebeneinander, so wie TikTok sie in seinen Referenzen auflistet:
| Video post | Photo post | |
|---|---|---|
| The track | music_sound_info.music_sound_id | music_sound_info.music_sound_id |
| Track volume | music_sound_volume, 0 to 100, required with a track | No field |
| Part of the track | music_sound_start and music_sound_end, in milliseconds | No field |
| The video's own sound | video_original_sound_volume, 0 to 100 | Not applicable |
| Recommended music | No field | auto_add_music, false by default |
| As a draft | upload_to_draft drops the rest of post_info | is_draft keeps only the title and caption |
Wie fügt man einem Video einen Track hinzu?
Senden Sie music_sound_info innerhalb von post_info an POST /business/video/publish/. Sobald das Objekt vorhanden ist, sind music_sound_id und music_sound_volume Pflichtfelder. music_sound_start und music_sound_end wählen den Abschnitt des Tracks in Millisekunden aus. Standardmäßig reicht er vom Anfang des Tracks bis zur vollen Länge des Videos, sodass ein 2-Sekunden-Video die ersten 2.000 Millisekunden des Tracks nutzt. Setzen Sie außerdem video_original_sound_volume, wann immer der eigene Ton des Videos wichtig ist, denn der Wert ist standardmäßig 0:
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/video/publish/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"business_id": "<OPEN_ID>",
"video_url": "https://media.example.com/tiktok/launch.mp4",
"post_info": {
"caption": "Our new blend is here #coffee",
"is_brand_organic": false,
"is_branded_content": false,
"music_sound_info": {
"music_sound_id": "<SONG_CLIP_ID>",
"music_sound_volume": 40,
"music_sound_start": 15000,
"music_sound_end": 30000,
"video_original_sound_volume": 80
}
}
}'Woher kommen die Track-IDs?
Von GET /discovery/cml/trending_list/, einem Endpoint der Discovery API, der das Access-Token und die business_id eines TikTok-Kontos entgegennimmt. Die Hashtag-Endpoints der Discovery nehmen dagegen die eines Werbetreibenden entgegen. TikTok führt diesen Endpoint in seiner Referenz unter der Discovery-Berechtigung von Creative Management. Er liefert bis zu 100 beliebte Tracks, jeweils mit Name, Künstler, Dauer, Rang, Genres, einer preview_url, die nicht abläuft, und bis zu 30 Tagen trending_history. full_duration_song_clip und trending_song_clip enthalten jeweils eine song_clip_id, also den Wert, den TikTok als music_sound_id bezeichnet:
- genre: standardmäßig ALL, oder einer von über 100 Werten wie POP, LATIN, LO-FI oder SERTANEJO.
country_code: standardmäßig US.date_range: 1DAY, 7DAY standardmäßig, 30DAY oder 90DAY.- /discovery/cml/
video_list/: die 20 aktuell angesagtesten Videos, die einen Track verwenden, nach seinercommercial_music_idund einemcountry_code.
curl -G 'https://business-api.tiktok.com/open_api/v1.3/discovery/cml/trending_list/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'genre=POP' \
--data-urlencode 'country_code=BR' \
--data-urlencode 'date_range=7DAY'Wie bekommen Fotobeiträge Musik?
Auf zwei Wegen über POST /business/photo/publish/. Setzt man auto_add_music auf true, fügt TikTok empfohlene Musik hinzu, die der Inhaber später in der TikTok-App ändern kann. music_sound_info.music_sound_id benennt einen bestimmten Track aus der Bibliothek. Bei Fotos gibt es keine Felder für Lautstärke, Start oder Ende. Auf developers.tiktok.com hat der Foto-Endpoint der Content Posting API ein eigenes auto_add_music, das nur angewendet wird, wenn post_mode DIRECT_POST ist. Dessen Direct-Post-Video-Endpoint dokumentiert kein Musikfeld.
Was bedeutet die Commercial Music Library für Geschäftskonten?
Es handelt sich um die Musik, die Unternehmen verwenden dürfen. Das Business Help Center von TikTok beschreibt die Bibliothek als vorab freigegebene globale Sammlung von 1 Million Songs. Es erklärt, dass Unternehmen die allgemeine Musikbibliothek nicht für kommerzielle Zwecke nutzen können, und verweist für organische Inhalte, einschließlich Duette, Reacts und Stitches, sowie für Videoanzeigen und Branded Content auf die Commercial Music Library. Bei einem Business-Konto zeigt Sound hinzufügen in der App nur Sounds aus der Bibliothek, und die API zieht dieselbe Grenze, da music_sound_id eine Bibliotheks-ID entgegennimmt.
Was kann die API bei Musik nicht?
Einige Dinge liegen außerhalb ihrer Felder, wie TikTok sie in seinen Referenzen beschreibt:
- Einen Sound aus der allgemeinen Musikbibliothek von TikTok benennen:
music_sound_idnimmt eine ID der Commercial Music Library entgegen. - Die Bibliothek nach Titel durchsuchen: /discovery/cml/
trending_list/ filtert beliebte Tracks nach Genre, Land und Zeitraum. - Musik für einen Entwurf behalten:
upload_to_draftlässt TikTok den restlichenpost_infoignorieren, undis_draftbehält nur Titel und Caption. - Einen eigenen Track in einem organischen Beitrag verwenden: /file/music/upload/ fügt Musik für Werbekreationen unter einer
advertiser_idhinzu, und TikTok weist dort die Verantwortung für das Urheberrecht dem Hochladenden zu.
Welche Umgehungslösungen gibt es?
Drei, die jeweils auf dem beruhen, was TikTok in seinen Referenzen dokumentiert, dazu ein Risiko, das Sie abwägen sollten:
- Die Musik in die Datei mischen. Die Vorgaben von TikTok beschreiben das Video als Audio-Video-Inhalt, sodass eine eingemischte Tonspur mit ihm ausgeliefert wird. Verwenden Sie Audio, an dem Sie die Rechte besitzen.
- Einen Entwurf senden. Mit
upload_to_draftoderis_draftund dem Scope video.upload landet der Beitrag im TikTok-Posteingang des Creators, wo er in der App bearbeitet und veröffentlicht werden kann. - Bei Fotobeiträgen TikTok wählen lassen.
auto_add_musicfügt empfohlene Musik hinzu, die der Inhaber später in der TikTok-App austauschen kann. - Das Risiko bei gemischtem Audio: Die Liste der Beiträge in der TikTok-Referenz nennt Verstöße gegen Musikurheberrechte unter den wahrscheinlichen Gründen, aus denen ein Beitrag gefiltert wird.
Wie sieht man, ob ein Sound Aufrufe gebracht hat?
Über impression_sources, ein Feld von /business/video/list/, das einordnet, wo die Zuschauer eines Beitrags ihn gefunden haben. Einer seiner Werte ist Sound, für Aufrufe, die von Sound-Seiten kamen. Es benötigt den Scope video.insights und trifft wie die anderen Zahlen 24 bis 48 Stunden verspätet ein. Über easyCoexistence liefert get_social_insights es für einen der 20 neuesten Beiträge des Kontos, wenn impression_sources in metrics angegeben wird, mit der item_id des Beitrags als object_id.
Was macht easyCoexistence mit Musik?
easyCoexistence veröffentlicht den Sound, der bereits in Ihrer Datei steckt. publish_tiktok_post, sofort oder mit scheduled_at, sendet die Caption, den Titel eines Fotobeitrags und die Kommentareinstellung, ohne music_sound_info und ohne auto_add_music. So behält ein Video seine eigene Tonspur, und ein Fotobeitrag wird ohne Musik veröffentlicht. Ihr eigener Code kann mit music_sound_info und dem Token aus get_social_credentials per POST an business/video/publish/ senden. Dieser Body geht jedoch so an TikTok, wie er ist, einschließlich video_url, und TikTok ruft Medien nur von Domains oder URL-Präfixen ab, die für die App verifiziert sind. Pfade unter /discovery/ nehmen das Token eines Werbetreibenden, sodass die Track-Liste außerhalb der Reichweite des Konto-Tokens liegt.
Häufige Fehler
- video_original_sound_volume beim Hinzufügen eines Tracks weglassen. Über die API steht der Wert standardmäßig auf 0, während die TikTok-App beide Töne bei 50 beginnen lässt. Setzen Sie ihn daher, wann immer der eigene Ton des Videos wichtig ist.
- Den Namen oder die preview_url eines Tracks als music_sound_id übergeben. Die Track-Referenz von TikTok nennt die song_clip_id aus full_duration_song_clip oder trending_song_clip als den zu übergebenden Wert.
- /discovery/cml/trending_list/ mit einem Advertiser-Token aufrufen. Die Track-Endpoints nehmen das Token eines TikTok-Kontos und die business_id entgegen, so wie die Accounts API.
- Eine Dauer von 0 als defekten Track lesen. TikTok weist darauf hin, dass ein Track, der nur ein Ausschnitt eines längeren Stücks ist, 0 anzeigen kann. Prüfen Sie deshalb die Vorschau, bevor Sie Start und Ende wählen.
Ein Video wird mit der in seine Datei gemischten Tonspur veröffentlicht. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit 3 Tagen kostenloser Testphase.
Häufig gestellte Fragen
Kann ich über die API jeden Song zu einem TikTok-Beitrag hinzufügen?
Songs aus der Commercial Music Library, per ID. Musik, die bereits in eine Videodatei gemischt ist, geht mit der Datei hinaus. Es sollte daher Musik sein, zu deren Nutzung Sie die Rechte besitzen.
Welche Lautstärke setzt die TikTok-API für hinzugefügte Musik?
Standardmäßig 0. music_sound_volume und video_original_sound_volume reichen von 0 bis 100, und beide stehen über die API standardmäßig auf 0, während die TikTok-App bei 50 beginnt. Setzen Sie sie daher bei jedem Video mit Track.
Spielt die Musik eines Beitrags eine Rolle, wenn er später in einer Anzeige verwendet wird?
TikTok prüft es: /identity/music/authorization/ meldet für die Standorte und Laufzeiten der Anzeige, ob die Musik des Beitrags vollständig autorisiert ist, eine Autorisierung fehlt oder keine Song-ID vorhanden ist.
Wie viele Songs gibt es in der Commercial Music Library von TikTok?
1 Million laut dem Business Help Center von TikTok, alle vorab für kommerzielle Nutzung freigegeben. /discovery/cml/trending_list/ liefert jeweils bis zu 100 beliebte davon.
Weiterlesen
Verbinden Sie Ihren ersten Kanal in zwei Minuten.
Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.
- 3 Tage kostenlos
- Jederzeit kündbar
- Nur offizielle APIs
- Überwacht rund um die Uhr (24/7)
Verifiziert am