Kirjaudu sisäänAloita ilmainen kokeilu
easyCoexistence Viralliset API:t

Musiikin lisääminen TikTok-julkaisuihin rajapinnan kautta

TikTokin Business API lisää musiikkia Commercial Music Library -kirjastosta: post_info.music_sound_info ottaa kappaleen music_sound_id:n sekä video- että kuvajulkaisuissa, ja videoissa myös kappaleen äänenvoimakkuuden, alun ja lopun millisekunteina sekä videon oman äänen voimakkuuden. Kuvajulkaisut voivat lisäksi käyttää auto_add_music-asetusta suositeltuun musiikkiin. Kappaleiden ID:t saadaan osoitteesta GET /discovery/cml/trending_list/.

easyCoexistence julkaisee TikTok-videoita ja kuvajulkaisuja publish_tiktok_post-työkalulla Claudesta, ChatGPT:stä tai omasta koodistasi, heti tai määrättyyn aikaan enintään 90 päivää etukäteen.

100

Suosituimmat kappaleet, joita /discovery/cml/trending_list/ palauttaa; kaikki on esihyväksytty orgaaniseen sisältöön ja mainosten luontiin.

0 to 100

Arvoalue: music_sound_volume ja video_original_sound_volume; rajapinnan kautta molemmat ovat oletuksena 0, TikTok-sovelluksessa arvosta 50.

1 million

Kappaleita TikTokin Commercial Music Libraryssä, esihyväksytystä maailmanlaajuisesta kirjastosta, jota yritykset käyttävät kaupalliseen toimintaan TikTokissa.

TikTok only

Sijainnit, joissa TikTokin mainosmusiikkilistan musiikilla tehtyjä luovia voidaan näyttää, ellei oikeudenhaltijat anna erillistä lupaa.

DIRECT_POST

Ainoa post_mode, jossa Content Posting API:n kuvapäätepiste käyttää auto_add_music-asetusta developers.tiktok.com-sivustolla.

Mitä musiikkikenttiä TikTokin julkaisupäätepisteet ottavat?

Molemmat päätepisteet kuljettavat musiikin post_info-kentän sisällä, kohdassa music_sound_info, ja nimeävät kappaleen Commercial Music Library -tunnuksella. Muuten ne eroavat: videopäätepiste lisää sekoitussäädöt ja kuvapäätepiste kytkimen, jolla TikTok voi valita musiikin. Vierekkäin, niin kuin TikTokin viitteet ne listaavat:

Video postPhoto post
The trackmusic_sound_info.music_sound_idmusic_sound_info.music_sound_id
Track volumemusic_sound_volume, 0 to 100, required with a trackNo field
Part of the trackmusic_sound_start and music_sound_end, in millisecondsNo field
The video's own soundvideo_original_sound_volume, 0 to 100Not applicable
Recommended musicNo fieldauto_add_music, false by default
As a draftupload_to_draft drops the rest of post_infois_draft keeps only the title and caption

Miten kappale lisätään videoon?

Lähetä music_sound_info post_info-kentän sisällä päätepisteeseen POST /business/video/publish/. Kun objekti on paikallaan, music_sound_id ja music_sound_volume ovat pakollisia. music_sound_start ja music_sound_end valitsevat kappaleen osan millisekunteina. Oletuksena kappale alkaa alusta ja kestää videon koko pituuden, joten 2 sekunnin video ottaa kappaleen ensimmäiset 2 000 millisekuntia. Aseta myös video_original_sound_volume aina, kun videon oma ääni on tärkeä, sillä sen oletus on 0:

A 15-second video with seconds 15 to 30 of a library track
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
      }
    }
  }'

Mistä kappale-ID:t tulevat?

Päätepisteestä GET /discovery/cml/trending_list/, joka on Discovery API:n päätepiste ja ottaa TikTok-tilin access tokenin sekä business_id:n, kun Discovery-hashtag-päätepisteet ottavat mainostajan vastaavat. TikTokin viite luokittelee sen Creative Managementin Discovery-oikeuden alle. Se palauttaa enintään 100 suosittua kappaletta, joista jokainen sisältää nimen, esittäjän, keston, sijoituksen, genret, preview_url-osoitteen, joka ei vanhene, ja enintään 30 päivän trending_history-tiedot. full_duration_song_clip ja trending_song_clip sisältävät kumpikin song_clip_id:n, jonka TikTok nimeää music_sound_id:ksi:

  • genre: oletuksena ALL, tai yksi yli sadasta arvosta, kuten POP, LATIN, LO-FI tai SERTANEJO.
  • country_code: oletuksena US. date_range: 1DAY, oletuksena 7DAY, 30DAY tai 90DAY.
  • /discovery/cml/video_list/: kappaleen käyttävien 20 suosituinta trendivideota kappaleen commercial_music_id:n ja country_code-arvon perusteella.
