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

Ключи

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

Баланс

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

Rate limits

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

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

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

Для редактирования используйте POST /v1/images/edits и multipart/form-data: model=gpt-image-2.5-sunburst, prompt и файл image. Можно передать до 16 image[]; один файл — до 25 MiB, весь запрос — до 64 MiB. Необязательная mask — PNG с прозрачностью до 4 MiB, размером как первое изображение. Поддерживаются n=1, size=auto и output_format=png; тариф совпадает с созданием изображения. stream=true доступен только при настроенном маршруте с проверенным native streaming.

Ошибки

Основные ошибки: 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 и подходит для обращения в поддержку. Внутренние идентификаторы маршрута и поставщика наружу не передаются.

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

Поддержка

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