Большинство современных мессенджеров предоставляют своим пользователям API, предназначенные для различных задач. На примере Telegram посмотрим, как работать с API, что они умеют и чем могут быть полезны.
Если вы не зарегистрированы в Telegram — самое время зарегистрироваться. Вы можете не пользоваться аккаунтом в повседневности, но для учёбы он необходим. Возможно, вам будет удобно работать через десктопную версию приложения, её можно скачать с официального сайта: https://telegram.org/.
API в Telegram
У мессенджера Telegram есть два API — Bot API и Client API.
- Bot API предназначен для работы с ботами.
- Client API позволяет управлять вашим аккаунтом: отправлять от вашего имени сообщения, вступать в группы или изменять информацию в своём профиле.
Начнём с Client API.
Управление аккаунтом через Client API
Для работы с Client API необходима аутентификация по токену, получить его можно на специальном сайте Telegram.
Получение токена для Client API
Зайдите на https://my.telegram.org и введите номер телефона, привязанный к вашему аккаунту:
How to Get API Id API Hash Of a Telegram Account #Tg #for_beginners #Easy
Запустите Telegram: вам придёт код подтверждения для сайта, введите его в поле на сайте и нажмите кнопку Next.
В открывшемся окне нажмите на ссылку API development tools и введите данные для создания нового приложения. Заполните как минимум поля App title, Short name и укажите платформу: Web.
В следующем окне скопируйте и сохраните значения api_id и api_hash.
Готово! Эти идентификаторы вы перенесёте в код, они будут передаваться в Client API с каждым вашим запросом — и Client API опознает вас как владельца определённого аккаунта.
Программный клиент Telegram
Отправлять запросы к Client API можно через ваш Telegram-клиент на телефоне или на компьютере или через программный клиент.
Для работы с Client API существует несколько популярных Python-библиотек, которые эмулируют работу приложения. С чем-то подобным вы сталкивались в теме «Тестирование Django»: класс Client() в тестах эмулировал работу браузера, отправляя запросы и получая ответы от сервера.
Для создания программного клиента возьмём библиотеку pyrogram.
Создайте директорию /client_api, перейдите в неё, установите и активируйте виртуальное окружение, установите библиотеку pyrogram :
mkdir client_api # Создаём директорию cd client_api # Переходим в эту директорию python3 -m venv venv # Создаём виртуальное окружение . venv/bin/activate # Активируем виртуальное окружение # Для Windows команда source venv/Scripts/activate pip3 install pyrogram # Устанавливаем библиотеку
Создайте и откройте файл /client_api/main.py в текстовом редакторе, перенесите в него код:
from pyrogram import Client api_id = api_hash = «» with Client(«my_account», api_id, api_hash) as app: # Первый параметр метода send_message — id (int) или имя (str) того пользователя, # которому будет отправлено сообщение. # Зарезервированное слово «me» означает ваш собственный аккаунт. app.send_message(«me», «Привет, это я!»)
Сохраните файл и запустите его:
python3 main.py
При первом запуске программы в командной строке будет запрошен номер телефона, на который зарегистрирован ваш Telegram-аккаунт. Введите номер в консоль, после этого на телефон или в Telegram придёт проверочный код. Скопируйте этот код и вставьте в командную строку. Эта процедура выполняется только один раз, после этого приложение будет зарегистрировано.
Из вашего приложения будет отправлено сообщение. «me» — это зарезервированное слово, заменяющее ID аккаунта, для которого выдан токен. Следовательно, сообщение будет отправлено из вашего аккаунта в ваш аккаунт; оно отобразится во вкладке «Избранное» в вашем мессенджере.
Если изменить «me» на ID аккаунта вашего друга в Telegram, то сообщение уйдёт ему.
Начните диалог с ботом: нажмите кнопку Start.
Для начала бот отправит вам информацию о вашем аккаунте: ID, имя (то, что указано в полях First и Last name) и язык.
Если Telegram запущен на мобильном устройстве — вызовите меню долгим нажатием на сообщение и проделайте всё то же самое.
В ответ бот отправит информацию о пользователе: ID, имя (First name) и фамилию (Last name).
Список всех доступных методов библиотеки pyrogram доступен в документации.
Не увлекайтесь рассылкой сообщений через бота: в Client API есть лимит по количеству запросов. Если вы будете слишком часто отправлять сообщения, Telegram может принять вас за злоумышленника-спамера и забанить, лишить доступа к сервису. Telegram не раскрывает точных ограничений.
В первый раз блокировка продлится 24 часа, последующие будут длиться дольше. Во избежание блокировок мы бы предложили отправлять сообщения только на аккаунты из вашего контакт-листа и не отправлять суммарно более десяти сообщений в час.
Похожие записи:
- Бот в Telegram
- Библиотека python-telegram-bot
- Инструментарий для тестирования API
- Unittest в Django: тестирование URLs
Источник: mob25.com
Начиная
Вам придется посетить https://my.telegram.org/ войдите под своим номером телефона и кодом подтверждения, который будет отправлен в Telegram, и заполните форму в разделе «Инструменты разработки API», указав название приложения и короткое имя. После этого вы можете найти свой api_id а также api_hash в том же месте.
Кроме того, в тех же инструкциях упоминается, что вы можете использовать образцы учетных данных, которые можно найти в исходных кодах Telegram для тестирования. Для удобства я буду использовать учетные данные, которые я нашел в Исходный код Telegram Desktop на GitHub в примере кода здесь.
Установка Telethon
Как получить API-ключ в ChatGPT
API-ключ от ChatGPT понадобится всем разработчикам, кто хочет интегрировать бота в сторонние продукты. Вместе с этим он может пригодиться и обычным пользователям, которые желают расширить функциональность веб-сервисов или программ, поддерживающих добавление различных API. По умолчанию API-ключ отсутствует, поэтому для каждой учетной записи он должен быть создан отдельно. Вместе с этим поддерживается генерирование на один аккаунт нескольких API, что позволяет использовать каждый в разных целях.
Обратите внимание на то, что хотя API-ключ можно создать, скопировать и подключить к инструментам бесплатно, для его работы обязательно понадобится выбрать один из тарифных планов ChatGPT, а также определиться с моделью нейросети, поскольку стоимость сгенерированных символов в каждой из них отличается.
Выбор модели и просмотр конечной точки API
Первая краткая инструкция предназначена непосредственно для разработчиков, которых интересует не просто интеграция возможностей ChatGPT, но и выбор необходимой модели, ее тестирование, а также получение сведений о конечной точке API. Для этого OpenAI на свой платформе предоставляет развернутую документацию, доступ к которой можно получить следующим образом:
- Щелкните по названию OpenAI в предыдущем абзаце, чтобы перейти на официальную страницу сайта. На ней перейдите к авторизации в личном кабинете, если это еще не было сделано ранее.
- Выберите удобный метод входа и подтвердите его точно так же, как проводите авторизацию на всех остальных сайтах.
- На главной вас интересует плитка «API», по которой нужно нажать для перехода к просмотру информации по этой теме.
- На странице платформы вы получаете сведения о том, как создавать приложения с использованием базы OpenAI. В данном случае понадобится щелкнуть по «GPT», чтобы перейти к просмотру информации по искусственному интеллекту для генерирования текста.
- Вы сразу получаете таблицу с актуальными версиями моделей и ссылками на конечные точки API. Можете переходить по ним для ознакомления с исходным кодом.
На этой же странице вы видите еще больше информации о том, как вызывать различные функции, управлять токенами и работать с API. Есть даже ссылка на песочницу, где вы можете проверить работу каждой из моделей и выбрать подходящую конкретно для своего веб-сервиса или приложения.
Комьюнити теперь в Телеграм
Подпишитесь и будьте в курсе последних IT-новостей
Получение API-ключа ChatGPT
Обычному пользователю представленная выше информация вряд ли покажется интересной и полезной, поскольку его интересует получение своего API-ключа с дальнейшим подключением ChatGPT к уже готовым решениям в виде браузерных расширений или аддонов для разных программ. Ниже вы увидите последовательность действий, которую нужно выполнить для генерирования этого ключа в своей учетной записи.
- Выполните первые два шага из предыдущей инструкции, чтобы авторизоваться в своем профиле на OpenAI. После этого нажмите по значку со своей аватаркой на верхней панели и из появившегося списка выберите пункт «View API keys».
- Как вы уже знаете, по умолчанию ни один ключ для вашей учетной записи создан не будет, поэтому понадобится использовать кнопку «Create new secret key».
- Введите название для него, чтобы в будущем ориентироваться, к какому приложению он был подключен. Затем подтвердите создание нового ключа.
- Понадобится пройти капчу, чтобы этот процесс был завершен.
- Вы получили этот самый ключ, скопируйте его и сохраните в надежном месте. Увидеть его полностью больше нельзя, поэтому это единственный ваш шанс сохранить ключ.
- Теперь вы увидите список из созданных ключей, их название, дату создания и время использования. Ключ можно удалить или изменить его название.
- Ниже есть список выбора организации использования ключей, что нужно только в том случае, если вы работаете с ChatGPT коллективно и имеете корпоративный аккаунт.
Не передавайте полученный секретный ключ третьим лицам, поскольку они могут сами подключить его к любому приложению и при наличии подписки начать использование. Соответственно, вы только будете терять деньги каждый раз, как другие люди будут обращаться к вашему API-ключу, а ChatGPT будет генерировать новые символы.
Просмотр прайса на языковые модели
Если вы собираетесь работать с API-ключом, то наверняка уже знаете, что бесплатно с его помощью не получится задать запрос для ЧатГПТ и получить ответ. Для этого необходимо выбрать одну из языковых моделей, подключить платежное средство и оформить подписку. Каждая модель имеет свои расценки на 1к вводимых и выдаваемых токенов, которые время от времени будут меняться. Поэтому рекомендуется заранее определиться с подходящим планом и после этого переходить к его покупке и использованию API.
- Снова вызовите меню учетной записи и из него выберите раздел «Pricing».
- Прокрутите таблицу с расценками до нужной вам версии и сравните цены на ее модели для ввода и вывода токенов.
- Дополнительно возле каждой версии GPT присутствует ссылка на развернутую документацию, чтобы вы понимали, какие преимущества имеются, как давно обновилась база данных и насколько возросла скорость обработки запросов.
Здесь же, на странице с расценками, вы найдете ответы на самые частые вопросы и узнаете, как измеряются токены, как управлять платежами и какую модель нейросети выбрать для конкретных задач.
Теперь у вас есть комплексное представление о том, как получить информацию о конечных точках API, сгенерировать секретный ключ и ознакомиться с тарифными планами по каждой модели. Остается только оформить платеж, подключить API и приступить к тестированию нейросети в выбранном или создаваемом веб-приложении.
Источник: timeweb.com