2323 Shorts
ВозможностиТарифы
ВойтиНачать бесплатно
Для разработчиков

API и MCP

Всё, что умеет сайт, доступно из ваших скриптов и AI-ассистентов: отправьте ссылку на видео — получите готовые клипы с субтитрами и текстами для соцсетей.

1. Получите ключ

В настройках аккаунта → «API-ключи». Ключ действует от вашего имени и тратит минуты с вашего баланса — по тем же тарифам, что и на сайте. Храните его как пароль; если он утёк, удалите его там же. Ключом нельзя купить минуты, создать новые ключи или управлять командой.

2а. Подключите к AI-ассистенту (MCP)

23 Shorts — MCP-сервер: ассистент сам отправит видео в работу, дождётся клипов и принесёт ссылки. Например: «нарежь из этого подкаста 5 клипов про инвестиции и пришли лучшие».

Claude Code

claude mcp add --transport http 23shorts https://23shorts.ru/api/mcp \
  --header "Authorization: Bearer sk23_ваш_ключ"

Cursor и другие клиенты с настройкой в JSON (mcp.json)

{
  "mcpServers": {
    "23shorts": {
      "url": "https://23shorts.ru/api/mcp",
      "headers": { "Authorization": "Bearer sk23_ваш_ключ" }
    }
  }
}

Подойдёт любой клиент, который умеет Streamable HTTP и заголовок авторизации. Инструменты сервера:

2б. Или напрямую через HTTP API

Ключ передаётся в заголовке Authorization: Bearer …. Запустить нарезку по ссылке:

curl -X POST https://23shorts.ru/api/projects/import-url \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"url": "https://rutube.ru/video/…", "clip_prompt": "моменты про деньги",
       "clip_count": "5", "clip_length_bucket": "30-45", "speech_cleanup_enabled": true}'

Обработка идёт в фоне несколько минут — опрашивайте статус раз в 30–60 секунд:

# статус: importing → queued → processing → completed
curl https://23shorts.ru/api/projects/$PROJECT_ID -H "Authorization: Bearer $KEY"

# статус uploaded — видео скачано, но обработка не началась (формат 16:9
# или не хватило минут, причина в import_error); запустить вручную:
curl -X POST https://23shorts.ru/api/projects/$PROJECT_ID/process -H "Authorization: Bearer $KEY"

# клипы, лучшие первыми: заголовок, балл, почему, описание и хэштеги
curl https://23shorts.ru/api/projects/$PROJECT_ID/clips -H "Authorization: Bearer $KEY"

# ссылка на MP4, действует 15 минут
curl https://23shorts.ru/api/clips/$CLIP_ID/download-url -H "Authorization: Bearer $KEY"

Поддерживаются ссылки с YouTube, VK Видео, Rutube, Яндекс Диска и Google Drive; файлы загружаются через подписанные ссылки (как на сайте). Полный справочник всех запросов и полей — /api/docs.

Ограничения