Alibaba Cloud Model Studio:Configuración y herramientas

Referencia de comandos de la CLI Bailian para configuración de autenticación, administración de perfiles, mercado de modelos, carga de archivos y herramientas generales.

Administre la autenticación de la CLI, cambie entre perfiles, navegue por el mercado de modelos, cargue archivos y use herramientas generales desde la terminal.

Autenticación

bl auth login

Autentíquese con clave de API, inicio de sesión mediante navegador del consola o OpenAPI AK/SK (los credenciales pueden coexistir). No se requiere autenticación.

Uso

bl auth login --api-key <key> | --console | --open-api --access-key-id <id> --access-key-secret <secret>

Parámetro	Tipo	Obligatorio	Descripción
--api-key <key>	string	No	Clave de API del modelo para validar y almacenar
--base-url <url>	string	No	URL base de la API del modelo para validar y almacenar junto con --api-key
--console	switch	No	Iniciar sesión mediante navegador (China por defecto; use --console-site internacional para el sitio internacional). Crea una clave de API ordinaria si es necesario; los planes de suscripción requieren --api-key
--console-site <site>	string	No	Sitio del consola: doméstico, internacional
--open-api	switch	No	Almacenar credenciales de Alibaba Cloud OpenAPI AK/SK
--access-key-id <id>	string	No	ID de clave de acceso de Alibaba Cloud para almacenar
--access-key-secret <secret>	string	No	Secreto de clave de acceso de Alibaba Cloud para almacenar

Ejemplo: Autenticarse mediante inicio de sesión del navegador para el consola

bl auth login --console

bl auth status

Muestre el estado actual de autenticación. No se requiere autenticación.

Uso

bl auth status

Este comando solo admite opciones globales.

Ejemplo: Mostrar el estado de autenticación con salida JSON

bl auth status --output json

bl auth logout

Elimine las credenciales almacenadas; el cierre de sesión completo también elimina la URL base del modelo. No se requiere autenticación.

Uso

bl auth logout [--console | --open-api] [--dry-run]

Parámetro	Tipo	Obligatorio	Descripción
--console	switch	No	Solo elimine el access_token del consola, mantenga intacta la api_key
--open-api	switch	No	Solo elimine las credenciales de OpenAPI AK/SK/STS, mantenga intactas otras credenciales

Ejemplo: Eliminar solo el access_token del consola

bl auth logout --console

bl auth generate-access-token

Genere un token de acceso de la CLI usando AK/SK de OpenAPI. No se requiere autenticación.

Uso

bl auth generate-access-token --access-key-id <id> --access-key-secret <secret> --security-token <token>

Parámetro	Tipo	Obligatorio	Descripción
--access-key-id <id>	string	Sí	ID de clave de acceso de Alibaba Cloud
--access-key-secret <secret>	string	Sí	Secreto de clave de acceso de Alibaba Cloud
--security-token <token>	string	No	Token de seguridad de STS de Alibaba Cloud para almacenar (opcional)

Ejemplo: Generar un token de acceso de la CLI con AK/SK y token STS opcional

bl auth generate-access-token --access-key-id LTAIxxxxx --access-key-secret xxxxx --security-token <token>

Configuración

bl config set

Establezca un valor de configuración. No se requiere autenticación.

Uso

bl config set --key <key> --value <value>

Parámetro	Tipo	Obligatorio	Descripción
--key <key>	string	Sí	Clave de configuración (language, base_url, output, output_dir, timeout, watermark, api_key, api_key_capabilities, access_token, access_key_id, access_key_secret, security_token, default_*_model, workspace_id)
--value <value>	string	Sí	Valor a establecer

Ejemplo: Establecer la clave de configuración language en zh-CN

bl config set --key language --value zh-CN

bl config show

Muestre la configuración actual. No se requiere autenticación.

Uso

bl config show

Este comando solo admite opciones globales.

Ejemplo: Mostrar la configuración actual con salida JSON

bl config show --output json

bl config list

Muestre los perfiles de configuración y muestre el perfil activo. No se requiere autenticación.

Uso

bl config list

Este comando solo admite opciones globales.

Ejemplo: Listar perfiles de configuración con el perfil activo en salida JSON

bl config list --output json

bl config use

Establezca el perfil de configuración activo. No se requiere autenticación.

Uso

bl config use --name <name>

Parámetro	Tipo	Obligatorio	Descripción
--name <name>	string	Sí	Nombre de perfil existente, o default

Ejemplo: Establecer el perfil de configuración activo como token-plan

bl config use --name token-plan

bl config ui

Abra una interfaz web local para gestionar perfiles de configuración. No se requiere autenticación.

Uso

bl config ui [--port <port>] [--no-open]

