Модели, маршруты и лимиты
Как находить действующий ID, проверять лимиты, стабильность и условия доступа в кабинете.
provider/example-model — только образец формата ID. Перед запуском любого запроса скопируйте действующий ID в каталоге моделей или через GET /api/v1/models. Цены, лимиты и доступность также проверяйте в кабинете.
ID маршрута и компания
В поле model передаётся полный ID вида провайдер/модель. Префикс обозначает маршрут к провайдеру, а не обязательно компанию разработчика. Поэтому одна модель может появиться несколько раз через разные маршруты; у каждого своя статистика. Полный список есть в кабинете и через GET /api/v1/models.
curl -sS https://api.ai.wiky.su/v1/models -H "Authorization: Bearer $WIO_API_KEY"Категории доступа
Каталог показывает категории доступа и условия выбранного маршрута. Они могут измениться без обновления этой страницы. Доступность платных маршрутов, пополнение и денежное списание проверяйте в кабинете. Один маршрут может отображаться в нескольких категориях.
Текущие правила начислений и списаний отображаются в кабинете; эта страница не фиксирует их значения.
Где смотреть актуальные условия
Цены и доступность маршрутов могут меняться. Откройте каталог моделей, выберите категорию доступа и нужный маршрут. Условия оплаты и баланс проверяйте в личном кабинете; числовые цены в эту документацию не копируются.
Цикл и статистика
Кабинет показывает оставшийся процент бесплатного лимита и время до обновления. Длительность цикла смотрите в кабинете. Расход учитывает входящие и исходящие токены с множителем выбранного маршрута. При исчерпании лимита API отвечает 429; правила доступа проверяйте в кабинете. За выбранный период доступны число запросов и статистика токенов.
Как читать процент
Показатель — доля успешных запросов среди учтённых успешных и неуспешных запросов за период, указанный в кабинете для конкретного маршрута. При малом числе запросов процент может резко меняться. Если маршрут нестабилен, выберите другой доступный маршрут из каталога.
Бесплатный и платный режимы
Откройте «API-ключи» в кабинете и нажмите «Настройки» у нужного ключа. Можно включить бесплатные модели, платные модели или оба режима. После включения платного доступа доступные этому ключу маршруты появятся в каталоге и ответе GET /api/v1/models. Для платного запроса нужен положительный баланс.
Если маршрут доступен в обоих режимах, настройте приоритет: сначала бесплатный лимит или сначала баланс. Когда ресурс с более высоким приоритетом заканчивается, запрос может использовать другой включённый режим. По желанию задайте суточный предел платных расходов для ключа.
Баланс пополняется промокодом на главной странице кабинета. Стоимость запроса резервируется до обращения к модели. После ответа списывается фактический или оценочный расход, а неиспользованный резерв освобождается. Для потока итоговая ошибка может прийти событием SSE после HTTP 200; обработанная часть учитывается в пределах резерва.
Диагностика ошибок