Отправка видео в черновики создателя TikTok через API
TikTok API отправляет видео в черновики создателя через поток загрузки. Эндпоинт /v2/post/publish/inbox/video/init/ из Content Posting API загружает видео с разрешением video.upload, а TikTok отправляет создателю уведомление во входящие, чтобы он отредактировал и опубликовал его в приложении. API для бизнеса делает то же самое с помощью upload_to_draft на /business/video/publish/ или is_draft для фотопостов.
easyCoexistence публикует видео и фотопосты TikTok через publish_tiktok_post из Claude, ChatGPT или вашей платформы, сразу или в заданную дату и время до 90 дней вперёд; каждая запланированная публикация видна на экране «Публикации», пока не выйдет.
Разрешение, которое TikTok определяет как отправку контента на аккаунт создателя в качестве черновика для дальнейшего редактирования и публикации в TikTok.
Максимальное число ожидающих отправок, которое Content Posting API разрешает за любой 24-часовой период, ограничение TikTok для снижения спама.
Статус /business/publish/status/ сообщает, что черновик загружен и TikTok уведомил входящие создателя.
Количество запросов, которое каждый токен доступа пользователя может отправить на эндпоинт загрузки Content Posting API.
Что происходит с остальными полями post_info, когда upload_to_draft равно true на /business/video/publish/.
Чем черновик отличается от прямой публикации?
Тем, кто нажимает «Опубликовать». Прямая публикация выходит в эфир после обработки TikTok; черновик попадает во входящие TikTok создателя и публикуется только тогда, когда создатель открывает его, редактирует по своему усмотрению и публикует. Различие касается обоих API публикации TikTok:
| Draft (upload) | Direct post | |
|---|---|---|
| Who posts | The creator, in the TikTok app | The app, through the API |
| Token scope | video.upload, on both APIs | video.publish on the Content Posting API |
| Content Posting API | /v2/post/publish/inbox/video/init/ | /v2/post/publish/video/init/ |
| API for Business | upload_to_draft or is_draft set to true | The same endpoints without them |
| Status once handed over | SEND_TO_USER_INBOX | PUBLISH_COMPLETE once live |
| Caption and settings | Mostly finished by the creator in TikTok | Sent in the call |
Как Content Posting API загружает черновик?
POST-запросом на https://open.tiktokapis.com/v2/post/publish/inbox/video/init/ с токеном доступа пользователя, в котором есть video.upload, и объектом source_info. PULL_FROM_URL означает, что TikTok сам забирает видео с домена или префикса URL, подтверждённого приложением; FILE_UPLOAD возвращает upload_url, на который файл отправляется частями PUT-запросами. Возвращённый publish_id передаётся в /v2/post/publish/status/fetch/. Для фото используется /v2/post/publish/content/init/ с post_mode, равным MEDIA_UPLOAD. TikTok просит приложения сообщить пользователям, что нужно открыть уведомление во входящих, чтобы продолжить редактирование в TikTok:
curl -X POST 'https://open.tiktokapis.com/v2/post/publish/inbox/video/init/' \
-H 'Authorization: Bearer <USER_ACCESS_TOKEN>' \
-H 'Content-Type: application/json; charset=UTF-8' \
-d '{
"source_info": {
"source": "PULL_FROM_URL",
"video_url": "https://media.example.com/tiktok/draft.mp4"
}
}'
# data.publish_id: pass it to /v2/post/publish/status/fetch/Какие ограничения действуют на черновики Content Posting API?
TikTok описывает их в справочнике по загрузке. Каждое ограничение возвращает вызов init, когда оно применяется:
- Ожидающие черновики: не более 5 ожидающих отправок за любой 24-часовой период; сверх этого возвращается
spam_risk_too_many_pending_shareс HTTP 403. - Запросы: 6 в минуту на токен доступа пользователя, затем
rate_limit_exceededс HTTP 429. - Область доступа: токен без video.upload получает
scope_not_authorizedс HTTP 401. - Медиа:
PULL_FROM_URLс домена или префикса, которые приложение не подтвердило, получаетurl_ownership_unverifiedс HTTP 403.
Как API для бизнеса загружает черновик?
Через свои эндпоинты публикации и одно дополнительное поле в post_info. На /business/video/publish/ значение upload_to_draft, равное true, отправляет видео как черновик, и TikTok игнорирует остальные поля post_info; на /business/photo/publish/ поле is_draft сохраняет только заголовок и подпись. Для обоих нужен video.upload в токене аккаунта, который показывает /tt_user/token_info/get/. Без него владелец одобряет загрузку черновиков, повторно авторизовав приложение. Медиа по-прежнему лежит на подтверждённом URL, статус показывает SEND_TO_USER_INBOX, а создатель находит черновик через уведомление во входящих:
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/draft.mp4",
"post_info": {
"upload_to_draft": true,
"is_brand_organic": false,
"is_branded_content": false
}
}'Что создатель делает с черновиком?
Доводит его в TikTok. Уведомление во входящих открывает загруженное видео или фото в редакторе TikTok, где создатель проверяет и редактирует их и публикует. В Content Posting API статус переходит из SEND_TO_USER_INBOX в PUBLISH_COMPLETE, когда создатель публикует черновик, и TikTok отмечает, что из одного черновика может выйти больше одной публикации.
Отправляет ли easyCoexistence черновики?
Нет: publish_tiktok_post публикует. Он вызывает /business/video/publish/ или /business/photo/publish/ без upload_to_draft и is_draft, поэтому публикация выходит в эфир после обработки TikTok. Чтобы придержать публикацию на проверку, запланируйте её через scheduled_at: от 1 минуты до 90 дней вперёд. Она ждёт в разделе «Предстоящие» на экране «Публикации»; update_scheduled_post меняет её время, подпись или заголовок фотопубликации, а cancel_scheduled_post останавливает её до выхода.
Распространённые ошибки
- Запрос video.publish для отправки черновиков. Черновикам нужно разрешение video.upload, то есть то, которое TikTok описывает как отправку контента в виде черновика.
- Задание подписи для видеочерновика через API для бизнеса. При upload_to_draft, равном true, TikTok игнорирует остальные поля post_info.
- Загрузка черновиков быстрее, чем создатели их публикуют. Content Posting API останавливается на 5 ожидающих отправках за 24 часа с spam_risk_too_many_pending_share.
- Отсутствие указания пользователям на входящие. TikTok просит приложения сообщать им открыть уведомление во входящих, чтобы завершить публикацию.
От US$ 9 до US$ 0,75 за подключение в месяц, цена снижается по мере добавления подключений, первые 3 дня бесплатно.
Часто задаваемые вопросы
Может ли TikTok API сохранить видео как черновик?
Да. Процесс загрузки кладёт его во входящие создателя в TikTok, где создатель редактирует и публикует видео; токену нужно разрешение video.upload.
Где появляется черновик, отправленный через API?
В приложении TikTok, за уведомлением во входящих, которое открывает видео в редакторе TikTok, чтобы создатель его доработал.
Сохранит ли черновик TikTok мою подпись?
В API для бизнеса фото-черновик сохраняет заголовок и подпись, а видеочерновик отбрасывает остальные поля post_info.
Может ли один черновик TikTok стать несколькими публикациями?
Да. TikTok отмечает, что из одного черновика может выйти больше одной публикации, а в Content Posting API статус переходит в PUBLISH_COMPLETE, когда создатель публикует из него.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на