ΣύνδεσηΞεκινήστε δωρεάν δοκιμή
easyCoexistence Επίσημα API

Προσθήκη μουσικής σε δημοσιεύσεις TikTok μέσω του API

Το API for Business του TikTok προσθέτει μουσική από τη Commercial Music Library: το post_info.music_sound_info δέχεται το music_sound_id ενός κομματιού τόσο σε δημοσιεύσεις βίντεο όσο και σε δημοσιεύσεις φωτογραφιών, ενώ στα βίντεο δέχεται επίσης την ένταση του κομματιού, την αρχή και το τέλος του σε χιλιοστά του δευτερολέπτου και την ένταση του δικού ήχου του βίντεο. Οι δημοσιεύσεις φωτογραφιών μπορούν επίσης να δεχτούν auto_add_music για προτεινόμενη μουσική. Τα ID των κομματιών προέρχονται από το GET /discovery/cml/trending_list/.

Το easyCoexistence δημοσιεύει βίντεο και δημοσιεύσεις φωτογραφιών του TikTok με το publish_tiktok_post, από το Claude, το ChatGPT ή τον δικό σας κώδικα, άμεσα ή σε συγκεκριμένη ώρα έως 90 ημέρες μπροστά.

100

Τα πιο δημοφιλή κομμάτια που επιστρέφει το /discovery/cml/trending_list/, όλα προεγκεκριμένα για οργανικό περιεχόμενο και δημιουργία διαφημίσεων.

0 to 100

Εύρος των music_sound_volume και video_original_sound_volume. Μέσω του API και τα δύο έχουν προεπιλογή 0, ενώ η εφαρμογή TikTok ξεκινά από 50.

1 million

Κομμάτια της Commercial Music Library του TikTok, τη προεγκεκριμένη παγκόσμια βιβλιοθήκη που χρησιμοποιούν οι επιχειρήσεις για εμπορική δραστηριότητα στο TikTok.

TikTok only

Όπου μπορεί να προβάλλονται δημιουργικά με μουσική από τη λίστα μουσικής διαφημίσεων του TikTok, εκτός αν οι κάτοχοι δικαιωμάτων δώσουν ξεχωριστή άδεια.

DIRECT_POST

Το μόνο post_mode στο οποίο το endpoint φωτογραφιών του Content Posting API εφαρμόζει το auto_add_music, στο developers.tiktok.com.

Ποια πεδία μουσικής δέχονται τα endpoints δημοσίευσης του TikTok;

Και τα δύο endpoints περιέχουν τη μουσική μέσα στο post_info, κάτω από το music_sound_info, και ορίζουν ένα κομμάτι με το ID του από τη Commercial Music Library. Πέρα από αυτό διαφέρουν: το endpoint βίντεο προσθέτει χειριστήρια ανάμιξης, και το endpoint φωτογραφιών προσθέτει διακόπτη που επιτρέπει στο TikTok να επιλέξει τη μουσική. Δίπλα δίπλα, όπως τα παραθέτουν οι αναφορές του TikTok:

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

Πώς προσθέτετε κομμάτι σε βίντεο;

Στείλτε το music_sound_info μέσα στο post_info στο POST /business/video/publish/. Μόλις υπάρχει το αντικείμενο, τα music_sound_id και music_sound_volume είναι υποχρεωτικά. Τα music_sound_start και music_sound_end επιλέγουν το τμήμα του κομματιού σε χιλιοστά του δευτερολέπτου, από την αρχή του κομματιού έως το πλήρες μήκος του βίντεο, ως προεπιλογή. Έτσι ένα βίντεο 2 δευτερολέπτων παίρνει τα πρώτα 2.000 χιλιοστά του κομματιού. Ορίστε και το video_original_sound_volume όποτε έχει σημασία ο δικός ήχος του βίντεο, αφού η προεπιλογή του είναι 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
      }
    }
  }'

Από πού προέρχονται τα ID των κομματιών;

