ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

Отправка видео в черновики создателя 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 дней вперёд; каждая запланированная публикация видна на экране «Публикации», пока не выйдет.

video.upload

Разрешение, которое TikTok определяет как отправку контента на аккаунт создателя в качестве черновика для дальнейшего редактирования и публикации в TikTok.

5 pending

Максимальное число ожидающих отправок, которое Content Posting API разрешает за любой 24-часовой период, ограничение TikTok для снижения спама.

SEND_TO_USER_INBOX

Статус /business/publish/status/ сообщает, что черновик загружен и TikTok уведомил входящие создателя.

6 a minute

Количество запросов, которое каждый токен доступа пользователя может отправить на эндпоинт загрузки Content Posting API.

Ignored

Что происходит с остальными полями post_info, когда upload_to_draft равно true на /business/video/publish/.

Чем черновик отличается от прямой публикации?

Тем, кто нажимает «Опубликовать». Прямая публикация выходит в эфир после обработки TikTok; черновик попадает во входящие TikTok создателя и публикуется только тогда, когда создатель открывает его, редактирует по своему усмотрению и публикует. Различие касается обоих API публикации TikTok:

Draft (upload)Direct post
Who postsThe creator, in the TikTok appThe app, through the API
Token scopevideo.upload, on both APIsvideo.publish on the Content Posting API
Content Posting API/v2/post/publish/inbox/video/init//v2/post/publish/video/init/
API for Businessupload_to_draft or is_draft set to trueThe same endpoints without them
Status once handed overSEND_TO_USER_INBOXPUBLISH_COMPLETE once live
Caption and settingsMostly finished by the creator in TikTokSent 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:

Upload a video to the creator's inbox from a URL
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, а создатель находит черновик через уведомление во входящих:

Send a video to the creator's drafts on the API for Business
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 просит приложения сообщать им открыть уведомление во входящих, чтобы завершить публикацию.
Настройка с EasyCoexistence

От 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, когда создатель публикует из него.

Читайте дальше

Настройки публикации TikTok через API: приватность, комментарии, Duet и StitchНастройки, которые принимают эндпоинты публикации TikTok: приватность, комментарии, Duet, Stitch, обложка, маркировки и допустимые значения аккаунта.Как проверить статус публикации поста TikTok через APIКак отслеживать пост TikTok, опубликованный через API: share_id, статусы PROCESSING_DOWNLOAD, PUBLISH_COMPLETE и FAILED, ID постов и причины сбоя.Почему посты через TikTok API приватные: unaudited_client_can_only_post_to_private_accountsПочему Content Posting API держит посты приватными до аудита приложения, что значит ошибка 403 и чем API for Business отличается.Как опубликовать видео в TikTok через APIПубликуйте видео в TikTok через API for Business: эндпоинт публикации, тело JSON, share_id из ответа и проверка статуса в curl и Python.Медиа-ссылки TikTok: проверенные домены и префиксы URLКак TikTok API for Business загружает медиа с проверенных доменов и префиксов URL: проверка через DNS TXT, файл подписи и эндпоинты подтверждения.Сбои публикации в TikTok: spam_risk_too_many_posts, picture_size_check_failed и другие причиныЧто означают причины сбоя публикации в TikTok и как их исправить: spam_risk_too_many_posts, picture_size_check_failed, video_pull_failed и другие.

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на