Регламент использования Corporate API

Документ относится только к корпоративному контуру на сайте corp.aitale.ru.

1. Авторизация и безопасность

Запросы подписываются ключом sk_corp_… в заголовке Bearer. Ключ показывается один раз. Заказчик не включает ключи в клиентский JavaScript, публичные репозитории, URL и логи, применяет секрет-хранилище и незамедлительно отзывает скомпрометированные ключи.

2. Файлы

Референсы передаются только методом multipart upload. Допустимы JPG, PNG и WEBP до 8 МиБ каждый; до пяти файлов на генерацию. Inline base64 и внешние URL не принимаются. MIME проверяется по содержимому. Upload действует 12 часов и затем удаляется; активное задание может временно задержать очистку до безопасного завершения.

3. Асинхронный цикл

Клиент загружает файлы, создает задание с обязательным Idempotency-Key, получает 202 и опрашивает URL из Location. Статусы: queued, processing, succeeded, failed, capacity_timeout, expired. Интервал polling — не чаще значения Retry-After.

Если сервис генерации недоступен, создание возвращает 503 service_unavailable без постановки в очередь и списания. При временной нехватке вычислительной мощности задание ожидает начала обработки до 60 секунд. Если обработка не началась, оно завершается с кодом capacity_timeout. После перехода в статус processing 60-секундный предел не применяется.

4. Отказоустойчивость клиента

Заказчик обязан обрабатывать сетевые ошибки, 429, 5xx, терминальные статусы и недоступность результата; использовать уникальные ключи идемпотентности; ограничивать суммарное время ожидания; сохранять результаты; иметь независимый fallback. Автоматический fallback Оператора на иной AI-провайдер отсутствует.

5. Ограничения и изменение API

Оператор вправе вводить rate limits, ограничения параллелизма, блокировать вредоносные запросы и аварийно менять поведение для защиты системы. Для плановых несовместимых изменений Оператор стремится использовать новую версию и уведомление, однако не гарантирует срок предупреждения при угрозе безопасности, изменении закона или внешнего сервиса.

6. Результаты и тарификация

Качество 1K/2K/4K передается модели как инструкция и выбор доступной настройки интерфейса; точное количество пикселей не гарантируется. Результат хранится 12 часов. Стоимость резервируется при принятии задания, окончательно списывается только при успехе и освобождается при технической ошибке, отказе контента или capacity timeout.

Реквизиты Оператора

ИП Ярославцев Владислав Александрович
ИНН: 613304590712
ОГРНИП: 326619600051171
Email: contact@aitale.ru