Alibaba Cloud Model Studio:Configuration & Outils

Référence de commande CLI Bailian pour la configuration d'authentification, la gestion des profils, le marché des modèles, le téléchargement de fichiers et les outils généraux.

Gérez l'authentification CLI, basculez entre les profils, explorez le marché des modèles, téléchargez des fichiers et utilisez des outils généraux depuis le terminal.

Authentification

bl auth login

Authentifiez-vous avec une clé API, une connexion via navigateur console ou OpenAPI AK/SK (les identifiants peuvent coexister). Aucune authentification requise.

Utilisation

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

Paramètre	Type	Obligatoire	Description
--api-key <key>	string	Non	Clé API du modèle à valider et stocker
--base-url <url>	string	Non	URL de base de l'API modèle à valider et stocker avec --api-key
--console	switch	Non	Se connecter via le navigateur (Chine par défaut ; utilisez --console-site international pour le site international). Crée une clé API ordinaire si nécessaire ; les plans d'abonnement exigent --api-key
--console-site <site>	string	Non	Site de la console : domestique, international
--open-api	switch	Non	Stocker les identifiants Alibaba Cloud OpenAPI AK/SK
--access-key-id <id>	string	Non	ID de clé d'accès Alibaba Cloud à stocker
--access-key-secret <secret>	string	Non	Secret de clé d'accès Alibaba Cloud à stocker

Exemple : S'authentifier via connexion par navigateur pour la console

bl auth login --console

bl auth status

Affiche l'état d'authentification actuel. Aucune authentification requise.

Utilisation

bl auth status

Cette commande ne prend en charge que les options globales.

Exemple : Afficher l'état d'authentification en sortie JSON

bl auth status --output json

bl auth logout

Efface les identifiants stockés ; la déconnexion complète efface également l'URL de base du modèle. Aucune authentification requise.

Utilisation

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

Paramètre	Type	Obligatoire	Description
--console	switch	Non	Effacer uniquement le access_token de la console, garder api_key intact
--open-api	switch	Non	Effacer uniquement les identifiants OpenAPI AK/SK/STS, garder les autres identifiants intacts

Exemple : Effacer uniquement le access_token de la console

bl auth logout --console

bl auth generate-access-token

Génère un jeton d'accès CLI à l'aide d'AK/SK OpenAPI. Aucune authentification requise.

Utilisation

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

Paramètre	Type	Obligatoire	Description
--access-key-id <id>	string	Oui	ID de clé d'accès Alibaba Cloud
--access-key-secret <secret>	string	Oui	Secret de clé d'accès Alibaba Cloud
--security-token <token>	string	Non	Jeton de sécurité STS Alibaba Cloud à stocker (facultatif)

Exemple : Générer un jeton d'accès CLI avec AK/SK et un jeton STS facultatif

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

Configuration

bl config set

Définit une valeur de configuration. Aucune authentification requise.

Utilisation

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