Από το GET /discovery/cml/trending_list/, ένα endpoint του Discovery API που δέχεται το access token ενός λογαριασμού TikTok και το business_id, ενώ τα endpoints hashtag του Discovery δέχονται το αντίστοιχο ενός διαφημιζόμενου. Η αναφορά του TikTok το κατατάσσει στην άδεια Discovery της Creative Management. Επιστρέφει έως 100 δημοφιλή κομμάτια, καθένα με το όνομά του, τον καλλιτέχνη, τη διάρκεια, τη θέση κατάταξης, τα είδη, ένα preview_url που δεν λήγει και έως 30 ημέρες trending_history. Τα full_duration_song_clip και trending_song_clip περιέχουν το καθένα ένα song_clip_id, την τιμή που το TikTok ονομάζει music_sound_id:

  • genre: ALL από προεπιλογή, ή μία από πάνω από 100 τιμές, όπως POP, LATIN, LO-FI ή SERTANEJO.
  • country_code: US από προεπιλογή. date_range: 1DAY, 7DAY από προεπιλογή, 30DAY ή 90DAY.
  • /discovery/cml/video_list/: τα 20 κορυφαία βίντεο τάσεων που χρησιμοποιούν ένα κομμάτι, με το commercial_music_id του και ένα country_code.
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'

Πώς παίρνουν μουσική οι δημοσιεύσεις φωτογραφιών;

Με δύο τρόπους στο POST /business/photo/publish/. Το auto_add_music ορισμένο σε true κάνει το TikTok να προσθέτει προτεινόμενη μουσική, την οποία ο ιδιοκτήτης μπορεί να αλλάξει αργότερα στην εφαρμογή TikTok. Το music_sound_info.music_sound_id ονομάζει ένα συγκεκριμένο κομμάτι της βιβλιοθήκης, χωρίς πεδία έντασης, αρχής ή τέλους στις φωτογραφίες. Στο developers.tiktok.com, το endpoint φωτογραφιών του Content Posting API έχει το δικό του auto_add_music, που εφαρμόζεται μόνο όταν το post_mode είναι DIRECT_POST. Το endpoint δημοσίευσης βίντεο για άμεση δημοσίευση δεν τεκμηριώνει πεδίο μουσικής.

Τι σημαίνει η Commercial Music Library για λογαριασμούς επιχειρήσεων;

Είναι η μουσική που επιτρέπεται να χρησιμοποιούν. Το Business Help Center του TikTok περιγράφει τη βιβλιοθήκη ως μια προεγκεκριμένη παγκόσμια συλλογή 1 εκατομμυρίου τραγουδιών. Λέει ότι οι επιχειρήσεις δεν μπορούν να χρησιμοποιούν τη γενική μουσική βιβλιοθήκη για εμπορική χρήση, και τις παραπέμπει στην Commercial Music Library για οργανικό περιεχόμενο, συμμετοχές με duets, reacts και stitches, διαφημίσεις βίντεο και επώνυμο περιεχόμενο. Σε Business Account, το Add Sound στην εφαρμογή δείχνει μόνο ήχους της βιβλιοθήκης, και το API ακολουθεί την ίδια λογική, αφού το music_sound_id δέχεται ID της βιβλιοθήκης.

Τι δεν μπορεί να κάνει το API με τη μουσική;

Μερικά πράγματα βρίσκονται έξω από τα πεδία του, όπως τα περιγράφουν οι αναφορές του TikTok:

  • Να ονομάσει έναν ήχο από τη γενική βιβλιοθήκη του TikTok: το music_sound_id δέχεται ID της Commercial Music Library.
  • Να αναζητήσει τη βιβλιοθήκη με τίτλο: το /discovery/cml/trending_list/ φιλτράρει τα δημοφιλή κομμάτια ανά είδος, χώρα και περίοδο.
  • Να κρατήσει τη μουσική σε πρόχειρο: το upload_to_draft κάνει το TikTok να αγνοεί το υπόλοιπο post_info, και το is_draft κρατά μόνο τον τίτλο και τη λεζάντα.
  • Να χρησιμοποιήσει δικό σας κομμάτι σε οργανική δημοσίευση: το /file/music/upload/ προσθέτει μουσική για δημιουργικά διαφημίσεων κάτω από ένα advertiser_id, και η ειδοποίηση του TikTok εκεί αφήνει την ευθύνη πνευματικών δικαιωμάτων στον μεταφορτωτή.