Popular pop tracks in Brazil over the last 7 days
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'

Miten kuvajulkaisut saavat musiikkia?

Kahdella tavalla POST /business/photo/publish/ -päätepisteessä. auto_add_music asetettuna arvoon true saa TikTokin lisäämään suositeltua musiikkia, jonka omistaja voi vaihtaa myöhemmin TikTok-sovelluksessa. music_sound_info.music_sound_id nimeää tietyn kirjastokappaleen, eikä kuvilla ole äänenvoimakkuus-, alku- tai loppukenttiä. developers.tiktok.com-sivustolla Content Posting API:n kuvapäätepisteessä on oma auto_add_music, jota sovelletaan vain, kun post_mode on DIRECT_POST, ja sen suoran julkaisun videopäätepisteessä ei ole dokumentoitua musiikkikenttää.

Mitä Commercial Music Library merkitsee yritystileille?

Se on musiikki, jota ne saavat käyttää. TikTokin Business Help Center kuvaa kirjaston esihyväksytyksi maailmanlaajuiseksi kokoelmaksi, jossa on 1 miljoona kappaletta. Sen mukaan yritykset eivät voi käyttää yleistä musiikkikirjastoa kaupallisessa käytössä, ja ohjeen mukaan ne ohjataan Commercial Music Libraryyn orgaanisen sisällön, duettojen, reagointien ja stitchien sekä videomainosten ja brändätyn sisällön osalta. Business-tilillä sovelluksen Add Sound näyttää vain kirjastoäänet, ja API vetää saman rajan, sillä music_sound_id ottaa kirjastotunnuksen.

Mitä rajapinta ei voi tehdä musiikilla?

Muutama asia on sen kenttien ulkopuolella, niin kuin TikTokin viitteet ne kuvaavat:

  • Nimetä ääni TikTokin yleisestä kirjastosta: music_sound_id ottaa Commercial Music Library -tunnuksen.
  • Hakea kirjastosta nimellä: /discovery/cml/trending_list/ suodattaa suosittuja kappaleita genren, maan ja ajanjakson mukaan.
  • Pitää musiikkia luonnoksella: upload_to_draft saa TikTokin ohittamaan post_infon muun osan, ja is_draft säilyttää vain otsikon ja kuvatekstin.
  • Käyttää omaa kappaletta orgaanisessa julkaisussa: /file/music/upload/ lisää musiikkia mainosluoviin advertiser_id:n alla, ja TikTokin ilmoituksen mukaan vastuu tekijänoikeuksista jää lataajalle.

Mitkä ovat kiertotiet?

Kolme, joista kukin perustuu TikTokin viitteiden dokumentoimaan, sekä yksi riski punnittavaksi:

  • Sekoita musiikki tiedostoon. TikTokin rajoitukset kuvaavat videon äänivideosisällöksi, joten tiedostoon sekoitettu äänimateriaali lähtee sen mukana. Käytä ääntä, jonka oikeudet sinulla on.
  • Lähetä luonnos. Kun käytät upload_to_draft- tai is_draft-asetusta ja video.upload-oikeutta, julkaisu päätyy luojan TikTok-saapuneisiin, jossa sen voi muokata ja julkaista sovelluksessa.
  • Anna TikTokin valita kuvajulkaisuissa. auto_add_music lisää suositeltua musiikkia, ja omistaja voi vaihtaa sen myöhemmin TikTok-sovelluksessa.
  • Riski sekoitetussa äänessä: TikTokin julkaisuluettelon viite nimeää musiikin tekijänoikeusrikkomukset todennäköisinä syinä, joiden vuoksi julkaisu suodatetaan pois.

Miten näet, toiko ääni katselukertoja?

