Les modèles de vision Qwen d'Alibaba Cloud Model Studio sont compatibles avec la spécification d'interface OpenAI. Pour migrer vos applications OpenAI existantes vers Model Studio, modifiez simplement trois paramètres :
-
base_url :
- Chine (Pékin) : https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
- Singapour : https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1. Remplacez {WorkspaceId} par votre ID d'espace de travail.
- Japon (Tokyo) : https://{WorkspaceId}.ap-northeast-1.maas.aliyuncs.com/compatible-mode/v1. Remplacez {WorkspaceId} par votre ID d'espace de travail.
- États-Unis (Virginie) : https://dashscope-us.aliyuncs.com/compatible-mode/v1
- Chine (Hong Kong) : https://{WorkspaceId}.cn-hongkong.maas.aliyuncs.com/compatible-mode/v1. Remplacez
WorkspaceIdpar votre ID d'espace de travail.
- api_key : remplacez cette valeur par votre clé API Model Studio
- model : indiquez un nom de modèle parmi la liste suivante
Modèles pris en charge
Modèles pris en charge : Qwen-VL, QVQ, Qwen-OCR
Les modèles disponibles varient selon la région. Pour plus de détails, consultez la console Model Studio .
Appel de modèle
Exemples
Cette section présente des exemples d'appels en streaming pour Python (SDK OpenAI et SDK LangChain_OpenAI) ainsi que pour cURL (HTTP). Pour d'autres langages de programmation ou méthodes de saisie, reportez-vous aux Exemples de requêtes Vision.
Les modèles QVQ ne prennent en charge que la sortie en streaming. Pour plus de détails, consultez Activer ou désactiver le mode de réflexion .
- OpenAI SDK
SDK LangChain OpenAI
Prérequis
- Assurez-vous que Python est installé sur votre machine.
-
Installez le SDK langchain_openai en exécutant la commande suivante.
- Activez Model Studio et obtenez une clé API. Pour plus de détails, consultez Obtenir une clé API.
- Nous vous conseillons de configurer la clé API sous forme de variable d'environnement afin de limiter les risques de fuite. Pour plus de détails, consultez Configurer la clé API comme variable d'environnement. Vous pouvez également définir la clé API directement dans le code, mais cela accroît le risque de fuite.
Utilisation
Les exemples ci-dessous montrent comment appeler les modèles de vision Qwen via le SDK langchain_openai.
Sortie non-streaming
La sortie non-streaming utilise la méthode invoke. Consultez l'exemple de code suivant :
Sortie streaming
Les exemples suivants ne s'appliquent pas aux modèles QVQ. Pour l'utilisation des modèles QVQ, consultez Activer ou désactiver le mode de réflexion .
HTTP
Vous pouvez appeler les modèles de vision Qwen via l'interface HTTP et obtenir des réponses structurées comme lors d'un appel aux services OpenAI par HTTP.
Prérequis
- Activez Model Studio et obtenez une clé API. Pour plus de détails, consultez Obtenir une clé API.
- Nous vous conseillons de configurer la clé API sous forme de variable d'environnement afin de limiter les risques de fuite. Pour plus de détails, consultez Configurer la clé API comme variable d'environnement. Vous pouvez également définir la clé API directement dans le code, mais cela accroît le risque de fuite.
Endpoints API
Exemples de requêtes
Les exemples suivants illustrent l'appel de l'API à l'aide de commandes cURL.
Si vous n'avez pas configuré la clé API en tant que variable d'environnement, remplacez $DASHSCOPE_API_KEY par votre propre clé API*.*