Диагностика и восстановление
Разбирайте неопределённый результат отправки, конфликты цены, загрузки и прерванные потоки.
Сохраните данные для диагностики
Запишите время, эндпоинт, HTTP-статус, код приложения, request_id и полученный taskId. Различайте явный отказ, отсутствие сетевого ответа и сбой после принятия. Не добавляйте ключи API, полные промпты и исходные файлы в общие журналы или обращения.
Модель отсутствует или недоступна
Обновите авторизованный каталог и проверьте enabled, available и точный ID модели задачи. Публичная страница не подтверждает доступ аккаунта. При постоянном 50301 проверьте доступность и ограничьте повторы: они не открывают доступ к модели.
Некорректные входные данные или конфликт цены
При 400 сверяйте типы, допустимые значения и условно обязательные поля с текущей inputSchema; удаляйте неподдерживаемые параметры. При 40901 запросите и подтвердите новую цену: изменились ввод, срок или стоимость. Обычный 409 зависит от операции. Ключ, связанный с другим запросом, требует исправить связь бизнес-операции.
Тайм-аут без ID задачи
Сохраните исходный запрос и Idempotency-Key. Повторно отправьте исходный запрос в пределах срока действия ключа, прежде чем создавать новую задачу. Получив taskId, прочитайте recordInfo. Тайм-аут клиента, закрытие вкладки и обрыв потока не отменяют принятые задачи; проверяйте state, cost и settled.
Файл загружен, но ввод отклонён
После PUT вызовите files/{fileId}/commit. Передайте полученный URI spicy:// в поддерживаемое поле модели, а не uploadUrl. Проверьте подписанный Content-Type, размер, формат, аккаунт и срок. Загрузки хранятся сутки; повтор задачи может потребовать новой загрузки и изменения ввода.
Нет callback или ссылка истекла
Проверьте HTTPS-приёмник, подпись по исходным байтам и быстрый успешный ответ. Восстановите состояние через recordInfo и исключите повторную обработку callback перед обработкой задачи. Пока результат хранится, можно запросить новую ссылку. Для pending повторите позже; unavailable или истёкший результат не восстановить обновлением старой ссылки.
Поток закончился раньше времени
До разбора SSE проверьте HTTP и Content-Type. Фрагменты TCP не являются полными событиями, закрытие соединения не подтверждает успех. Проверьте завершающие события, ошибки и сроки приложения. Не считайте обрыв гарантией возврата или бесплатного повтора; сохраните request_id и проверьте использование.
Баланс, лимиты и поддержка
Для 40201 проверьте доступный баланс, для 40202 — лимиты расходов аккаунта и ключа. При 429 соблюдайте Retry-After и снижайте частоту. Не передавайте ключи поддержке. Укажите шаги, время, ID запросов, структуру полей без секретов, ожидаемый и фактический результат.
Связанные руководства
Ошибки и повторы · Идемпотентность · Загрузка медиа и результатов · Текст и потоковые ответы