Ποιες είναι οι εναλλακτικές λύσεις;

Τρεις, με βάση όσα τεκμηριώνουν οι αναφορές του TikTok, και ένας κίνδυνος που πρέπει να σταθμίσετε:

  • Ενσωματώστε τη μουσική στο αρχείο. Οι περιορισμοί του TikTok περιγράφουν το βίντεο ως περιεχόμενο ήχου-εικόνας, άρα ένα ενσωματωμένο soundtrack βγαίνει μαζί του. Χρησιμοποιήστε ήχο για τον οποίο έχετε τα δικαιώματα.
  • Στείλτε πρόχειρο. Με upload_to_draft ή is_draft και το scope video.upload, η δημοσίευση καταλήγει στα εισερχόμενα του δημιουργού στο TikTok, για επεξεργασία και δημοσίευση μέσα στην εφαρμογή.
  • Αφήστε το TikTok να επιλέξει στις δημοσιεύσεις φωτογραφιών. Το auto_add_music προσθέτει προτεινόμενη μουσική, και ο ιδιοκτήτης μπορεί να την αλλάξει αργότερα στην εφαρμογή TikTok.
  • Ο κίνδυνος με τον ενσωματωμένο ήχο: η λίστα δημοσιεύσεων του TikTok αναφέρει τις παραβάσεις πνευματικών δικαιωμάτων μουσικής μεταξύ των πιθανών λόγων φιλτραρίσματος μιας δημοσίευσης.

Πώς βλέπετε αν ένας ήχος έφερε προβολές;

Μέσω του impression_sources, ενός πεδίου του /business/video/list/ που κατατάσσει από πού βρήκαν τη δημοσίευση οι θεατές της. Μία από τις τιμές του είναι Sound, για προβολές που προήλθαν από σελίδες ήχων. Χρειάζεται το scope video.insights και, όπως και οι άλλες μετρήσεις, φτάνει με καθυστέρηση 24 έως 48 ωρών. Μέσω του easyCoexistence, το get_social_insights το επιστρέφει για μία από τις 20 πιο πρόσφατες δημοσιεύσεις του λογαριασμού, όταν το impression_sources ονομάζεται στα metrics, με το item_id της δημοσίευσης ως object_id.

Τι κάνει το easyCoexistence με τη μουσική;

Δημοσιεύει τον ήχο που ήδη υπάρχει στο αρχείο σας. Το publish_tiktok_post, άμεσα ή με scheduled_at, στέλνει τη λεζάντα, τον τίτλο φωτογραφίας και τη ρύθμιση σχολίων, χωρίς music_sound_info και χωρίς auto_add_music. Έτσι ένα βίντεο κρατά το δικό του soundtrack, και μια δημοσίευση φωτογραφίας βγαίνει χωρίς μουσική. Ο δικός σας κώδικας μπορεί να κάνει POST στο business/video/publish/ με music_sound_info και το token από το get_social_credentials, αλλά αυτό το σώμα φτάνει στο TikTok όπως είναι γραμμένο, με το video_url μέσα, και το TikTok ανακτά πολυμέσα μόνο από domains ή URL prefixes επαληθευμένα για την εφαρμογή. Οι διαδρομές /discovery/ παίρνουν το token ενός διαφημιστή, άρα η λίστα κομματιών είναι εκτός της εμβέλειας του token του λογαριασμού.

Συνηθισμένα λάθη

  • Το να παραλείπετε το video_original_sound_volume όταν προσθέτετε κομμάτι. Μέσω του API έχει προεπιλογή 0, ενώ η εφαρμογή TikTok ξεκινά και τους δύο ήχους από 50. Ορίστε το όποτε έχει σημασία ο δικός ήχος του βίντεο.
  • Το να περνάτε το όνομα ή το preview_url ενός κομματιού ως music_sound_id. Η αναφορά του TikTok για τα κομμάτια ονομάζει το song_clip_id, από το full_duration_song_clip ή το trending_song_clip, ως την τιμή που πρέπει να περάσετε.
  • Το να καλείτε το /discovery/cml/trending_list/ με token διαφημιζόμενου. Τα endpoints κομματιών δέχονται το access token ενός λογαριασμού TikTok και το business_id, όπως και το Accounts API.
  • Το να διαβάζετε διάρκεια 0 ως κατεστραμμένο κομμάτι. Το TikTok σημειώνει ότι ένα κομμάτι που είναι μόνο απόσπασμα μεγαλύτερου έργου μπορεί να εμφανίζει 0, οπότε ελέγξτε την προεπισκόπησή του πριν επιλέξετε αρχή και τέλος.
