Правила использования API

Ключи

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

Баланс

Перед дорогими запросами сервис резервирует прогнозную стоимость. После ответа модели выполняется финальный расчет и возвращается неиспользованная часть резерва.

Rate limits

Лимиты применяются по API-ключу, пользователю, IP, модели и endpoint. При превышении вернется ошибка rate_limit_exceeded.

Генерация изображений

Для создания нового изображения отправьте POST-запрос на https://tooken.club/v1/images/generations с моделью gpt-image-2, Bearer-ключом tc_live_... и текстовым prompt. Ответ содержит PNG в base64-поле data[0].b64_json. Сохраните декодированные байты как PNG или покажите через data:image/png;base64,... . image_url у Vision-моделей выполняет другую задачу: передаёт существующее изображение модели на вход и не создаёт новое.

Ошибки

Основные ошибки: invalid_api_key, insufficient_quota, model_not_found, rate_limit_exceeded, upstream_error и upstream_timeout. Поле origin показывает источник: local, provider, capacity, billing или client.

X-Request-ID относится к запросу Tooken Club. Для ошибки ModelHub дополнительно возвращаются upstream_request_id и provider_error_code, если провайдер их передал.

Локальная оценка размера контекста показывается только как предупреждение. Окончательное решение о context_length_exceeded принимает выбранная модель у провайдера.

Поддержка

Если запрос не проходит, отправьте request id, модель, endpoint и пример времени в поддержку: https://t.me/tookenclub_boss.