Путь данных запроса
- Приложение отправляет API-ключ и запрос на HTTPS-адрес
https://rockapi.ai/v1. Выполняйте вызов на сервере; настройка описана в разделе Аутентификация. - Шлюз проверяет ключ и аккаунт, применяет настроенные ограничения и выбирает внешний канал. В зависимости от интерфейса и канала он может сопоставлять имена моделей, преобразовывать формат, переопределять параметры или передавать тело запроса напрямую.
- Внешний сервис получает данные, необходимые модели: сообщения, входные данные инструментов, переданные медиафайлы или ссылки на них. Шлюз обрабатывает ответ и сведения об использовании, затем возвращает результат клиенту.
- Записи об использовании и ошибках служат для расчётов и диагностики. Асинхронные медиазадачи также могут сохранять входные данные, состояние, данные поставщика и URL результатов. Их записи отличаются от журналов текстовых запросов.
Защита и отзыв API-ключей
Создавайте отдельные API-ключи для каждого приложения и окружения. Если редактор ключа предоставляет соответствующие настройки, задайте срок действия, конечную квоту, разрешённые модели и список разрешённых IP-адресов. Перед передачей запроса модели реализация проверяет состояние ключа, срок действия, доступную квоту и настроенные IP-ограничения; ограничения моделей сужают маршрутизацию. Проверяйте список IP с реального внешнего адреса вашего приложения. Храните ключи в серверном хранилище секретов или защищённой конфигурации выполнения. Не включайте их в браузерные сборки, мобильные приложения, репозитории, URL, снимки экрана и общие трассировки. Предпочитайте документированный заголовок аутентификации параметрам строки запроса. В ответах со списком и подробностями ключ маскируется, а отдельная аутентифицированная операция позволяет получить полное значение. Маскирование защищает отображение; оно не доказывает использование необратимого хеширования или шифрования при хранении. Для плановой ротации создайте новый ключ, обновите приложение, проверьте вызов, затем отключите или удалите старый. При утечке сначала отключите или удалите скомпрометированный ключ, замените его и проверьте журналы на необычные вызовы. Убедитесь, что старый ключ отклоняется; если он ещё работает, обратитесь в поддержку. Отзыв ключа не удаляет исторические записи.Что может содержаться в журналах
Журналирование расхода и агрегация использования настраиваются. Из пользовательских представлений удаляется часть административных сведений, поэтому панель не показывает все сохраняемые поля. Отключение одной категории или настройки IP не отключает все журналы доступа, безопасности, задач и инфраструктуры. Для сверки расхода см. Цены и биллинг.
Минимизируйте передаваемые данные
Отправляйте только нужные для задачи сообщения, фрагменты документов, результаты инструментов и медиафайлы. Удаляйте пароли, токены доступа, платёжные данные и не относящиеся к задаче персональные сведения. Заменяйте данные, позволяющие установить личность клиента, внутренними псевдонимами, а таблицу соответствий храните у себя. Проверяйте имена файлов, метаданные медиа, пользовательские заголовки и подписанные URL наряду с текстом запроса. Для проверки новой интеграции используйте вымышленные тестовые данные. Обращаясь в поддержку, сначала укажите идентификатор запроса или задачи, время с часовым поясом, ID модели, путь интерфейса, HTTP-статус и название ключа. При необходимости добавьте короткий обезличенный текст ошибки или минимальный пример воспроизведения. Не передавайте полный API-ключ, заголовок аутентификации, частную переписку или подписанный URL медиафайла без удаления секретных данных.Хранение, обучение и соответствие требованиям
Реализация подтверждает наличие механизмов обработки и журналирования. Она не устанавливает общую политику нулевого хранения, запрет использования для обучения или единый срок удаления для Rock API и всех внешних сервисов. Перед использованием конфиденциальных данных обратитесь в поддержку через страницу About основного сайта и уточните:- Хранение и доступ: какие тела запросов, ответы, файлы задач, журналы использования и доступа, резервные копии сохраняются? На какой срок, кто имеет доступ и какие есть исключения?
- Обучение и другие цели: используют ли Rock API или фактический внешний поставщик входные и выходные данные для обучения, оценки моделей, проверки злоупотреблений или других целей? Какие исключения или возможности отказа применимы к вашему аккаунту и маршруту?
- Поставщики и регионы: какие обработчики и регионы задействованы для выбранной модели, включая повторные попытки и резервные маршруты? Можно ли принудительно ограничить регионы обработки для вашей задачи?
- Договорные подтверждения: доступно ли соглашение об обработке данных (DPA)? Какие гарантии передачи данных, сертификаты безопасности и аудиторские отчёты относятся к приобретаемому сервису и в каких пределах?