Solucionar problemas al procesar archivos
Resuelve formatos no compatibles, tamaños objetivo no alcanzados, archivos caducados, errores de cuota y fallos de autenticación API.
Actualizado
Encuentra el mensaje que has visto, lee lo que significa, y aplica la solución. Adivina a causa de un síntoma vago pierde más tiempo que cualquier otra cosa en esta página.
Problemas con el archivo que subiste
"Este tipo de archivo no es compatible"
Subiste algo que la herramienta no puede decodificar. La causa habitual es un archivo cuyo nombre se encuentra sobre su contenido: una imagen WebP o HEIC renombrada a .jpg por un descargador o una aplicación de chat.
Abrir el original en la aplicación que lo creó y exportar un formato soportado. Renaming nunca ayudará: la extensión es una etiqueta, y el decodificador lee los bytes. Si usted no está seguro de lo que realmente tiene, ejecutar Inspeccionar imágenes y comprobar el formato reportado. Los documentos protegidos por contraseña son un caso separado — ver la sección PDF a continuación, ya que un archivo simplemente no es rechazado.
"El resultado es más grande que tu objetivo"
El trabajo terminó, pero la salida se perdió el techo de byte. Trabajar a través de estos para:
- Compruebe si el objetivo es incluso alcanzable. Algunos archivos no pueden ser comprimidos por debajo de un umbral sin destruir contenido. Compare su resultado con el objetivo: un 5 MB El escaneo nunca alcanzará 200,000 bytes sin volverse imparable.
- Check whether you are aiming at the wrong number. Esta es la trampa que vale la pena saber por corazón:
| La forma dice | Puede significar | Actos efectivos |
|---|---|---|
| 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 |
Un formulario que acepta "200 KB" pero hace cumplir los bytes 204,800 es una brecha 4,800-byte, que es pequeña en términos absolutos y decisiva en la práctica. Nuestro objetivo predeterminado es el bytes 200,000 más estricto para que ambas lecturas pasen. 3. Reducir dimensiones en lugar de calidad sola. Para una foto, reducir el ancho del píxel corta los datos a aproximadamente un cuarto y generalmente se ve mejor que la reducción de calidad agresiva a tamaño completo. 4. **Para un PDF escaneado, utilice compresión profunda.Las imágenes de la página ** tienen que ser recomprimidas, lo que significa pérdida de detalle visible. Acercácese en el texto más pequeño después y decida si el comercio es aceptable.
Si un archivo over-target sigue siendo útil, el modo best-effort puede devolver uno — pero leer su advertencia en lugar de tratar el botón de descarga como prueba de cumplimiento. El modo Strict rechaza la salida a menos que la regla pase.
"Este PDF fue rechazado"
Se rechazan los PDF cifrados, protegidos por contraseña, soportando archivos adjuntos o con contenido activo. No hay anulación. Exportar un PDF claro de la aplicación que lo creó, si usted tiene el derecho de hacerlo.
Dos casos relacionados que sorprenden a la gente:
- A firmó PDF no es rechazado, pero reescribirla invalida la firma. Mantenga el original firmado; trabaje en una copia no firmada.
- Wrong page count. Si una fusión o división falla en el recuento de páginas, recuerde que los límites se aplican a la salida: fusionar dos PDFs 60-page hace páginas 120, que está por encima del límite aunque ambas entradas estaban bien. Los números están en formatos y límites.
AttachReady no puede editar texto PDF, reparar un archivo corrupto, o documentos de signos. Esas características no existen, por lo que ningún mensaje de error le llevará a ellos.
Problemas con su subsidio o acceso
"Ha llegado a su límite diario"
Espera el reinicio o inicia sesión para el subsidio de cuenta más grande.
- El reajuste ocurre en 00:00 UTC, no la medianoche local. Convierta en su propia zona horaria antes de asumir que la espera es más larga de lo que es.
- Los intentos fallidos cuentan también. El reintentar el mismo archivo malformado cinco veces pasa cinco intentos. Arreglar la causa antes de reintentar.
- Las prestaciones de los huéspedes también se comparten por red — 30 por dirección de origen — por lo que una oficina ocupada o conexión en el campus puede agotar la piscina antes de ejecutar un solo trabajo.
Números actuales: formatos y límites.
"Este archivo ha expirado"
La ventana de retención 24 cierra. Los archivos eliminados no se pueden recuperar, y no hay extensión disponible. Recarga su original y ejecute una nueva tarea. Descargue los resultados rápidamente — el comportamiento de retención completo está en archivo privacidad.
"Mi enlace de descarga no funciona"
Los artefactos de la cuenta están comprendidos en la cuenta que los creó, por lo que un enlace de una cuenta no se abrirá en otra, y un enlace generado para una tecla API pertenece a la cuenta de esa clave. El compartir enlaces entre cuentas no es compatible.
Problemas con el API
Errores API: 401, 403 y 429
| Situación | Significado | Fijación |
|---|---|---|
| 401 | La llave está desaparecida, malformada o revocada | Envíe Authorization: Bearer <key>. Compruebe la tecla que aún existe en /settings/apikeys; las teclas revocadas fallan inmediatamente. |
| 403 | La clave es válida pero no se permite la operación | Compruebe el nivel de auth requerido de la herramienta, el derecho de su plan, y si la solicitud apunta al archivo de otra cuenta. |
| 429 | Tasa límite de éxito | Cada predeterminado clave para las solicitudes 120 por minuto. Retrocede y vuelva a entrar; la prestación de procesamiento diario es separada y compartida a través de todas las claves en la cuenta. |
Nunca ponga una tecla API en un paquete del navegador, un repositorio público o una variable del entorno del lado del cliente. El Referencia API cubre la creación clave, la carga y el ciclo de vida laboral.
"Mi trabajo sigue funcionando"
Los trabajos asinc necesitan encuestas, y la votación causa demasiado agresivamente sus propios problemas. Consultar el punto final de trabajo devuelto con backoff atado en lugar de en un bucle apretado, y parar cuando el estado es terminal.
Si la conexión se redujo a mitad de la demanda, reingrese con el same idempotency key. Una nueva clave crea un trabajo duplicado que consume otra asignación y puede producir un segundo artefacto.
Solicitar ayuda sin enviar archivos privados
Email support@attachready.com con la URL de la herramienta, aproximadamente cuando sucedió, el mensaje de error exacto o el código, la versión de su navegador, y el formato del archivo y tamaño aproximado. Un ID de trabajo ayuda si usted tiene uno.
No enviar claves API, contraseñas, documentos de identidad o archivos adjuntos confidenciales. Una muestra mínima y no sensible que reproduce el problema es tanto más útil y menos riesgosa que su material original. El subir guía de error tiene una lista de verificación previa a la admisión más larga, y el Guía MCP cubre el descubrimiento de herramientas para los clientes de AI.