Paramètre	Type	Obligatoire	Description
--key <key>	string	Oui	Clé de configuration (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	Oui	Valeur à définir

Exemple : Définir la clé de configuration language sur zh-CN

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

bl config show

Affiche la configuration actuelle. Aucune authentification requise.

Utilisation

bl config show

Cette commande ne prend en charge que les options globales.

Exemple : Afficher la configuration actuelle en sortie JSON

bl config show --output json

bl config list

Liste les profils de configuration et affiche le profil actif. Aucune authentification requise.

Utilisation

bl config list

Cette commande ne prend en charge que les options globales.

Exemple : Liste des profils de configuration avec le profil actif en sortie JSON

bl config list --output json

bl config use

Définit le profil de configuration actif. Aucune authentification requise.

Utilisation

bl config use --name <name>

Paramètre	Type	Obligatoire	Description
--name <name>	string	Oui	Nom de profil existant, ou par défaut

Exemple : Définir le profil de configuration actif sur token-plan

bl config use --name token-plan

bl config ui

Ouvre une interface web locale pour gérer les profils de configuration. Aucune authentification requise.

Utilisation

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

Paramètre	Type	Obligatoire	Description
--port <port>	number	Non	Port sur lequel écouter (par défaut : port libre aléatoire)
--no-open	switch	Non	Ne pas ouvrir automatiquement le navigateur

Exemple : Ouvrir l'interface web de gestion de configuration sur le port 8787

bl config ui --port 8787

bl config agent

Configurer un agent de codage pour utiliser l'API DashScope. Aucune authentification requise.

Utilisation

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

Paramètre	Type	Requis	Description
--agent <name>	string	Oui	Agent cible : claude-code, qwen-code, opencode, openclaw, hermes, codex
--base-url <url>	string	Non	URL de base de l'API
--region <region>	string	Non	Région Model Studio (par exemple, cn-beijing, ap-southeast-1) ; convertie en --base-url. Uniquement pour le plan Token
--api-key <key>	string	Non	Clé API
--key <encoded>	string	Non	Clé API obfusquée provenant de la console web (commence par "o1_") ; décodée en --api-key
--model <model>	string	Oui	Nom du modèle par défaut
--context-window <tokens>	number	Non	uniquement OpenClaw : taille de fenêtre contextuelle du modèle en jetons (par défaut : 256000)
--wire-api <api>	string	Non	uniquement Codex : protocole de transmission (par défaut : responses). "chat" ne fonctionne qu’avec Codex hérité <= 0.80.0

Exemple : Configurer l'agent de codage pour utiliser l'API DashScope avec les paramètres spécifiés

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

Outils généraux

bl file upload

Télécharger un fichier local vers le stockage temporaire DashScope (48h). Nécessite une authentification par clé API.

Utilisation

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

Paramètre	Type	Requis	Description
--file <path>	string	Oui	Fichier local à télécharger (image, vidéo, audio)
--model <model>	string	Oui	Nom du modèle cible (le fichier est lié à ce modèle)

Exemple : Télécharger photo.jpg vers le stockage DashScope lié au modèle qwen3-vl-plus

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

bl model list

Parcourir les familles de modèles ou afficher les informations détaillées sur les modèles dans le marché des modèles Bailian. Aucune authentification requise.

Utilisation

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]

Paramètre	Type	Requis	Description
--model <model>	string	Non	Afficher les détails complets d'une famille de modèles spécifique (active le mode détaillé)
--page <n>	number	Non	Numéro de page (par défaut : 1)
--page-size <n>	number	Non	Nombre de résultats par page (par défaut : 10)
--provider <p>	array	Non	Filtrer par fournisseur (répétable, par exemple --provider alibaba --provider deepseek)
--capability <c>	array	Non	Filtrer par code de capacité (TG, Reasoning, VU, IG, VG, TTS, ASR, …)
--feature <f>	array	Non	Filtrer par fonctionnalité (function-calling, web-search, structured-outputs, …)
--context-window <w>	array	Non	Filtrer par plage de taille de fenêtre contextuelle
--input-modality <m>	array	Non	Exiger une modalité d'entrée (répétable : Text, Image, Video, Audio)
--output-modality <m>	array	Non	Exiger une modalité de sortie (répétable : Text, Image, Video, Audio)
--include-deprecated	switch	Non	Inclure les modèles déjà hors ligne (masqués par défaut)
--enrich	switch	Non	Récupérer également le schéma des paramètres d'entrée (predictConfig) pour les modèles principaux (mode détaillé uniquement)

Exemple : Répertorier les modèles fournis par alibaba

bl model list --provider alibaba

• Le catalogue et les points de terminaison --enrich pour le schéma de paramètres sont publics — aucune connexion à la console n’est nécessaire.
• Le mode navigation masque les modèles déjà hors ligne ; utilisez --include-deprecated pour les inclure. Le mode détaillé (--model) affiche toujours chaque version et indique son statut.

bl advisor recommend

Recommander les meilleurs modèles pour votre cas d'utilisation (analyse d'intention → rappel des candidats → classement LLM). Nécessite une authentification par clé API.

Utilisation

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

Paramètre	Type	Requis	Description
--message <text>	string	Oui	Décrire vos exigences

Exemple : Recommander les meilleurs modèles pour une demande de chatbot à compréhension visuelle

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