impression_sources-kentän kautta, joka on /business/video/list/ -kenttä ja järjestää, mistä julkaisun katsojat löysivät sen. Yksi arvoista on Sound, eli katselut äänisivuilta. Se vaatii video.insights-oikeuden ja, kuten muut luvut, tulee 24–48 tuntia myöhässä. easyCoexistence-palvelun kautta get_social_insights palauttaa sen yhdelle tilin 20 viimeisimmästä julkaisusta, kun metrics-kentässä on impression_sources, ja object_id:nä on julkaisun item_id.

Mitä easyCoexistence tekee musiikille?

Se julkaisee tiedostossasi jo olevan äänen. publish_tiktok_post-työkalu, heti tai scheduled_at-ajalla, lähettää kuvatekstin, kuvajulkaisun otsikon ja kommentointiasetuksen ilman music_sound_info-kenttää ja ilman auto_add_music-asetusta. Video säilyttää oman ääniraitansa ja kuvajulkaisu lähtee ilman musiikkia. Oma koodisi voi tehdä POST-pyynnön osoitteeseen business/video/publish/ kentällä music_sound_info ja get_social_credentials-työkalun tokenilla, mutta runko menee TikTokiin sellaisenaan, video_url mukaan lukien. TikTok hakee mediaa vain sovellukselle vahvistetuista domaineista tai URL-etuliitteistä. /discovery/-polut ottavat mainostajan tokenin, joten kappalelista on tilin tokenin ulottumattomissa.

Yleiset virheet

  • Video_original_sound_volume jää pois kappaletta lisätessä. Rajapinnan kautta se on oletuksena 0, kun TikTok-sovellus aloittaa molemmat äänet arvosta 50, joten aseta se aina, kun videon oma ääni on tärkeä.
  • Kappaleen nimen tai preview_url-osoitteen antaminen music_sound_id:nä. TikTokin kappaleviite nimeää arvoksi annettavan song_clip_id:n, joka löytyy kentistä full_duration_song_clip tai trending_song_clip.
  • /discovery/cml/trending_list/-kutsu mainostajan tokenilla. Kappalepäätepisteet ottavat TikTok-tilin tokenin ja business_id:n, kuten Accounts API tekee.
  • Keston 0 pitäminen rikkinäisenä kappaleena. Kappale, joka on vain pidemmän teoksen leike, voi näyttää keston 0, joten tarkista sen esikatselu ennen alun ja lopun valintaa.
Näin teet tämän EasyCoexistencen avulla

Video lähtee ulos ääniraita tiedostoonsa sekoitettuna. Hinta on US$ 9:stä US$ 0,75:een yhteyttä kohden kuukaudessa, ja se laskee yhteyksiä lisättäessä. Ensimmäiset 3 päivää ovat ilmaisia.

Usein kysytyt kysymykset

Voinko lisätä mitä tahansa kappaletta TikTok-julkaisuun API:n kautta?

Commercial Music Library -kappaleita tunnuksen perusteella. Videotiedostoon jo sekoitettu musiikki lähtee tiedoston mukana, joten sen tulisi olla musiikkia, jonka käyttöoikeudet sinulla on.

Mikä äänenvoimakkuus TikTokin API asettaa lisätylle musiikille?

Oletuksena 0. music_sound_volume ja video_original_sound_volume ulottuvat arvosta 0 arvoon 100, ja molemmat ovat oletuksena 0 rajapinnan kautta, kun TikTok-sovellus aloittaa arvosta 50. Aseta ne jokaiselle kappaletta käyttävälle videolle erikseen.

Vaikuttaako julkaisun musiikki, jos julkaisua käytetään myöhemmin mainoksessa?

Kyllä, TikTok tarkistaa sen. /identity/music/authorization/ kertoo mainoksen sijainneille ja näytöspäiville, onko julkaisun musiikki täysin valtuutettu, puuttuuko valtuutus vai onko kyseessä ilman kappaletunnusta.

Kuinka monta kappaletta TikTokin Commercial Music Libraryssä on?

1 miljoona TikTokin Business Help Centerin mukaan, kaikki esihyväksytty kaupalliseen käyttöön. /discovery/cml/trending_list/ palauttaa kerrallaan enintään 100 suosittua.

Lue lisää

Yhdistä ensimmäinen kanavasi kahdessa minuutissa.

Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.

  • 3 päivää ilmaiseksi
  • Peruuta milloin tahansa
  • Vain viralliset API:t
  • Valvottu 24/7

Vahvistettu