Parámetro	Tipo	Obligatorio	Descripción
--port <port>	number	No	Puerto en el que escuchar (predeterminado: puerto libre aleatorio)
--no-open	switch	No	No abra el navegador automáticamente

Ejemplo: Abrir la interfaz web de gestión de configuración en el puerto 8787

bl config ui --port 8787

bl config agent

Configura un agente de codificación para usar la API DashScope. No se requiere autenticación.

Uso

bl config agent --agent <name> (--base-url <url> | --region <region>) (--api-key <key> | --key <encoded>) --model <model>

Parámetro	Tipo	Obligatorio	Descripción
--agent <name>	string	Sí	Agente objetivo: claude-code, qwen-code, opencode, openclaw, hermes, codex
--base-url <url>	string	No	URL base de la API
--region <region>	string	No	Región de Model Studio (por ejemplo, cn-beijing, ap-southeast-1); convertida en --base-url. Solo para Plan de Tokens
--api-key <key>	string	No	Clave de API
--key <encoded>	string	No	Clave de API obfuscada desde la consola web (comienza con "o1_"); decodificada en --api-key
--model <model>	string	Sí	Nombre del modelo predeterminado
--context-window <tokens>	number	No	Solo OpenClaw: tamaño de ventana de contexto del modelo en tokens (predeterminado: 256000)
--wire-api <api>	string	No	Solo Codex: protocolo de cableado (predeterminado: responses). "chat" solo funciona con Codex heredado <= 0.80.0

Ejemplo: Configurar el agente de codificación para usar la API DashScope con configuraciones especificadas

bl config agent --agent claude-code --base-url https://dashscope.aliyuncs.com/apps/anthropic --api-key sk-xxxxx --model qwen3-max

Herramientas generales

bl file upload

Carga un archivo local al almacenamiento temporal de DashScope (48 h). Requiere autenticación con clave de API.

Uso

bl file upload --file <path> --model <model>

Parámetro	Tipo	Obligatorio	Descripción
--file <path>	string	Sí	Archivo local a cargar (imagen, video, audio)
--model <model>	string	Sí	Nombre del modelo objetivo (el archivo está vinculado a este modelo)

Ejemplo: Cargar photo.jpg al almacenamiento de DashScope vinculado al modelo qwen3-vl-plus

bl file upload --file photo.jpg --model qwen3-vl-plus

bl model list

Explora familias de modelos o muestra información detallada de modelos en el mercado de modelos Bailian. No se requiere autenticación.

Uso

bl model list [--model <model>] [--page <n>] [--page-size <n>] [--provider <p>] [--capability <c>] [--feature <f>] [--input-modality <m>] [--output-modality <m>] [--include-deprecated] [--enrich]

Parámetro	Tipo	Obligatorio	Descripción
--model <model>	string	No	Muestra detalles completos de una familia de modelos específica (activa el modo detallado)
--page <n>	number	No	Número de página (predeterminado: 1)
--page-size <n>	number	No	Resultados por página (predeterminado: 10)
--provider <p>	array	No	Filtra por proveedor (repetible, por ejemplo: --provider alibaba --provider deepseek)
--capability <c>	array	No	Filtra por código de capacidad (TG, Reasoning, VU, IG, VG, TTS, ASR, …)
--feature <f>	array	No	Filtra por funcionalidad (function-calling, web-search, structured-outputs, …)
--context-window <w>	array	No	Filtra por rango de ventana de contexto
--input-modality <m>	array	No	Requiere una modalidad de entrada (repetible: Texto, Imagen, Video, Audio)
--output-modality <m>	array	No	Requiere una modalidad de salida (repetible: Texto, Imagen, Video, Audio)
--include-deprecated	switch	No	Incluir modelos que ya están fuera de línea (ocultos por defecto)
--enrich	switch	No	También obtener el esquema de parámetros de entrada (predictConfig) para modelos principales (solo en modo detallado)

Ejemplo: Listar modelos proporcionados por alibaba

bl model list --provider alibaba

• Ambos el catálogo y los puntos finales de esquema de parámetros --enrich son públicos; no se necesita inicio de sesión en la consola.
• El modo de navegación oculta los modelos que ya están fuera de línea; use --include-deprecated para incluirlos. El modo detallado (--model) siempre lista cada versión y marca su estado.

bl advisor recommend

Recomienda los mejores modelos para su caso de uso (análisis de intención → recuperación de candidatos → clasificación de LLM). Requiere autenticación con clave de API.

Uso

bl advisor recommend --message <text> [flags]

Parámetro	Tipo	Obligatorio	Descripción
--message <text>	string	Sí	Describa sus requisitos

Ejemplo: Recomendar los mejores modelos para un requerimiento de chatbot de comprensión visual

bl advisor recommend --message "I need a visual-understanding chatbot"

bl pipeline run

Ejecuta una definición de flujo de trabajo de pipeline. No se requiere autenticación.

