Skip to main content

Appels de modèle dans un sous-espace de travail

Cette rubrique explique comment appeler un modèle via une API dans un sous-espace de travail (espace de travail non par défaut), en prenant Qwen-Plus comme exemple.

Cas d'usage

  • Contrôler les modèles accessibles à des utilisateurs spécifiques : La clé API de l'espace de travail par défaut permet d'appeler tous les modèles, ce qui lui confère des permissions excessives. Pour restreindre les modèles qu'un utilisateur RAM peut appeler, ajoutez cet utilisateur à un sous-espace de travail, accordez-lui uniquement les autorisations nécessaires sur les modèles requis, puis utilisez la clé API de ce sous-espace.
  • Répartir les coûts d'appel des modèles : L'utilisation d'un espace de travail par défaut pour plusieurs services ou scénarios complique la distinction des coûts associés à chaque appel de modèle. Créez un sous-espace de travail distinct pour chaque service ou scénario afin de générer des factures séparées et simplifier l'allocation des coûts.

Prérequis

  1. Obtenir la clé API du sous-espace de travail : Pour appeler les API de grands modèles, créez une clé API dans le sous-espace de travail et définissez-la comme variable d'environnement nommée DASHSCOPE_API_KEY.
  2. Configurer les permissions d'appel de modèle (obligatoire pour les modèles standard) : Pour appeler un modèle standard, tel que qwen-plus, avec la clé API d'un sous-espace de travail, vous devez au préalable configurer les permissions d'appel de modèle pour ce sous-espace.
  3. Choisir un langage de développement : Sélectionnez le langage et le SDK que vous maîtrisez pour appeler les API de grands modèles.

Appel du modèle

OpenAI

  • Singapore
  • China (Beijing)
SDK base_url : https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1Endpoint HTTP : POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions
Cet exemple montre comment appeler le modèle standard qwen-plus dans un sous-espace de travail via la méthode compatible OpenAI. Contrairement aux appels effectués depuis l'espace de travail par défaut, vous devez utiliser la clé API du sous-espace de travail.
  • Python (SDK)
  • Java (SDK)
  • Node.js (SDK)
  • Go (SDK)
  • C# (HTTP)
  • PHP (HTTP)
  • curl (HTTP)
import os
from openai import OpenAI

client = OpenAI(
    # If the environment variable is not set, replace the following line with your Model Studio API key: api_key="sk-xxx"
    # The API keys for the Singapore and Beijing regions are different. Replace WorkspaceId with your actual workspace ID. To get an API key, see https://www.alibabacloud.com/help/model-studio/get-api-key
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # This base_url is for the Singapore region. Replace WorkspaceId with your actual workspace ID. For models in the Beijing region, use: https://dashscope.aliyuncs.com/compatible-mode/v1
    base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
)

completion = client.chat.completions.create(
    # This example uses qwen-plus. You can replace it with another model name as needed. For a list of models, see: https://www.alibabacloud.com/help/model-studio/getting-started/models
    model="qwen-plus",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Who are you?"},
    ],
    # The enable_thinking parameter controls the thinking process for Qwen3 models (default is True for the open source version, False for the commercial version).
    # When using an open source Qwen3 model without enabling streaming output, uncomment the following line to avoid errors.
    # extra_body={"enable_thinking": False},
)
print(completion.model_dump_json())

DashScope

  • Singapore region
  • China (Beijing)
Endpoint HTTP :
  • Grands modèles de langage Qwen : POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generation
  • Modèles Qwen-VL/OCR : POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
Lors de la construction du Client pour les appels SDK, transmettez le workspace et la région (la valeur de region varie selon la région ; pour la région de Singapour, il s'agit de ap-southeast-1) :
  • Python
  • Java
import os
import dashscope

client = dashscope.Client(
    api_key=os.getenv('DASHSCOPE_API_KEY'),
    workspace="{WorkspaceId}",
    region="ap-southeast-1",
)
Cet exemple montre comment appeler le modèle qwen-plus dans un sous-espace de travail via DashScope. La différence principale avec l'utilisation de l'espace de travail par défaut réside dans le fait que vous devez utiliser la clé API du sous-espace de travail.
  • Python (SDK)
  • Java (SDK)
  • PHP (HTTP)
  • Node.js (HTTP)
  • C# (HTTP)
  • Go (HTTP)
  • curl (HTTP)
import os
import dashscope

# Voici la configuration de la région de Singapour. Remplacez {WorkspaceId} par l'ID de votre sous-workspace. Pour les modèles de la région Chine (Pékin), supprimez le paramètre workspace et utilisez : region="cn-beijing"
client = dashscope.Client(
    # Si la variable d'environnement n'est pas configurée, remplacez la ligne suivante par l'API Key du sous-workspace : api_key="sk-xxx"
    # Les API Key diffèrent selon la région. Pour obtenir une API Key, consultez https://www.alibabacloud.com/help/model-studio/get-api-key
    api_key=os.getenv('DASHSCOPE_API_KEY'),
    workspace="{WorkspaceId}",
    region="ap-southeast-1",
)

messages = [
    {'role': 'system', 'content': 'You are a helpful assistant.'},
    {'role': 'user', 'content': 'Who are you?'}
]
response = client.chat.completions.create(
    model="qwen-plus", # Cet exemple utilise qwen-plus. Vous pouvez remplacer par un autre nom de modèle si nécessaire. Liste des modèles : https://www.alibabacloud.com/help/model-studio/getting-started/models
    messages=messages,
    )
print(response)

Codes d'erreur

Si un appel de modèle renvoie une erreur, reportez-vous aux Messages d'erreur.

Étapes suivantes

Explorer davantage de modèles

Le code d'exemple utilise le modèle qwen-plus. Model Studio prend également en charge d'autres modèles Qwen. Reportez-vous à la rubrique Modèles pour consulter la liste des modèles pris en charge et leur référence API.

Utilisation avancée

Le code d'exemple illustre un scénario basique de questions-réponses. La rubrique Présentation de la génération de texte couvre les fonctionnalités avancées de l'API Qwen, notamment la sortie en streaming, la sortie structurée et l'appel de fonctions.