Быстрый старт в API
Для работы с сервисом через API вам не требуется активация тарифа. Списание происходит с баланса пользователя согласно стоимости модели нейросети в API.
Некоторые модели могут быть временно недоступны в API. Вы получите соответствующую ошибку.
Генерация ключа
Работа с API осуществляется через API ключ на стороне клиента. Сгенерировать или обновить API ключ можно в настройках API.
Принцип работы
API работает на основе асинхронной пакетной генерации.
Принцип работы прост: отправка запроса и получение taskid → генерация (текст/изображение) в фоновом режиме → отправка запроса на получение результата.
При отправке запроса на /api/v2 вы получите task_id задачи, который нужно будет использовать для получения результата генерации.
Для получения результата генерации необходимо отправить второй запрос на /api/v2/status/YOUR_TASK_ID.
Стоимость генерации
Расчет стоимости при генерации текста: стоимость = ((кол-во токенов в запросе + кол-во токенов в ответе нейросети) / 1000) × цена за 1000 символов. Подробнее о формуле.
Расчет стоимости при генерации изображения: стоимость = кол-во сгенерированных изображений × цена за 1 изображение.
Внимание! Gemini, Grok, GigaChat являются мультимодальными, расчет стоимости при генерации изображений через них идет за токены.
Стоимость генераций через API для каждой нейросети отличается, узнать её можно узнать на стр. тарифы и цены.
Подробнее о доступых счетах и принципе списаний с них описано в разделе «Доступные счета».
Коды ответов
| Код | Описание |
|---|---|
| 200 | Успешный запрос |
| 400 | Неверный запрос. Ошибка в параметрах запроса |
| 401 | Не авторизован. Неверный или отсутствующий токен |
| 403 | Не авторизован. Доступ запрещен |
| 429 | Слишком много запросов. Клиент превысил лимит API |
| 500 | Внутренняя ошибка сервера |
Хранение результатов
Результат генерации хранится в течение 30 дней.
Ошибки и нестандартные ситуации
Если вы получили ошибку и она не описана в документации или не можете правильно составить запрос к API, пожалуйста, сообщите нам в тех. поддержку.
Наша команда обязательно разберет проблему и поможет решить любой вопрос.