bl pipeline run

Exécuter une définition de flux de travail de pipeline. Aucune authentification requise.

Utilisation

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

Paramètre	Type	Requis	Description
--file <path>	string	Oui	Fichier de définition du pipeline (YAML/JSON)
--input <json>	string	Non	Entrée en temps réel sous forme de JSON inline
--input-file <path>	string	Non	Entrée en temps réel provenant d'un fichier JSON
--concurrency <n>	number	Non	Nombre maximal d'étapes parallèles (par défaut : 1)
--events <format>	string	Non	Émettre des événements de cycle de vie : jsonl
--step-timeout <seconds>	number	Non	Délai d'expiration par défaut de l'étape en secondes

Exemple : Exécuter un flux de travail de pipeline à partir de workflow.yaml avec l'entrée {'brief':'hello'}

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

bl pipeline validate

Valider une définition de pipeline sans l'exécuter. Aucune authentification requise.

Utilisation

bl pipeline validate --file <path>

Paramètre	Type	Requis	Description
--file <path>	string	Oui	Fichier de définition du pipeline (YAML/JSON)

Exemple : Valider une définition de pipeline à partir d’un fichier

bl pipeline validate --file workflow.yaml

bl plugin install

Installer ou mettre à jour un Pack de commandes autorisé. Aucune authentification requise.

Utilisation

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

Paramètre	Type	Requis	Description
--package <name[@version]>	string	Oui	Nom du Pack de commandes autorisé et éventuelle version ou balise

Exemple : Installer un Pack de commandes autorisé

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

bl plugin list

Répertorier les Packs de commandes installés et leur état de chargement. Aucune authentification requise.

Utilisation

bl plugin list

Cette commande ne prend en charge que les options globales.

Exemple : Répertorier les Packs de commandes installés avec sortie JSON

bl plugin list --output json

bl plugin remove

Supprimer un Pack de commandes installé. Aucune authentification requise.

Utilisation

bl plugin remove --name <package>

Paramètre	Type	Requis	Description
--name <package>	string	Oui	Nom du Pack de commandes autorisé

Exemple : Supprimer un Pack de commandes installé par son nom

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

bl plugin link

Lier un pack de commandes local autorisé pour le développement. Aucune authentification requise.

Utilisation

bl plugin link --path <directory>

Paramètre	Type	Requis	Description
--path <directory>	string	Oui	Répertoire du package du pack de commandes local

Exemple : Lier le pack de commandes local pour le développement

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

bl workspace init

Initialiser l'espace de travail Bailian et activer les services postpayés. Aucune authentification requise.

Utilisation

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

Paramètre	Type	Requis	Description
--access-key-id <id>	string	Non	Identifiant de clé d'accès Alibaba Cloud
--access-key-secret <secret>	string	Non	Secret de clé d'accès Alibaba Cloud
--security-token <token>	string	Non	Jeton de sécurité STS Alibaba Cloud (facultatif)

Exemple : Initialiser l'espace de travail avec des clés d'accès

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

bl workspace list

Lister tous les espaces de travail.

Utilisation

bl workspace list [flags]

Paramètre	Type	Requis	Description
--list <n>	string	Non	Limiter le nombre de résultats

Exemple : Lister les espaces de travail avec une limite

bl workspace list --list 5

bl console call

Appeler une API console Bailian via la passerelle CLI.

Utilisation

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

Paramètre	Type	Requis	Description
--api <api>	string	Oui	Nom de l'API (par exemple : zeldaEasy.broadscope-bailian.memory-library.getLibraries)
--data <json>	string	Oui	Données de requête sous forme de chaîne JSON

Exemple : Appeler l'API console Bailian avec des données

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

bl update

Mettre à jour le CLI vers la dernière version ou une version spécifiée. Aucune authentification requise.

Utilisation

bl update [--to <version>]

Paramètre	Type	Requis	Description
--to <version>	string	Non	Installer cette version exacte au lieu de la dernière

Exemple : Mettre à jour le CLI vers une version spécifique

bl update --to 0.1.14

Exécutez bl --help pour afficher tous les groupes de commandes.