SpeakNotesSpeakNotes
Начать работу
Платформа для разработчиков

API, MCP-сервер и OAuth-платформа SpeakNotes

Превращайте аудио, видео и ссылки YouTube в транскрипты и структурированные резюме с помощью собственного кода или позвольте ИИ-агенту сделать это через MCP. Каждый аккаунт может создать ключ и бесплатно начать работу в песочнице.

  • Создайте ключ самостоятельно в панели управления. Никаких звонков от отдела продаж или списков ожидания.
  • Ключи песочницы возвращают фиксированные результаты, не расходуют кредиты и не затрагивают ваши реальные заметки.
  • Размещенный MCP-сервер, чтобы Claude, ChatGPT и Cursor могли использовать SpeakNotes напрямую.
Создать API-ключОзнакомиться с кратким руководством

Три шага до вашего первого резюме

Начните с ключа песочницы (sandbox), чтобы изучить структуру, а затем переключитесь на рабочий ключ, когда ответы будут выглядеть корректно.

  1. 1

    Создайте ключ

    Откройте «Настройки», затем «API-ключи» и создайте один. Выберите sandbox для тестирования или live для обработки реальных аудиофайлов.

    # Any signed-in account can create one. Sandbox keys start sn_test_.
open https://speaknotes.io/settings/api-keys
  2. 2

    Вызовите API

    Отправьте ключ в качестве bearer-токена. Резюме, транскрипции и задачи YouTube возвращаются в ответе.

    curl -X POST https://api.speaknotes.io/v1/summaries \
  -H "Authorization: Bearer $SPEAKNOTES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "...your transcript...", "styleId": "meeting-notes"}'
  3. 3

    Загрузите длинные медиафайлы

    Загрузки выполняются в фоновом режиме: создайте задачу загрузки, выполните PUT-запрос файла, завершите его, а затем опрашивайте статус заметки до готовности.

    # 1. create the upload
curl -X POST https://api.speaknotes.io/v1/uploads \
  -H "Authorization: Bearer $SPEAKNOTES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fileName": "standup.m4a", "contentType": "audio/mp4"}'

# 2. PUT the file to uploadUrl, then complete it
curl -X POST https://api.speaknotes.io/v1/uploads/NOTE_ID/complete \
  -H "Authorization: Bearer $SPEAKNOTES_API_KEY"

# 3. poll until status is Done
curl https://api.speaknotes.io/v1/notes/NOTE_ID/status \
  -H "Authorization: Bearer $SPEAKNOTES_API_KEY"

Что дает вам платформа

REST API для чтения и записи

Просматривайте, создавайте, обновляйте и удаляйте заметки и папки. Транскрибируйте аудио, создавайте резюме текста и ссылок YouTube. Каждая операция описана в спецификации OpenAPI 3.1.

Хостируемый MCP-сервер

Потоковый HTTP по адресу api.speaknotes.io/mcp с тринадцатью инструментами, охватывающими те же операции чтения и записи. Агенты подключаются через OAuth или с помощью ключа.

OAuth 2.1 с PKCE

Создавайте приложения, действующие от имени других пользователей SpeakNotes. Динамическая регистрация клиентов позволяет MCP-клиенту зарегистрироваться и подключиться без необходимости копирования ключа.

Настоящая песочница

Ключи, начинающиеся с sn_test_, выполняют каждый маршрут, правило валидации и структуру ответа с фиксированными данными. Никаких кредитов, никаких вызовов моделей, а записи сохраняются в отдельной библиотеке песочницы.

Прозрачные кредиты

Один кредит равен одной начатой минуте медиа. Каждый платный ответ возвращает информацию о списании и остатке, чтобы агент мог проверить баланс перед началом работы.

Область действия учетных данных

Предоставляйте ключу или приложению только необходимые права. Ключ с доступом только для чтения может просматривать заметки, но не сможет их удалить.

Тарифы

Каждый аккаунт получает ежемесячный пакет кредитов, который обновляется. Аккаунты Pro получают значительно больше. Сверх этого кредиты являются предоплаченными, поэтому бесконечный цикл повторных запросов никогда не приведет к непредвиденным расходам.

60
кредитов в месяц на бесплатном тарифе
2,000
кредитов в месяц на тарифе Pro
Посмотреть цены на кредиты

Справочник

Часто задаваемые вопросы

Бесплатен ли SpeakNotes API?
Каждый аккаунт получает 60 кредитов в месяц бесплатно, а ключи песочницы бесплатны и безлимитны навсегда. Аккаунты Pro получают 2000 кредитов в месяц. Сверх ежемесячного лимита вы можете приобрести пакеты предоплаченных кредитов.
Как получить API-ключ SpeakNotes?
Войдите в систему и откройте «Настройки», затем «API-ключи». Вы создаете ключ самостоятельно, и он начинает работать мгновенно. Процесс подачи заявки или контактные формы отсутствуют.
Есть ли у SpeakNotes среда песочницы?
Да. Любой ключ, созданный с опцией sandbox, начинается с sn_test_. Он позволяет протестировать все маршруты и возвращает фиксированные, реалистичные выходные данные, не обращаясь к модели, не расходуя кредиты и не записывая данные в ваши реальные заметки.
Как подключить SpeakNotes к Claude или другому MCP-клиенту?
Укажите клиенту адрес https://api.speaknotes.io/mcp через Streamable HTTP. Клиенты, поддерживающие OAuth, регистрируются самостоятельно и запрашивают авторизацию; клиенты, которые этого не делают, могут отправлять API-ключ SpeakNotes в качестве токена bearer.
Поддерживает ли API SpeakNotes OAuth?
Да. SpeakNotes использует сервер авторизации OAuth 2.1 с поддержкой PKCE, ротацией токенов обновления, динамической регистрацией клиентов и отзывом токенов. Метаданные опубликованы по адресу https://speaknotes.io/.well-known/oauth-authorization-server.
Каковы лимиты запросов API SpeakNotes?
120 запросов на чтение, 30 запросов на запись и 10 запросов на обработку в минуту для каждой учетной записи. Каждый ответ содержит информацию об оставшемся лимите в заголовках, а код 429 точно указывает, сколько времени нужно подождать.