Устранение ошибок обработки файлов
Решения для неподдерживаемых форматов, недостижимого размера, истёкших файлов, ошибок квот и сбоев аутентификации API.
Обновлено
Найдите сообщение, которое вы на самом деле видели, прочитайте, что оно означает, и примените исправление. Угадывание причин неопределенного симптома тратит больше времени, чем что-либо еще на этой странице.
Проблемы с загруженным файлом
«Этот тип файла не поддерживается»
Обычная причина - файл, чье имя лжет о его содержимом - изображение WebP или HEIC, переименованное в .jpg загрузчиком или приложением для чата.
Откройте оригинал в созданном им приложении и экспортируйте поддерживаемый формат. Переименование никогда не поможет: расширение - это метка, а декодер читает байты. Если вы не уверены, что у вас действительно есть, запустите Проверить изображения и проверьте сообщенный формат. Защищенные паролем документы - это отдельный случай — см. раздел PDF ниже, так как зашифрованный файл отклоняется, а не просто не поддерживается.
«Результат больше, чем ваша цель»
Работа завершена, но выход не достиг байтового потолка. Проработать их в порядке:
- ** Проверьте, достижима ли цель.** Некоторые файлы не могут быть сжаты ниже порога без уничтожения контента. Сравните свой результат с целью: сканирование 5 MB никогда не достигнет байтов 200,000, не став нечитаемым.
- ** Проверьте, не нацеливаетесь ли вы на неправильный номер.** Это ловушка, которую стоит знать наизусть:
| Форма говорит | Это может означать | Фактические байты |
|---|---|---|
| 200 KB | 200 × 1000 | 200,000 |
| 200 KB | 200 × 1024 (KiB) | 204,800 |
| 2 MB | 2 × 10002 | 2,000,000 |
| 2 MB | 2 × 10242 (MiB) | 2,097,152 |
Форма, которая принимает «200 KB», но обеспечивает выполнение байтов 204,800, представляет собой разрыв 4,800-байт, который является небольшим в абсолютных терминах и решающим на практике.Наша цель по умолчанию - более строгие байты 200,000, чтобы оба чтения проходили. 3. Уменьшите размеры, а не только качество. Для фотографии уменьшение вдвое ширины пикселя сокращает данные примерно до четверти и обычно выглядит лучше, чем агрессивное снижение качества при полном размере. 4. ** Для сканированного PDF используйте глубокое сжатие.** Изображения страниц должны быть повторно сжаты, что означает потерю видимых деталей. После этого введите наименьший текст и решите, приемлема ли торговля.
Если файл сверхцели по-прежнему полезен, режим наилучших усилий может вернуть его, но прочитайте его предупреждение, а не рассматривайте кнопку загрузки как доказательство соответствия. Строгий режим отказывается от вывода, если правило не проходит.
Этот PDF был отвергнут.
Зашифрованные, защищенные паролем, прикрепляющие или активные PDF-файлы отклоняются. Отсутствует оверрайд. Экспортируйте простой PDF из созданного им приложения, если у вас есть на это право.
Два случая, которые удивляют людей:
- Подписано PDF Не отвергается, но переписывая его, подпись аннулируется. Сохраните подписанный оригинал; работайте над неподписанной копией.
- Wrong page count. Если слияние или разделение не удается при подсчете страниц, помните, что ограничения применяются к выходу: слияние двух 60-страниц PDF делает страницы 120, что превышает предел, хотя оба входа были в порядке. Цифры в Форматы и ограничения.
AttachReady не может редактировать текст PDF, восстанавливать поврежденный файл или подписывать документы.Эти функции не существуют, поэтому никакое сообщение об ошибке не приведет вас к ним.
Проблемы с вашим пособием или доступом
Вы достигли своего ежедневного предела.
Дождитесь сброса или войдите для большей надбавки к счету.
- Перезагрузка происходит в 00: 00 UTC, а не в локальную полночь. Преобразуйте в свой собственный часовой пояс, прежде чем предположить, что ожидание дольше, чем есть.
- Failed attempts count too. Перепроверка одного и того же неправильно сформированного файла пять раз тратит пять попыток. Исправьте причину перед повторным использованием.
- Пособия для гостей также распределяются по сети — 30 на исходный адрес — поэтому занятое соединение с офисом или кампусом может истощить пул, прежде чем вы запустите одну работу.
Текущие номера: Форматы и ограничения.
"Этот файл истек".
Окно удержания 24-час закрыто. Исчерпанные файлы не могут быть восстановлены, и нет расширения. Перезагрузите оригинал и запустите новую задачу. Результаты загрузки быстро — полное поведение удержания находится в Файлы конфиденциальности.
«Моя ссылка на загрузку не работает»
Сначала проверьте истечение срока действия, затем право собственности. Артефакты учетной записи относятся к учетной записи, которая их создала, поэтому ссылка с одной учетной записи не откроется в другой, а ссылка, созданная для ключа API, принадлежит учетной записи этого ключа. Совместное использование ссылок между учетными записями не поддерживается.
Проблемы с API
API ошибки: 401, 403 и 429
| Статус | Значение | исправлять |
|---|---|---|
| 401 | Ключ отсутствует, неправильно сформирован или отозван | Отправьте Authorization: Bearer <key>. Проверьте, что ключ все еще существует в /settings/apikeys; отозванные ключи немедленно выходят из строя. |
| 403 | Ключ действителен, но операция не допускается. | Проверьте требуемый уровень защиты, право на план и нацелен ли запрос на файл другой учетной записи. |
| 429 | Удар по пределу ставки | Каждый ключ по умолчанию выполняет запросы 120 в минуту. Откажитесь и повторите; суточная норма обработки разделена и распределена по всем ключам в учетной записи. |
Никогда не помещайте ключ API в пакет браузера, публичное хранилище или переменную окружения на стороне клиента. Ссылка на API охватывает создание ключа, загрузку и жизненный цикл работы.
«Моя работа все еще работает»
Работам Async нужны опросы, а опросы слишком агрессивно вызывают свои собственные проблемы. Запросите конечную точку возвращенной работы с ограниченным обратным выходом, а не в узком цикле, и остановитесь, когда статус является терминальным.
Если соединение упало в середине запроса, повторите с помощью ключа идемпотентности **same **. Новый ключ создает дубликат работы, который потребляет другое пособие и может произвести второй артефакт.
Попросите о помощи, не отправляя личные файлы
Email support@attachready.com с URL-адресом инструмента, примерно, когда это произошло, точным сообщением об ошибке или кодом, версией браузера, форматом файла и приблизительным размером. Идентификатор работы помогает, если у вас есть.
Не отправляйте ключи API, пароли, документы, удостоверяющие личность, или конфиденциальные вложения. Минимальный, нечувствительный образец, который воспроизводит проблему, является как более полезным, так и менее рискованным, чем ваш оригинальный материал. Руководство по ошибкам загрузки имеет более длинный контрольный список перед отправкой, а Руководство MCP охватывает обнаружение инструментов для клиентов ИИ.