EasyTokens API

Один API · больше возможностей

Текст, изображения, голос.
ИИ для вашего продукта.

Создавайте контент, разбирайте фотографии, превращайте речь в текст и подключайте инструменты — с одним ключом EasyTokens.

Получить API-ключПосмотреть примеры ↓

OpenAI-совместимые запросы · единый баланс · потоковые ответы для генерации

От задачи к интеграции

Что вы хотите поручить ИИ?

Выберите сценарий. Каждый пример ниже показывает запрос, с которого можно начать.

01 / TEXT

Создавать и объяснять

Описания товаров, ответы клиентам, сводки и структурированный текст. Настраивайте глубину размышления под задачу.

Текст и диалог
Посмотреть запрос ↗
02 / VISION

Понимать изображения

Передайте фото, скриншот или документ вместе с вопросом. Модель проанализирует детали и поможет извлечь текст.

JPEG · PNG · WebP
Посмотреть запрос ↗
03 / AUDIO

Превращать речь в текст

Расшифровывайте русскую речь из звонков, интервью и голосовых сообщений.

MP3 · WAV · Ogg · WebM
Посмотреть запрос ↗
04 / WEB

Находить свежую информацию

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

Поиск и чтение страниц
Посмотреть запрос ↗
05 / SERVER TOOLS

Доверять выбор инструменту

Попросите выбрать случайный вариант: random_choice выполняется на сервере. Можно выбрать несколько позиций без повторения.

Встроенный random_choice
Посмотреть запрос ↗
06 / FUNCTION CALLING

Подключать свои функции

Опишите функции вашего приложения через tools. Модель предложит вызов, а ваше приложение выполнит его и вернёт результат.

Ваши функции · ваш контроль
Как подключить функции ↗

Быстрый старт

Одна задача — один пример

Замените YOUR_API_KEY своим ключом. Отправляйте запросы с сервера вашего приложения, чтобы ключ оставался закрытым.

Текст

cURL / JSON 
curl https://api.easytokens.ru/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "easylite",
  "think": "off",
  "messages": [
    {
      "role": "user",
      "content": "Напиши короткое SEO-описание товара"
    }
  ]
}'

Начните с обычного сообщения. Параметр think необязателен: без него используется настройка API-токена, по умолчанию off.

Изображения

cURL / JSON 
curl https://api.easytokens.ru/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Опиши товар на фото: цвет, материал и детали."
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "data:image/jpeg;base64,BASE64_IMAGE"
          }
        }
      ]
    }
  ]
}'

Замените BASE64_IMAGE на base64 вашего JPEG. Здесь используется модель аккаунта по умолчанию: у неё должна быть capabilities.vision = true. Доступные модели — в GET /v1/models.

Аудио

cURL / multipart/form-data 
curl https://api.easytokens.ru/v1/audio/transcriptions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@recording.mp3" \
  -F "response_format=json"

Замените recording.mp3 на путь к записи. В ответе поле text содержит распознанную речь. Файл передаётся напрямую: преобразовывать его в base64 не нужно.

Веб-поиск

cURL / JSON 
curl https://api.easytokens.ru/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "easylite",
  "messages": [
    {
      "role": "user",
      "content": "Найди свежие новости о космических миссиях и укажи источники."
    }
  ],
  "web": {
    "enabled": "always",
    "mode": "grounded",
    "return_sources": true
  }
}'

Включите web, когда ответу нужны внешние источники. Можно искать в интернете или читать заданные публичные страницы.

Инструменты

cURL / JSON 
curl https://api.easytokens.ru/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "easypro",
  "server_tool": {
    "name": "random_choice",
    "arguments": {
      "items": [
        "Анна",
        "Иван",
        "Мария"
      ],
      "count": 1
    }
  },
  "stream": false
}'

Прямой вызов random_choice выбирает вариант системным генератором случайных чисел без обращения к модели. Результат приходит в обычном message.content.

Управляйте качеством и расходами

Глубина размышления

Параметр think задаёт режим размышления для поддерживающих его моделей. Начните с off для простых задач; более глубокие режимы могут увеличить время ответа и расход.

think: offthink: autothink: lowthink: mediumthink: high

Модели и баланс под рукой

Проверьте доступные модели и поддержку изображений перед интеграцией. Баланс и списания зависят от модели и вида запроса. 

curl https://api.easytokens.ru/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

curl https://api.easytokens.ru/v1/balance \
  -H "Authorization: Bearer YOUR_API_KEY"

Детали перед подключением

Какие изображения можно отправлять?

JPEG, PNG и WebP: до 10 изображений в запросе, до 12 MiB на изображение, 24 MiB суммарно и 25 мегапикселей на изображение. Передавайте base64 data URL или доступный модели публичный URL. Выберите модель с capabilities.vision = true в GET /v1/models. Анализ изображений оплачивается по тарифу выбранной модели.

Это анализ входных изображений. Примеры на этой странице не создают и не редактируют картинки.

Что поддерживает распознавание аудио?

Записи до 64 MB и 60 минут. Отправьте файл через multipart/form-data и получите json, text или verbose_json. Пример рассчитан на русскую речь. Потоковая транскрибация и разделение по говорящим пока не поддерживаются. Стоимость зависит от длительности записи и настроенного тарифа, включая минимальное списание.

Чем встроенные инструменты отличаются от tools?

Встроенный random_choice выполняет EasyTokens: вы передаёте варианты и получаете выбор. Прямой вызов через server_tool работает без генерации моделью. В обычном диалоге сервер также может распознать просьбу о случайном выборе автоматически.

Клиентские tools — описания функций вашего приложения. Модель возвращает tool_calls, приложение проверяет аргументы и права, выполняет действие и отправляет результат сообщением с ролью tool. Для этого нужна модель с поддержкой function calling. Явные серверные и клиентские инструменты нельзя объединять в одном запросе.

Как подключить существующий OpenAI-совместимый клиент?

Используйте базовый URL https://api.easytokens.ru/v1/generate/v1 и ключ EasyTokens для chat completions. Укажите доступный вашему аккаунту идентификатор модели из GET /v1/models. Для обычных HTTP-запросов начните с примеров выше.

Начните с первого запроса

Получите ключ, выберите сценарий и подключите ИИ к своему продукту.

Получить API-ключ ↗