Κάντε το με EasyCoexistence

Ένα βίντεο βγαίνει με το soundtrack ενσωματωμένο στο αρχείο του. US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και δωρεάν δοκιμή 3 ημερών.

Συχνές ερωτήσεις

Μπορώ να προσθέσω οποιοδήποτε τραγούδι σε δημοσίευση TikTok μέσω του API;

Τραγούδια της Commercial Music Library, με ID. Μουσική που είναι ήδη ενσωματωμένη σε αρχείο βίντεο βγαίνει μαζί με το αρχείο, οπότε θα πρέπει να είναι μουσική για την οποία έχετε δικαίωμα χρήσης.

Ποια ένταση ορίζει το API του TikTok για τη μουσική που προστίθεται;

0 από προεπιλογή. Τα music_sound_volume και video_original_sound_volume κινούνται από 0 έως 100, και τα δύο έχουν προεπιλογή 0 μέσω του API, ενώ η εφαρμογή TikTok ξεκινά από 50. Ορίστε τα σε κάθε βίντεο με κομμάτι.

Έχει σημασία η μουσική μιας δημοσίευσης αν αργότερα χρησιμοποιηθεί σε διαφήμιση;

Το TikTok τη μουσική την ελέγχει: το /identity/music/authorization/ αναφέρει, για τις τοποθεσίες και τις ημερομηνίες προβολής της διαφήμισης, αν η μουσική της δημοσίευσης είναι πλήρως εξουσιοδοτημένη, χωρίς εξουσιοδότηση ή χωρίς ID τραγουδιού.

Πόσα τραγούδια έχει η Commercial Music Library του TikTok;

1 εκατομμύριο, σύμφωνα με το Business Help Center του TikTok, όλα προεγκεκριμένα για εμπορική χρήση. Το /discovery/cml/trending_list/ επιστρέφει έως 100 δημοφιλή κάθε φορά.

Συνεχίστε την ανάγνωση

Πώς να ανεβάσετε βίντεο στο TikTok μέσω του APIΑνεβάστε βίντεο στο TikTok με το API for Business: το publish endpoint, το JSON body, το share_id και την κλήση status, σε curl και Python.Φωτογραφικές αναρτήσεις και καρουζέλ TikTok μέσω του API: έως 35 εικόνεςΤο API for Business του TikTok δημοσιεύει φωτογραφικές αναρτήσεις: 1 έως 35 εικόνες JPEG ή WebP έως 20 MB η καθεμία, τίτλο 90 χαρακτήρων, λεζάντα, εξώφυλλο.Τι μπορεί να κάνει το TikTok API το 2026, και τι μένει στην εφαρμογήΤι κάνει το API for Business του TikTok το 2026: αναρτήσεις, σχόλια, στατιστικά και τα webhooks. Τα άμεσα μηνύματα και η επεξεργασία μένουν στην εφαρμογή.Η καλύτερη ώρα για ανάρτηση στο TikTok, από τα δεδομένα του ίδιου του APIΒρείτε τις ώρες με τη μεγαλύτερη δραστηριότητα ακολούθων στο audience_activity και προγραμματίστε τις αναρτήσεις σας σε αυτές.Προτάσεις hashtags TikTok και δημοφιλή hashtags μέσω του APIΠροτάσεις hashtags μέσω του API του TikTok: 10 ανά λέξη-κλειδί σε 35 γλώσσες, τα 200 πιο δημοφιλή και το token που χρειάζεται το καθένα.

Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.

Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.

  • 3 ημέρες δωρεάν
  • Ακύρωση ανά πάσα στιγμή
  • Μόνο επίσημα API
  • Παρακολούθηση 24/7

Επαληθεύτηκε στις