Руководство
Биллинг и счета
Способы тарификации, момент расчёта, проверка баланса и сверка расходов
Биллинг и счета
Баланс, тарифы, расходы и счета LocoPal сосредоточены в аккаунте LocoPal Ai. Creation не тарифицируется отдельно — его расход учитывается в том же аккаунте.
Способы тарификации
Разные модели тарифицируются по-разному; точные данные указаны на странице подробностей в каталоге моделей.
| Способ тарификации | Значение | Где встречается |
|---|---|---|
| По Token | Входные и выходные Token тарифицируются отдельно, единица отображается как 1K или 1M Token | Текстовые диалоги, мультимодальное понимание |
| Кэшируемый ввод / запись в кэш | Отображается только для моделей с поддержкой кэширования промптов | Текстовые модели с поддержкой кэша |
| За вызов | Каждый успешный запрос тарифицируется по фиксированной цене | Некоторые модели изображений |
| По объёму / по длительности | Тарификация по разрешению, длительности или единице измерения, определённой моделью | Видео, аудио |
Для видеомоделей (например, doubao-seedance, серии seedance) отображается отдельная матрица цен,
разбитая по признакам «с видео на входе» и «выходное разрешение». При чтении сначала определите, передаётся
ли в этот раз видео на входе, затем выберите нужное разрешение:
- загружается только текст или референсное изображение → смотрите столбец «Без видео на входе»;
- видео передаётся на вход → смотрите столбец «С видео на входе»;
- неподдерживаемые комбинации явно помечены «Не поддерживается»; не угадывайте отсутствующие тарифы по соседним.
Момент расчёта
Это наиболее частая причина недоразумений — различайте синхронные интерфейсы и асинхронные задачи.
| Тип | Способ расчёта |
|---|---|
| Синхронный вызов (текст, изображения, аудио) | Использование учитывается после успешного ответа на запрос |
| Асинхронная задача (видео) | Расчёт при завершении: отправка только принимает задачу и не списывает средства заранее; после завершения задачи в счёте появляется запись о фактическом списании |
Ключевые особенности асинхронных задач:
- перед отправкой платформа проверяет, покрывают ли баланс аккаунта (или квота текущего Key) предварительную оценку расхода; при недостатке сразу возвращается читаемое сообщение, и задача не создаётся;
- во время выполнения задачи промежуточных списаний не происходит;
- запрос статуса задачи не создаёт расходов — тарифицируется только создание задачи;
- тарификация неудачных задач определяется настройками цен этой модели и платформы.
Баланс и проверка
- перед вызовом платформа проверяет, покрывает ли баланс предварительную оценку расхода; при недостатке возвращается сообщение вместо создания задачи;
- для текстовых моделей оценка рассчитывается по длине ввода, фактический расход определяется полем
usageв ответе; - изображения и видео тарифицируются за вызов или по длительности; оценка и факт обычно совпадают в пределах поддержки модели;
- рекомендуется на бэкенде выполнять предварительную проверку и показывать понятное сообщение при недостатке баланса, а не полагаться полностью на ошибку, возвращаемую платформой.
Где проверять
| Что хотите увидеть | Куда перейти |
|---|---|
| Баланс, пополнение, тарифы, заказы | «Кошелёк» в консоли LocoPal Ai |
| Детализация каждого синхронного вызова (модель, Token, расходы) | «Журнал использования» |
| Статус, прогресс и артефакты асинхронных задач | «Журнал задач» |
| Цены моделей и способы тарификации | «Каталог моделей» |
Кошелёк предназначен для пополнения, тарифов и обмена привилегий; каталог моделей показывает ориентировочные цены; счёт фиксирует окончательный расчёт. Их назначение различается, и отображаемая цена не равна окончательному списанию.
Сверка некорректных списаний
Действуйте в следующем порядке, а не полагайтесь на интуицию:
- Определите временной диапазон: сначала сузьте его до периода, в котором возникла проблема;
- Найдите идентификатор задачи или запроса: для асинхронной задачи — ID задачи, для синхронного вызова — ID запроса;
- Определите модель: по ID модели (а не отображаемому названию) установите, какой моделью создана запись;
- Сверьте использование и цену за единицу: для текста сравните входные и выходные Token в
usage; для видео — разрешение, длительность и тип входа; - Проверьте повторные отправки: наиболее частая причина аномалий в асинхронных задачах — лишнее создание задачи, а не ошибка цены.
После выполнения указанных шагов обратитесь в поддержку платформы и предоставьте эти сведения. Не предоставляйте полный ключ.
Контроль расходов
- Разделяйте Key по приложениям: создавайте отдельные Key для рабочего сервиса, тестовой среды и клиентских приложений — так проще определить источник расходов;
- Устанавливайте для Key квоту и срок действия: это ограничивает последствия аномального расхода;
- Выбирайте подходящую модель: для той же задачи меньшая модель часто значительно снижает затраты;
- Избегайте повторных отправок: сохраняйте ID асинхронной задачи и отслеживайте прогресс запросами, а не повторным созданием;
- Своевременно сохраняйте результаты: возвращаемые адреса изображений и видео могут быть временными, после истечения срока их придётся генерировать заново.
Частые заблуждения
| Заблуждение | Факт |
|---|---|
| «При отправке видеозадачи средства списываются» | Асинхронные задачи рассчитываются при завершении; отправка не списывает средства заранее |
| «Постоянные запросы приводят к повторному списанию» | Запросы не создают расходов; повторное создание — создаёт |
| «Цена на карточке — окончательная» | Карточка служит для оценки, окончательный расчёт — по счёту |
| «Creation требует отдельного пополнения» | Обе платформы используют квоту одного аккаунта |
| «Ошибка 400 тоже списывает средства» | Ошибка валидации параметров обычно не создаёт расходов за задачу генерации |
| «При смене модели нужно заново загружать материалы» | Материал нужно добавить в библиотеку один раз; один и тот же ID материала можно использовать в разных моделях |
