Вопросы о Partner API

Чем ключ API аккаунта отличается от ключа Model API?

Ключ уровня аккаунта (mg_partner_...) управляет ключами Model API через https://p-api.model-gate.com/api/v1/partner/* и получает асинхронные результаты через https://p-api.model-gate.com/api/v1/requests/{request_public_id}.

Ключ Model API (mg_live_...) аутентифицирует запросы инференса через https://api.model-gate.com.

Никогда не отправляйте ключ уровня аккаунта Partner API в эндпоинт инференса и не раскрывайте его в клиентских приложениях.

Какой счётчик обеспечивает spend_limit?

Ограничение обеспечивается обнуляемым счётчиком usage. POST /api/v1/partner/keys/{key_public_id}/reset-usage очищает счётчик ключа. total_spent отражает учёт за весь период и никогда не сбрасывается.

У каждого ключа Model API отдельный баланс?

Нет. Все ключи Model API расходуют баланс своего аккаунта Model Gate. Лимиты ключа и группы ограничивают использование, не разделяя баланс аккаунта на дочерние балансы.

Что происходит при перевыпуске ключа Model API?

Старый секрет немедленно перестаёт работать. Ответ перевыпуска один раз содержит новый секрет в открытом виде. Сохраните его безопасно: Model Gate не показывает полный секрет повторно.

Как настроить обратные вызовы?

Настройте callback_url и обновите callback_secret в профиле Model Gate. Результаты завершения асинхронных запросов отправляются при наличии URL. Необязательные события низкого остатка лимита ключа, лимита Key Group и баланса аккаунта включаются отдельно; их пороги задаются в уведомлениях Profile.

Доставка обратных вызовов устойчива к сбоям и независима от обработки инференса. Каждое событие содержит стабильный event_id, неизменный при повторах; получатель должен использовать его для устранения дублей. Любой HTTP 2xx считается успехом. Всего выполняется не более 6 попыток, с повторами через 5 секунд, 30 секунд, 2 минуты, 10 минут и 1 час; общий тайм-аут попытки — 15 секунд. Транспортные ошибки, тайм-ауты и ответы вне 2xx повторяются; после шестой неуспешной попытки событие получает failed без дальнейшего автоматического повтора. См. Обратные вызовы для каталога событий, точных десятичных данных, подписей, безопасности назначения и подробностей доставки.

Как долго доступен async-результат?

Асинхронный результат доступен 24 часа через GET https://p-api.model-gate.com/api/v1/requests/{request_public_id}. После истечения срока сохранённые запрос и ответ удаляются, эндпоинт возвращает 404.

Поддерживают ли изменения Partner безопасный повтор?

Да. Каждый POST, PATCH и DELETE Partner API требует Idempotency-Key. После тайм-аута повторяйте ту же логическую операцию с тем же ключом; в течение 7 дней Model Gate возвращает исходный результат без повторного изменения. Использование ключа для другого запроса возвращает 409.

Как долго доступна подробная история запросов?

Подробная история Partner следует API_REQUESTS_HOT_RETENTION_DAYS (по умолчанию 7 дней) и сообщает окно в метаданных ответа. Для более длительной финансовой сверки используйте транзакции баланса с курсорной навигацией.

Отдельные результаты Images

Изображения не являются результатами нативного async в Partner API. Читайте /v1/images/operations и закрытые выходные изображения через Model API с теми же разрешёнными ключом и исполнителем. Partner-токен и другой ключ того же аккаунта не предоставляют автоматический доступ к этим файлам.