Uso

bl pipeline run --file <path> [flags]

Parámetro	Tipo	Obligatorio	Descripción
--file <path>	string	Sí	Archivo de definición de pipeline (YAML/JSON)
--input <json>	string	No	Entrada en tiempo de ejecución como JSON incrustado
--input-file <path>	string	No	Entrada en tiempo de ejecución desde un archivo JSON
--concurrency <n>	number	No	Máximo número de pasos en paralelo (predeterminado: 1)
--events <format>	string	No	Emitir eventos de ciclo de vida: jsonl
--step-timeout <seconds>	number	No	Tiempo de espera predeterminado por paso en segundos

Ejemplo: Ejecutar flujo de trabajo de pipeline desde workflow.yaml con entrada {'brief':'hello'}

bl pipeline run --file workflow.yaml --input '{"brief":"hello"}'

bl pipeline validate

Valida una definición de pipeline sin ejecutarla. No se requiere autenticación.

Uso

bl pipeline validate --file <path>

Parámetro	Tipo	Obligatorio	Descripción
--file <path>	string	Sí	Archivo de definición de pipeline (YAML/JSON)

Ejemplo: Validar definición de pipeline desde archivo

bl pipeline validate --file workflow.yaml

bl plugin install

Instala o actualiza un paquete de Comandos permitido. No se requiere autenticación.

Uso

bl plugin install --package <name[@version]>

Parámetro	Tipo	Obligatorio	Descripción
--package <name[@version]>	string	Sí	Nombre del paquete de Comandos permitidos y versión o etiqueta opcional

Ejemplo: Instalar paquete de Comandos permitidos

bl plugin install --package @ali/bailian-plugin-agent

bl plugin list

Lista los paquetes de Comandos instalados y su estado de carga. No se requiere autenticación.

Uso

bl plugin list

Este comando solo admite opciones globales.

Ejemplo: Listar paquetes de Comandos instalados con salida en formato JSON

bl plugin list --output json

bl plugin remove

Elimina un paquete de Comandos instalado. No se requiere autenticación.

Uso

bl plugin remove --name <package>

Parámetro	Tipo	Obligatorio	Descripción
--name <package>	string	Sí	Nombre del paquete de Comandos permitidos

Ejemplo: Eliminar paquete de Comandos instalado por nombre

bl plugin remove --name @ali/bailian-plugin-agent

bl plugin link

Vincule un paquete de comandos local permitido para desarrollo. No se requiere autenticación.

Uso

bl plugin link --path <directory>

Parámetro	Tipo	Obligatorio	Descripción
--path <directory>	string	Sí	Directorio del paquete de comandos local

Ejemplo: Vincular paquete de comandos local para desarrollo

bl plugin link --path ../bailian-plugin-agent

bl workspace init

Inicialice el entorno de Bailian y active servicios de facturación postpago. No se requiere autenticación.

Uso

bl workspace init --access-key-id <id> --access-key-secret <secret> [--security-token <token>]

Parámetro	Tipo	Obligatorio	Descripción
--access-key-id <id>	string	No	ID de clave de acceso de Alibaba Cloud
--access-key-secret <secret>	string	No	Secreto de clave de acceso de Alibaba Cloud
--security-token <token>	string	No	Token de seguridad STS de Alibaba Cloud (opcional)

Ejemplo: Inicializar entorno con claves de acceso

bl workspace init --access-key-id LTAIxxxxx --access-key-secret xxxxx

bl workspace list

Liste todos los entornos.

Uso

bl workspace list [flags]

Parámetro	Tipo	Obligatorio	Descripción
--list <n>	string	No	Limitar el número de resultados

Ejemplo: Listar entornos con límite

bl workspace list --list 5

bl console call

Llame a una API de consola de Bailian a través de la puerta de enlace CLI.

Uso

bl console call --api <api> --data <json> [flags]

Parámetro	Tipo	Obligatorio	Descripción
--api <api>	string	Sí	Nombre de la API (por ejemplo, zeldaEasy.broadscope-bailian.memory-library.getLibraries)
--data <json>	string	Sí	Datos de solicitud como cadena JSON

Ejemplo: Llamar a la API de consola de Bailian con datos

bl console call --api zeldaEasy.bailian-commerce.freeTrial.queryFreeTierQuota --data '{"queryFreeTierQuotaRequest":{"models":["qwen3-max"]}}'

bl update

Actualice la CLI a la versión más reciente o a una versión especificada. No se requiere autenticación.

Uso

bl update [--to <version>]

Parámetro	Tipo	Obligatorio	Descripción
--to <version>	string	No	Instalar esta versión exacta en lugar de la más reciente

Ejemplo: Actualizar CLI a versión específica

bl update --to 0.1.14

Ejecute bl --help para ver todos los grupos de comandos.