Téléversez des fichiers pour les questions-réponses sur documents et l'extraction de données avec Qwen-Long et Qwen-Doc-Turbo . Cette interface permet également de téléverser des fichiers d'entrée pour les tâches par lot.
Utilisation
Appelez l'interface de fichier via le SDK OpenAI (Python ou Java) ou l'API HTTP. Cette interface prend en charge le téléversement, la requête et la suppression de fichiers.
Prérequis
- Une clé API Alibaba Cloud Model Studio : Obtenir une clé API et Exporter la clé API en tant que variable d'environnement.
- Pour utiliser le SDK OpenAI, installez le SDK OpenAI.
Disponibilité des modèles
Vous pouvez utiliser les ID de fichier dans les scénarios suivants :
- Qwen-Long : Questions-réponses sur des documents longs.
- Qwen-Doc-Turbo : Extraction de données et questions-réponses sur fichiers.
- Traitement par lot : Téléversement de fichiers pour traitement par lot.
Prise en main
Téléverser un fichier
Les limites de stockage sont de 10 000 fichiers maximum et 100 Go au total. Les fichiers n'expirent pas.
- Pour l'analyse de documents
- Pour le traitement par lot
Définissez
purpose sur file-extract. Les formats pris en charge incluent les fichiers texte (TXT, DOCX, PDF, XLSX, EPUB, MOBI, MD, CSV, JSON) et les images (BMP, PNG, JPG/JPEG, GIF, PDF numérisés). La taille maximale du fichier est de 150 Mo.Pour plus d'informations sur l'analyse de documents à l'aide d'un file_id, consultez contexte long (Qwen-Long) .
Exemples de requête
python
Exemple de réponse
Interroger les informations d'un fichier
Spécifiez le file_id dans la méthode retrieve ou GET pour interroger les informations du fichier.
- SDK OpenAI Python
- SDK OpenAI Java
- HTTP
Exemples de requête
Exemple de réponse
Interroger une liste de fichiers
Cette opération retourne toutes les informations sur les fichiers, y compris les fichiers téléversés et les fichiers de résultats par lot.
Cette opération prend en charge des paramètres de filtrage supplémentaires. Pour plus d'informations, consultez Description des paramètres.
- SDK OpenAI Python
- SDK OpenAI Java
- HTTP
Exemples de requête
Exemple de réponse
Supprimer un fichier
Supprimez un fichier par son file_id. Utilisez l'API Interroger une liste de fichiers pour trouver les ID de fichier.
- SDK OpenAI Python
- SDK OpenAI Java
- HTTP
Exemples de requête
Exemple de réponse
Facturation
Le téléversement, le stockage et la requête de fichiers sont gratuits. Des frais s'appliquent uniquement aux tokens d'entrée et de sortie lors de l'appel des modèles.
Limitation de débit
La limite QPS pour le téléversement de fichiers est de 3. La limite QPS totale pour les opérations de requête, de liste et de suppression est de 10.
Mise en production
- Nettoyage périodique : Supprimez régulièrement les fichiers inutilisés pour rester dans la limite de 10 000 fichiers.
- Vérification du statut : Vérifiez le statut du fichier après le téléversement. Un
statusàprocessedindique que le téléversement est terminé et que le fichier peut être référencé, mais pas que l'analyse est terminée. Avant la fin de l'analyse, les appels peuvent renvoyerFile parsing in progress; réessayez plus tard. - Contrôle des limites de débit : Assurez-vous de respecter les limites QPS (téléversement : 3 QPS, requête/liste/suppression : 10 QPS au total).
- Gestion des erreurs : Mettez en œuvre une gestion des exceptions pour les erreurs réseau, les erreurs d'API et autres défaillances.
FAQ
1. Que faire si le statut du fichier reste « processing » après le téléversement ?
Le traitement des fichiers se termine généralement en quelques secondes. Si le statut reste « processing » pendant une période prolongée :
- Vérifiez si le format du fichier est pris en charge.
- Vérifiez si la taille du fichier dépasse la limite.
- Utilisez l'API
retrievepour interroger périodiquement le statut.
2. Les ID de fichier peuvent-ils être utilisés sur différents comptes ?
Non. Les ID de fichier ne sont valides que dans le compte Alibaba Cloud qui les a créés et ne peuvent pas être partagés entre comptes.
3. Les fichiers téléversés sont-ils stockés définitivement ?
Oui. Les fichiers sont stockés de manière permanente dans votre compte sauf s'ils sont supprimés. Nettoyez périodiquement les fichiers inutiles.
4. Quelles sont les causes possibles d'échec de téléversement d'un fichier ?
- La clé API est invalide ou n'a pas été exportée.
- Le format du fichier n'est pas pris en charge.
- La taille du fichier dépasse la limite (file-extract : 150 Mo, batch : 500 Mo).
- Le nombre maximal de fichiers (10 000) ou la limite de taille totale (100 Go) a été atteint.
- La limite QPS de l'interface de téléversement de fichiers a été dépassée. La limite est de 3 QPS.
5. Dois-je choisir file-extract ou batch pour le paramètre purpose ?
file-extract: À utiliser pour les scénarios d'analyse de documents avec Qwen-Long ou Qwen-Doc-Turbo.batch: À utiliser pour les tâches par lot. Le fichier doit être un fichier JSONL conforme aux exigences de format.
6. Pourquoi Qwen-Long indique-t-il encore que le fichier est en cours d'analyse alors que le statut est « processed » ?
Un status à processed indique uniquement que le téléversement du fichier est terminé et que le fichier peut être référencé ; cela ne signifie pas que l'analyse est terminée. Si Qwen-Long renvoie File parsing in progress, please try again later., réessayez plus tard, une fois l'analyse du fichier terminée.
Description des paramètres
| Catégorie | Paramètre | Type | Obligatoire | Description | Exemple |
|---|---|---|---|---|---|
| Téléversement de fichier | file | File | Oui | Fichier à téléverser. | Path("test.txt") |
| purpose | String | Oui | Spécifie l'objectif du fichier téléversé. Valeurs valides :file-extract : Pour la compréhension de documents avec le modèle qwen-long.batch : Pour les tâches Compatible OpenAI - Lot (entrée de fichier). Le fichier doit respecter le format spécifié dans Compatible OpenAI - Lot (entrée de fichier). | "file-extract" | |
| Requête de fichier | file_id | String | Oui | ID du fichier à interroger. | "file-fe-xxx" |
| after | String | Non | Curseur utilisé pour la pagination dans la tâche Interroger une liste de fichiers.Définissez after sur le dernier file_id de la page actuelle pour récupérer la page suivante. Exemple : si le dernier file_id est file-batch-xxx, définissez after="file-batch-xxx" dans la requête suivante. | "file-fe-xxx" | |
| create_before | String | Non | Horodatage (format chaîne) pour Interroger une liste de fichiers. Retourne les ID de fichiers créés avant l'heure spécifiée. | "20250306123000", "2025-11-12 10:10:10", "2025-11-12", "20251112" | |
| create_after | String | Non | Horodatage (format chaîne) pour Interroger une liste de fichiers. Retourne les ID de fichiers créés après l'heure spécifiée. | "20250306123000", "2025-11-12 10:10:10", "2025-11-12", "20251112" | |
| purpose | String | Non | Pour Interroger une liste de fichiers : filtre par objectif (file-extract ou batch). | "batch" | |
| limit | Integer | Non | Nombre de fichiers par requête dans Interroger une liste de fichiers. Plage : 1-2 000. Par défaut : 2 000. | 2000 | |
| Suppression de fichier | file_id | String | Oui | ID du fichier à supprimer. | "file-fe-xxx" |
| Paramètres de réponse | |||||
| Paramètres de réponse communs | id | String | \ | ID du fichier.Pour Supprimer un fichier : ID du fichier supprimé. | "file-fe-xxx" |
| bytes | Integer | Taille du fichier en octets. | 81067 | ||
| created_at | Integer | Horodatage UNIX en secondes de la création du fichier. | 1617981067 | ||
| filename | String | Nom du fichier téléversé. | "text.txt" | ||
| object | String | Type d'objet. Toujours « list » pour Interroger une liste de fichiers, « file » pour les autres opérations. | "file" | ||
| purpose | String | Objectif du fichier. Les valeurs valides sont batch, file-extract et batch_output. | "file-extract" | ||
| status | String | Statut actuel du fichier. processed indique que le téléversement est terminé et que le fichier peut être référencé ; cela ne signifie pas que l'analyse est terminée. | "processed" | ||
| Requête de liste de fichiers | has_more | Boolean | Indique s'il existe une page de données suivante. | false | |
| data | Array | Liste des fichiers. Chaque élément suit le format des paramètres de réponse communs. | |||
| Suppression de fichier | deleted | Boolean | Indique le succès de la suppression. Retourne true en cas de succès. | true | |