Résoudre les problèmes de traitement de fichiers
Solutions aux formats non pris en charge, tailles cibles non atteintes, fichiers expirés, erreurs de quota et échecs d’authentification API.
Mise à jour
Trouvez le message que vous avez réellement vu, lisez ce que cela signifie, et appliquez la correction. Deviner aux causes d'un symptôme vague perd plus de temps que tout autre chose sur cette page.
Problèmes avec le fichier que vous avez téléchargé
"Ce type de fichier n'est pas pris en charge"
Vous avez téléchargé quelque chose que l'outil ne peut pas décoder. La cause habituelle est un fichier dont le nom se trouve sur son contenu — une image WebP ou HEIC rebaptisée .jpg par un téléchargeur ou une application de chat.
Ouvrez l'original dans l'application qui l'a créé et exportez un format supporté. Renaming n'aidera jamais: l'extension est une étiquette, et le décodeur lit les octets. Si vous n'êtes pas sûr de ce que vous avez vraiment, exécutez Inspecter des images et vérifiez le format signalé. Les documents protégés par mot de passe sont une case séparée — voir la section PDF ci-dessous, car un fichier chiffré est rejeté plutôt que simplement non supporté.
"Le résultat est plus grand que votre cible"
Le travail a fini, mais la sortie a raté le plafond de l'octet.
- Vérifiez si la cible est réalisable. Certains fichiers ne peuvent pas être compressés en dessous d'un seuil sans détruire le contenu.Comparez votre résultat avec la cible : un balayage 5 MB n'atteindra jamais les octets 200,000 sans devenir illisibles.
- Vérifiez si vous visez le mauvais numéro. C'est le piège qui mérite d'être connu par cœur :
| Le formulaire dit : | Cela peut signifier | Total des octets effectifs |
|---|---|---|
| 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 formulaire qui accepte "200 KB" mais qui fait appliquer les octets 204,800 est un écart de 4,800-octet, qui est petit en termes absolus et décisif dans la pratique. Notre cible par défaut est les octets 200,000 plus stricts afin que les deux lectures passent. 3. Dimensions de la réduction plutôt que de la qualité seule. Pour une photo, réduire de moitié la largeur du pixel réduit les données à environ un quart et semble généralement mieux que la réduction de qualité agressive à pleine dimension. 4. Pour un PDF scanné, utilisez une compression profonde. Les images de page doivent être recomprimées, ce qui signifie une perte de détails visibles. Zoomez sur le plus petit texte après et décidez si le trade est acceptable.
Si un fichier sur-cible est toujours utile, le mode best-effort peut en retourner un — mais lire son avertissement plutôt que de traiter le bouton de téléchargement comme une preuve de conformité. Mode strict refuse la sortie à moins que la règle passe.
"Ce PDF a été rejeté"
Les PDF chiffrés, protégés par un mot de passe, portant une pièce jointe ou un contenu actif sont refusés. Il n'y a pas de redéfinition. Exportez un PDF à partir de l'application qui l'a créé, si vous avez le droit de le faire.
Deux cas connexes qui surprennent les gens :
- A signé PDF n'est pas rejeté, mais la réécrire invalide la signature. Conserver l'original signé; travailler sur une copie non signée.
- Wrong page count. Si une fusion ou une scission échoue sur le nombre de pages, n'oubliez pas que les limites s'appliquent à la sortie : fusionner deux PDF 60-page rend les pages 120, ce qui dépasse la limite même si les deux entrées étaient bonnes. Les chiffres sont en formats et limites.
AttachReady ne peut pas modifier le texte de PDF, réparer un fichier corrompu ou signer des documents. Ces fonctionnalités n'existent pas, donc aucun message d'erreur ne vous mènera à eux.
Problèmes avec votre allocation ou votre accès
"Vous avez atteint votre limite quotidienne"
Attendez la remise à zéro ou connectez-vous à l'allocation de compte plus grande.
- La réinitialisation se produit à 00:00 UTC, et non à minuit. Convertissez-vous dans votre propre fuseau horaire avant de supposer que l'attente est plus longue qu'elle ne l'est.
- Les tentatives ont échoué aussi. Réessayer le même fichier mal formé cinq fois passe cinq tentatives.
- Les indemnités sont également partagées par réseau — 30 par adresse source — de sorte qu'un bureau occupé ou une connexion campus peut épuiser la piscine avant de faire un seul travail.
Numéros actuels : formats et limites.
"Ce fichier a expiré"
La fenêtre de rétention 24-heure s'est fermée. Les fichiers expirés ne peuvent pas être récupérés et il n'y a pas d'extension disponible. Rechargez votre original et exécutez une nouvelle tâche. Télécharger les résultats rapidement — le comportement de rétention complet est en confidentialité des fichiers.
"Mon lien de téléchargement ne fonctionne pas"
Vérifier l'expiration d'abord, puis la propriété. Les artefacts de compte sont projetés vers le compte qui les a créés, de sorte qu'un lien d'un compte ne s'ouvre pas dans un autre, et qu'un lien généré pour une clé API appartient au compte de cette clé.
Problèmes avec le API
Erreurs API : 401, 403 et 429
| État | Signification | Correction |
|---|---|---|
| 401 | La clé est manquante, mal formée ou révoquée | Envoyez Authorization: Bearer <key>. Vérifiez que la clé existe toujours à /settings/apikeys; les touches révoquées échouent immédiatement. |
| 403 | La clé est valide mais l'opération n'est pas autorisée | Vérifiez le niveau d'auth requis de l'outil, votre droit au régime et si la demande cible le fichier d'un autre compte. |
| 429 | Taux limite atteint | Chaque clé est par défaut aux requêtes 120 par minute. Retirez et réessayez; l'indemnité de traitement quotidien est séparée et partagée sur toutes les clés du compte. |
Ne jamais mettre une clé API dans un bundle de navigateur, un dépôt public ou une variable d'environnement côté client. La Référence API couvre la création de clé, le téléchargement et le cycle de vie de l'emploi.
"Mon travail est toujours en cours"
Les emplois d'Async ont besoin d'un sondage, et le sondage cause trop agressivement ses propres problèmes. Interrogez le point d'arrêt de travail retourné avec un retour limité plutôt que dans une boucle serrée, et arrêtez lorsque le statut est terminal.
Si la connexion est tombée à mi-requête, essayez avec la ** même clé d'idempotency**. Une nouvelle clé crée un travail en double qui consomme une autre allocation et peut produire un second artefact.
Demander de l'aide sans envoyer de fichiers privés
Email support@attachready.com avec l'URL de l'outil, à peu près quand c'est arrivé, le message d'erreur exact ou le code, votre version du navigateur, et le format du fichier et la taille approximative.
N'envoyez pas de clés, de mots de passe, de documents d'identité ou de pièces jointes confidentielles API. Un échantillon minimal et non sensible qui reproduit le problème est à la fois plus utile et moins risqué que votre matériel original. La Guide d'erreur de téléchargement possède une liste de contrôle pré-présentation plus longue, et la Guide MCP couvre la découverte d'outils pour les clients AI.