Переводчик Creator Tools теперь доступен через API

До сих пор, чтобы перевести видео в Creator Tools, нужно было открыть приложение, выбрать видео и отметить языки. Так можно делать и дальше. Но если вы публикуете много, ведёте несколько каналов или у вас уже есть свой процесс загрузки, то же самое теперь можно сделать из кода: отправьте один запрос, а остальное сделает переводчик.

Что умеет API

API даёт вам тот же переводчик, что и в приложении, только без кликов. Для любого видео на подключённом канале он может:

Перевести название и описание на выбранные вами языки
Перевести и субтитры, если вы об этом попросите
Перевести название и описание канала, если видео не указано
Сразу записать переводы на YouTube, чтобы зрители увидели их без задержки

Доступны все настройки приложения: тон текста, сохранение хештегов и упоминаний без изменений, отмеченные слова без перевода, региональные варианты языков, например бразильский португальский или мексиканский испанский, и особый режим для песен и стихов.

Кому это подойдёт

Авторам с регулярным графиком загрузок, которые хотят, чтобы каждое новое видео переводилось сразу после публикации
Студиям и агентствам, которые ведут много каналов и хотят встроить перевод в свои инструменты
Разработчикам и любителям автоматизации, которые связывают сервисы скриптами, инструментами вроде Zapier или собственным бэкендом

Если после каждой загрузки вы переводите видео одинаково, этот шаг может выполняться сам.

Как это работает: три шага

Шаг 1: подключите канал в приложении

Войдите в Creator Tools и добавьте свой канал, как обычно. API использует это же подключение, поэтому отдельно входить в YouTube не нужно.

Шаг 2: запустите перевод

Отправьте запрос с ID видео и списком языков. Переводчик сразу ответит номером задачи и начнёт работу в фоне.

Шаг 3: проверьте результат

Запрашивайте статус задачи каждые несколько секунд. Когда он станет FINISHED, переводы уже будут на YouTube. Видео с длинными субтитрами и большим числом языков переводится дольше, чем короткое.

Что для этого нужно

Подписка Creator Tools с оставшимися переводами — API расходует тот же баланс, что и приложение
Канал, подключённый в приложении
Ключ шлюза для API: запросите его у службы поддержки по адресу info@creator-tools.com или через бота Creator Tools
Ваш личный ключ и данные канала, которые нужно один раз скопировать из браузера. В руководстве по API точно показано, где их найти.

Храните эти ключи в тайне. Любой, у кого они есть, может запускать переводы на вашем канале и тратить ваш баланс.

Полезно знать

Одно видео за раз. Запускайте следующий перевод только после того, как закончился предыдущий. Так баланс списывается правильно, а вы не упираетесь в лимиты YouTube.
Существующие переводы сохраняются. Языки, которые у видео уже есть, пропускаются, если вы не попросите их перезаписать.
Больше 140 языков. API использует те же коды языков, что и YouTube: от es и de до pt-BR и zh-Hans.
Понятные ошибки. Если что-то не так — истекло подключение канала или закончился баланс, — в ответе будет сказано, в чём дело.

С чего начать

Всё, что нужно для первого запроса, — где найти ключи, все настройки, готовые примеры для копирования и полный список кодов языков — собрано в руководстве:

API переводчика Creator Tools: руководство разработчика

Не хотите писать код? Для вас ничего не меняется: переводчик в приложении работает так же, как раньше.