Le modèle d'exploration de données extrait des informations, modère le contenu, classe les données et génère des résumés. Il produit des données structurées (comme du JSON) rapidement et avec précision, contrairement aux modèles de chat polyvalents qui peuvent renvoyer des formats incohérents ou extraire les informations de manière incorrecte. De plus, ce modèle prend en charge la génération de présentations PPT à partir du contenu de documents, avec un mode basé sur des modèles et un mode créatif disponibles.
Guide de mise en œuvre
Qwen-Doc-Turbo permet d'extraire des informations à partir de fichiers selon trois méthodes. Pour plus d'informations sur les limites de taille et de type de fichier, consultez la section Limites.
Fonctionnalité | URL de fichier (recommandé) | ID de fichier | Texte brut |
|---|---|---|---|
Source du fichier | URL publique | Fichier local (téléchargement requis) | Transmis sous forme de chaîne |
Limite de longueur d'entrée | Jusqu'à 10 fichiersPrend en charge les fichiers volumineux (entrée maximale de 253 k tokens) | 1 fichierPrend en charge les fichiers volumineux (entrée maximale de 253 k tokens) | Jusqu'à 9 000 tokens |
Compatibilité SDK | Uniquement | Téléchargement : |
|
Principaux avantages | Aucun téléchargement vers Model Studio requis. Prend en charge les appels par lots. | Évite les téléchargements répétés. Idéal pour la réutilisation. | Aucune gestion de fichier requise. |
Prérequis
- Vous avez créé une clé API et exporté la clé API en tant que variable d'environnement.
- Si vous prévoyez d'appeler le modèle à l'aide d'un SDK, installez le SDK OpenAI ou le SDK DashScope.
Transmettre une URL de fichier
Extrayez des données structurées à l'aide d'URL de fichier (jusqu'à 10 fichiers simultanément). Cet exemple transmet les fichiers Manuel de produit A – Exemple et Manuel de produit B – Exemple et invite le modèle à renvoyer les informations extraites au format JSON.
La méthode par URL de fichier prend uniquement en charge le protocole DashScope. Utilisez le SDK Python DashScope ou des appels HTTP (comme curl).
content. Notez que le contenu peut être encapsulé dans des marqueurs de bloc de code Markdown (par exemple, json\n[...]\n). Vous devez supprimer ces marqueurs Markdown avant d'analyser la réponse avec json.loads() :Exemple de réponse
Exemple de réponse
Transmettre un ID de fichier
Télécharger un fichier
Avant d'exécuter le code, téléchargez le fichier Manuel de produit A – Exemple et placez-le dans le répertoire de votre projet. Téléchargez le fichier via l'interface compatible OpenAI pour obtenir un file-id. Pour plus de détails sur l'API de téléchargement, consultez la section Référence de l'API.
file-id du fichier téléchargé.
Transmettre des informations et lancer une conversation à l'aide d'un ID de fichier
Transmettez le file-id dans un message système (après le message de définition du rôle). Le message utilisateur contient votre requête concernant le fichier.
Exemple complet : téléversement d'un fichier et appel du modèle
Exemple complet : téléversement d'un fichier et appel du modèle
content. Notez que le contenu peut être encapsulé dans des marqueurs de bloc de code Markdown (par exemple, json\n[...]\n). Vous devez supprimer ces marqueurs Markdown avant d'analyser la réponse avec json.loads() :Exemple de réponse
Exemple de réponse
Transmettre du texte brut
Vous pouvez transmettre le contenu du fichier directement sous forme de chaîne au lieu d'utiliser un file-id. Pour éviter toute confusion, placez le message de définition du rôle en premier dans le tableau messages.
Si le contenu textuel dépasse 9 000 jetons, utilisez plutôt une URL de fichier ou un ID de fichier (en raison des limites de taille du corps de l'API).
content. Notez que le contenu peut être encapsulé dans des marqueurs de bloc de code Markdown (par exemple, json\n[...]\n). Vous devez supprimer ces marqueurs Markdown avant d'analyser la réponse avec json.loads() :Exemple de réponse
Exemple de réponse
Tarification du modèle
Modèle | Fenêtre de contexte | Entrée maximale | Sortie maximale | Coût d'entrée | Coût de sortie | Quota gratuit |
|---|---|---|---|---|---|---|
(Jetons) | (Million de jetons) | |||||
qwen-doc-turbo | 262 144 | 253 952 | 32 768 | 0,087 USD | 0,144 USD | Aucun quota gratuit |
FAQ
- Où les fichiers sont-ils stockés après avoir été téléchargés via l'interface de fichier compatible OpenAI ? Les fichiers téléchargés via l'interface compatible OpenAI sont stockés gratuitement dans votre bucket Model Studio. Pour interroger et gérer les fichiers, reportez-vous à Interface de fichier OpenAI.
- Lors du téléchargement à l'aide de la méthode URL de fichier, quelles sont les différences entre les options du paramètre file_parsing_strategy ? « auto » : analyse automatiquement en fonction du contenu. « text_only » : analyse uniquement le texte. « text_and_images » : analyse à la fois les images et le texte (augmente le temps d'analyse).
-
Comment puis-je déterminer si l'analyse d'un fichier est terminée ?
Essayez de démarrer une conversation avec l'ID de fichier. Si le fichier est toujours en cours d'analyse, l'API renvoie
File parsing in progress, please try again later.— réessayez après un délai. Si l'appel réussit, le fichier est prêt. - Le processus d'analyse après le téléchargement du fichier entraîne-t-il des coûts supplémentaires ? L'analyse des documents est gratuite.
Référence API
Pour les paramètres d'entrée et de sortie de Qwen-Doc-Turbo, reportez-vous à Référence API compatible OpenAI ou Référence API DashScope.
Codes d'erreur
Si l'appel au modèle échoue et renvoie un message d'erreur, reportez-vous aux Codes d'erreur pour résoudre le problème.
Limites
-
Dépendances SDK :
- URL de fichier (doc_url) : Prend en charge uniquement le protocole DashScope. Utilisez le
SDK Python DashScopeou les appels HTTP (comme curl). - Téléchargement de fichier (file-id) : Doit utiliser un SDK compatible
OpenAIpour le téléchargement et la gestion.
- URL de fichier (doc_url) : Prend en charge uniquement le protocole DashScope. Utilisez le
-
Téléchargement et référence de fichier :
- URL de fichier (doc_url) : Jusqu'à 10 URL par requête. Les URL doivent être accessibles publiquement.
-
Téléchargement de fichier (file-id) : Maximum 150 Mo par fichier. Limites du compte : 10 000 fichiers ou 100 Go au total (les fichiers n'expirent jamais). Chaque requête référence un seul fichier.
Les requêtes de téléchargement échouent lorsque les limites sont atteintes. Supprimez les fichiers inutiles pour libérer du quota. Consultez Compatible OpenAI - Fichier pour plus de détails.
- Formats pris en charge : TXT, DOC, DOCX, PDF, XLS, XLSX, MD, PPT, PPTX, JPG, JPEG, PNG, GIF et BMP.
-
Entrée API :
- Utilisation de
doc_urloufile-id: maximum 262 144 jetons. - Texte brut dans les messages
user/system: maximum 9 000 jetons par message.
- Utilisation de
-
Sortie API :
- La longueur de sortie maximale est de 32 768 jetons.
-
Partage de fichier :
file-idfonctionne uniquement au sein du compte générateur — pas entre comptes ni avec les clés API des utilisateurs RAM.
- Limite de débit : Reportez-vous à Limitation de débit.