> ## Documentation Index > Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # TikTok API > Các tùy chọn để đăng bài bằng TikTok API Ayrshare cung cấp [xuất bản trực tiếp video TikTok](https://www.ayrshare.com/blog/introducing-tiktok-direct-publishing-analytics-and-commenting/), quản lý bình luận, và truy xuất phân tích nâng cao cho tài khoản TikTok cá nhân hoặc doanh nghiệp của bạn bằng TikTok API. TikTok xử lý video và ảnh không đồng bộ, vì vậy phản hồi JSON sẽ có status: "pending" cho cả bài đăng ngay lập tức và đã lên lịch. Khi TikTok đã hoàn thành xử lý, [webhook Scheduled Action](/apis/webhooks/actions#scheduled-action) đã đăng ký của bạn sẽ được gọi. ## Bài đăng video TikTok JSON cho một bài đăng video TikTok cơ bản được xuất bản trực tiếp: ```json TikTok Video Post theme={"system"} { "post": "The best TikTok \n video ever #bestvideo", // Max 2,200 characters with a line break "mediaUrls": ["https://img.ayrshare.com/012/tiktok.mp4"], "platforms": ["tiktok"] } ``` Ví dụ phản hồi JSON của bài đăng: ```json TikTok Video Post Response theme={"system"} { "status": "success", "errors": [], "postIds": [ { "status": "success", "idShare": "video.7088122496758679353.nzLqBWbf", "id": "pending", "isVideo": true, "platform": "tiktok" } ], "id": "lb42orDhySAZmLWtj6b6", "refId": "23a9da9e0df1184a7a6a1fc2c60b8023aa9a32a1", "post": "The best TikTok video ever #bestvideo" } ``` ### Yêu cầu video TikTok TikTok giới hạn xuất bản video qua API 6 video mỗi phút với giới hạn trên là 15 video mỗi ngày. ## Bài đăng hình ảnh TikTok JSON cho một bài đăng hình ảnh (ảnh) TikTok cơ bản được xuất bản trực tiếp: ```json TikTok Image Post theme={"system"} { "post": "The best TikTok \n video ever #bestvideo", // Max 2,200 characters with a line break "mediaUrls": [ "https://img.ayrshare.com/012/gb.jpg", "https://img.ayrshare.com/random/photo-1.jpg" ], // Up to 35 images "platforms": ["tiktok"] } ``` Ví dụ phản hồi JSON: ```json TikTok Image Post Response theme={"system"} { "status": "success", "errors": [], "postIds": [ { "status": "success", "idShare": "p_pub_url~v2.7408974036430047275", "id": "pending", "isVideo": false, "platform": "tiktok" } ], "id": "8815mJ5bWApEebWjE233", "tikTokId": "p_pub_url~v2.7408974036430047333", "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc333", "post": "Opportunity is missed by most people because it is dressed in overalls and looks like work - Thomas Edison" } ``` ### Yêu cầu hình ảnh TikTok TikTok giới hạn xuất bản video qua API 6 ảnh mỗi phút với giới hạn trên là 15 ảnh mỗi ngày. ## Xử lý TikTok TikTok thực hiện xử lý video và hình ảnh không đồng bộ, vì vậy phản hồi sẽ có trường `id` được đặt thành `"pending"`. Sau khi TikTok hoàn thành xử lý của họ, thường trong vòng 1 - 2 phút, trường `id` sẽ được cập nhật với `id` video TikTok và một `postUrl` sẽ được thêm vào. ## Tùy chọn TikTok Khi xuất bản video hoặc hình ảnh TikTok [các tùy chọn bổ sung](/apis/post/social-networks/tiktok#available-tiktok-options) có sẵn. Ví dụ xuất bản video: ```json TikTok Video Publishing theme={"system"} { "tikTokOptions": { "disableComments": true, // Default false. Disable comments on the published video. "disableDuet": true, // Default false. Disable duets on the published video. "disableStitch": true // Default false. Disable stitches on the published video. } } ``` Ví dụ xuất bản hình ảnh: ```json TikTok Image Publishing theme={"system"} { "tikTokOptions": { "imageCoverIndex": 1, // Use the second image in the mediaUrls. "title": "Amazing images" } } ``` ### Các tùy chọn Các tùy chọn sau khả dụng cho bài đăng TikTok. Chúng nên được thêm vào đối tượng `tikTokOptions`. Vui lòng xem bên dưới để biết thêm chi tiết về mỗi tùy chọn. ```json TikTok Options theme={"system"} { "post": "The best TikTok video ever #bestvideo", "mediaUrls": ["https://img.ayrshare.com/012/tiktok.mp4"], "platforms": ["tiktok"], "tikTokOptions": { "autoAddMusic": true, "disableComments": true, "disableDuet": true, "disableStitch": true, "draft": true, "isAIGenerated": true, "isBrandedContent": true, "isBrandOrganic": true, "imageCoverIndex": 1, "title": "Amazing images", "thumbNailOffset": 30000, "visibility": "public" } } ``` Có tự động thêm nhạc được đề xuất vào bài đăng hay không. Nếu bạn đặt trường này thành `true`, bạn có thể thay đổi nhạc sau trong ứng dụng TikTok. Loại phương tiện: image Có tắt bình luận trên bài đăng đã xuất bản hay không. Loại phương tiện: video, image Tắt duets trên video đã xuất bản. Loại phương tiện: video Tắt stitch trên video đã xuất bản. Loại phương tiện: video Có tạo bài đăng nháp hay không. Xem [tùy chọn nháp](/apis/post/social-networks/tiktok#tiktok-video-draft-post) để biết thêm thông tin. Loại phương tiện: video hoặc image Có bật nút bật/tắt nội dung do AI tạo ra cho bài đăng video hay không. Nếu bạn bật, video của bạn sẽ được gắn nhãn là "Creator labeled as AI-generated" khi được đăng và không thể thay đổi. Nhãn "Creator labeled as AI-generated" chỉ ra rằng nội dung được tạo ra hoàn toàn bởi AI hoặc được chỉnh sửa đáng kể bằng AI. Việc bật cài đặt nội dung do AI tạo ra sẽ không ảnh hưởng đến sự phân phối video của bạn miễn là nó không vi phạm [Cộng đồng Nguyên tắc](https://www.tiktok.com/community-guidelines/en/) của TikTok. Loại phương tiện: video Có bật nút bật/tắt Branded Content hay không. Nếu trường này được đặt thành `true`, video sẽ được gắn nhãn là Branded Content, cho biết bạn đang trong quan hệ đối tác trả phí với một thương hiệu. Một nhãn "Paid partnership" sẽ được gắn với video. Loại phương tiện: video, image Có bật nút bật/tắt Brand Organic Content hay không. Nếu trường này được đặt thành `true`, video sẽ được gắn nhãn là Brand Organic Content, cho biết bạn đang quảng bá bản thân hoặc doanh nghiệp của riêng bạn. Một nhãn "Promotional content" sẽ được gắn với video. Loại phương tiện: video, image Chỉ số của `mediaUrls` sẽ được sử dụng làm bìa cho bài đăng. Loại phương tiện: image Tiêu đề của bài đăng. Loại phương tiện: image Khung để sử dụng cho bìa video. Xem [tùy chọn thumbnail video](/apis/post/social-networks/tiktok#video-thumbnail) để biết thêm thông tin. Loại phương tiện: video Cách bài đăng được chia sẻ và ai có thể xem nó. Các giá trị: `public`, `private`, `followers`, hoặc `friends`. Xem [tùy chọn visibility](/apis/post/social-networks/tiktok#visibility-options) để biết thêm thông tin. Loại phương tiện: image ### Tùy chọn Visibility | Visibility | Mô tả | | :--------- | :---------------------------------------------- | | public | Hiển thị với tất cả người dùng TikTok. | | private | Riêng tư, chỉ hiển thị với chính tài khoản. | | followers | Chỉ hiển thị với người theo dõi của tài khoản. | | friends | Chỉ hiển thị với những người theo dõi lẫn nhau. | Các bài đăng riêng tư sẽ vẫn ở trạng thái `pending` và không có webhook TikTok nào được gửi cho đến khi bài đăng được công khai. ## Thumbnail video Có hai cách để đặt thumbnail, còn được gọi là ảnh bìa, cho một video TikTok: 1. Sử dụng tham số `thumbNailOffset` để đặt khung thumbnail. 2. Sử dụng tham số `thumbNail` để đặt hình ảnh thumbnail từ URL. Chỉ video được hỗ trợ cho việc đặt thumbnail. ### Thumbnail Offset Đặt thumbnail cho một video TikTok bằng cách chọn một khung offset. ```json TikTok Video Thumbnail Offset theme={"system"} { "tikTokOptions": { "thumbNailOffset": 30000 // milliseconds of offset image } } ``` Offset là vị trí tính bằng mili giây của khung thumbnail. Giá trị mặc định là `0`, là khung đầu tiên của video. ### Thumbnail URL Đặt thumbnail cho một video TikTok bằng cách tải lên một hình ảnh từ URL. ```json TikTok Video Thumbnail URL theme={"system"} { "tikTokOptions": { "thumbNail": "https://img.ayrshare.com/012/gb.jpg" } } ``` Nếu bạn sử dụng tham số `thumbNail`, tham số `thumbNailOffset` sẽ bị bỏ qua. Vui lòng xem [Yêu cầu Thumbnail TikTok](/media-guidelines/tiktok#video-thumbnail) để biết thêm thông tin. ## Nhắc tên (Mention) trên TikTok Nhắc tên một handle TikTok khác bằng cách thêm `@handle` vào nội dung bài đăng. Ví dụ: ```json TikTok Mention theme={"system"} { "post": "Love the @ayrshare social media api" } ``` Vui lòng xem lại [các quy tắc quan trọng](/testing/post-verification#mentions) về nhắc tên. ## Bài đăng nháp TikTok Tạo bài đăng nháp cho video hoặc hình ảnh TikTok, cho phép bạn chỉnh sửa video hoặc hình ảnh trước khi xuất bản. ```json TikTok Video Draft Post theme={"system"} { "post": "The best TikTok video ever #bestvideo", // empty string is allowed "mediaUrls": ["https://img.ayrshare.com/012/tiktok.mp4"], "platforms": ["tiktok"], "tikTokOptions": { "draft": true } } ``` Bài đăng video hoặc hình ảnh nháp sẽ được tìm thấy dưới thông báo **Inbox** ở hàng dưới cùng của ứng dụng TikTok. Tìm tin nhắn **System notifications** và sau đó nhấp vào tin nhắn **Your content from Ayrshare is ready** ở trên cùng. `postUrl` Ayrshare sẽ vẫn ở trạng thái `pending` cho đến khi video được xuất bản. Bình luận đầu tiên không được hỗ trợ trên các bài đăng nháp. TikTok Draft Post ## Làm mới cấp phép (Authorization Refresh) TikTok phải được cấp phép lại *mỗi năm* qua trang Social Accounts. ## Giới hạn ký tự Vui lòng xem [Giới hạn ký tự TikTok](/help-center/technical-support/character_limits#tiktok-character-limits) để biết thêm thông tin. ## Thông tin bổ sung Thêm [ví dụ về việc sử dụng TikTok API](https://www.ayrshare.com/blog/tiktok-api-how-to-post-to-tiktok-using-a-social-media-api/).