Skip to main content

Llamadas a modelos en un subespacio de trabajo

Utilizando Qwen-Plus como ejemplo, este tema explica cómo invocar un modelo a través de una API en un subespacio de trabajo (un espacio de trabajo no predeterminado).

Escenarios

  • Controle qué modelos pueden llamar usuarios específicos: La clave de API para el espacio de trabajo predeterminado puede llamar a todos los modelos, lo que le otorga permisos excesivos. Para controlar qué modelos puede llamar un usuario RAM, agregue el usuario a un subespacio de trabajo, otorgue permisos solo para los modelos necesarios y haga que utilicen la clave de API de ese espacio de trabajo.
  • Asigne costos de llamada al modelo: Utilizar el espacio de trabajo predeterminado para múltiples servicios o escenarios dificulta distinguir los costos de llamada al modelo para cada uno. Cree un subespacio de trabajo separado para cada servicio o escenario para generar facturas separadas y simplificar la asignación de costos.

Requisitos previos

  1. Obtenga la clave de API para el subespacio de trabajo: Para llamar a las API de modelos grandes, cree una clave de API en el subespacio de trabajo y configúrela como una variable de entorno llamada DASHSCOPE_API_KEY.
  2. Establezca permisos de llamada al modelo (necesario para modelos estándar): Para llamar a un modelo estándar, como qwen-plus, con la clave de API de un subespacio de trabajo, primero debe establecer permisos de llamada al modelo para ese subespacio de trabajo.
  3. Seleccione un lenguaje de desarrollo: Seleccione un lenguaje y SDK con el que esté familiarizado para llamar a las API de modelos grandes.

Llamada al modelo

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
Este ejemplo muestra cómo llamar al modelo estándar qwen-plus en un subespacio de trabajo utilizando el método compatible con OpenAI. A diferencia de las llamadas en el espacio de trabajo predeterminado, debe utilizar la clave de API del subespacio de trabajo.
  • 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

  • Región de Singapore
  • China (Beijing)
Endpoint HTTP:
  • Modelos de lenguaje grande Qwen: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generation
  • Modelos Qwen-VL/OCR: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
Al construir el Client para las llamadas SDK, pase el espacio de trabajo y la región (el valor de region varía según la región; para la región de Singapur es 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",
)
Este ejemplo muestra cómo llamar al modelo qwen-plus en un subespacio de trabajo utilizando DashScope. La diferencia clave con respecto al uso del espacio de trabajo predeterminado es que debe utilizar la clave de API del subespacio de trabajo.
  • Python (SDK)
  • Java (SDK)
  • PHP (HTTP)
  • Node.js (HTTP)
  • C# (HTTP)
  • Go (HTTP)
  • curl (HTTP)
import os
import dashscope

# La siguiente es la configuración de la región de Singapur. Sustituya {WorkspaceId} por el ID real de su subespacio de trabajo. Para modelos de la región de China (Pekín), elimine el parámetro workspace y use: region="cn-beijing"
client = dashscope.Client(
    # Si la variable de entorno no está configurada, sustituya la siguiente línea por la API Key del subespacio de trabajo: api_key="sk-xxx"
    # Las API Key difieren según la región. Para obtener una API Key, consulte 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", # Este ejemplo usa qwen-plus. Puede sustituirlo por el nombre de otro modelo según sea necesario. Para consultar la lista de modelos, véase https://www.alibabacloud.com/help/model-studio/getting-started/models
    messages=messages,
    )
print(response)

Códigos de error

Si una llamada al modelo devuelve un error, consulte Mensajes de error.

Siguientes pasos

Explorar más modelos

El código de ejemplo utiliza el modelo qwen-plus. Model Studio también admite otros modelos Qwen. Consulte Modelos para obtener una lista de modelos admitidos y su referencia de API.

Uso avanzado

El código de ejemplo demuestra un escenario básico de preguntas y respuestas. La descripción general de generación de texto cubre funciones avanzadas de la API de Qwen, incluyendo salida en streaming, salida estructurada y llamada a funciones.