Installation et authentification - Alibaba Cloud Model Studio

Installez la CLI Bailian et les Skills, configurez l'authentification et vérifiez.

Cette page explique comment installer la CLI Bailian, installer les Skills associées et configurer l'authentification.

Prérequis

Accès réseau (soit le registre npm, soit bailian.aliyun.com, selon la méthode d'installation que vous choisissez ci-dessous).
Pour la méthode npm : Node.js >= 18.17.0 (vérifiez avec node -v) et npm (vérifiez avec npm -v). Si vous n'avez pas Node.js, ou si votre version est trop ancienne, utilisez plutôt le script d'installation binaire ci-dessous — Node.js n'est pas requis.

Installer la CLI

npm (Node.js existant)

npm install -g bailian-cli

Même si pnpm / yarn est installé, utilisez npm pour installer bailian-cli — n'utilisez pas pnpm / yarn pour installer la CLI.

Script binaire (Node.js non requis)

macOS / Linux :

curl -fsSL https://bailian.aliyun.com/cli/install.sh | bash

Windows (PowerShell) :

irm https://bailian.aliyun.com/cli/install.ps1 | iex

Après l'installation, deux commandes sont ajoutées à votre PATH : bl (alias court) et bailian (nom complet). Vérifiez :

bl --version
which bl   # use "where bl" on Windows

Exécutez bl update à tout moment pour vérifier et installer la dernière version de la CLI.

RemarqueSi vous voyez command not found, vérifiez que le répertoire bin global est dans votre PATH : pour l'installation npm, exécutez npm config get prefix et ajoutez son sous-répertoire bin au PATH ; pour l'installation binaire, ajoutez le chemin imprimé par le script d'installation.

Installer les Skills

Une fois la CLI vérifiée, installez les Skills associées afin que votre Agent bénéficie de l'ensemble des capacités de Bailian. La méthode recommandée, en une seule étape, est la commande d'amorçage intégrée de la CLI :

bl skill init

Cela installe chaque Skill bailian-* dans le registre (ainsi que le bailian-protocol partagé) en une seule fois, et c'est le chemin d'installation officiellement recommandé. Si bl skill init n'est pas disponible, utilisez plutôt l'outil skills (il nécessite Git sur la machine ; le dernier package skills nécessite Node.js >= 22.20, donc épinglez skills@1.5.18 sur Node.js 18) :

npx skills@1.5.18 add modelstudioai/cli --skill '*' -g

Pour installer une seule Skill, remplacez --skill '*' par son nom ; --list affiche toutes les Skills du référentiel.

Configurer l'authentification

Vous devez vous authentifier avant d'appeler toute API. Choisissez l'une des méthodes ci-dessous en fonction de votre environnement.

Connexion à la console (recommandé)

Idéal pour les installations locales interactives — pas besoin de copier manuellement une API Key. Cette commande ouvre un navigateur pour terminer la connexion et l'autorisation de la console Alibaba Cloud :

bl auth login --console

Cela débloque également les fonctionnalités de la console telles que app list et usage free, et configure automatiquement les identifiants nécessaires pour les appels API Key.

API Key standard

Idéal pour les environnements où un navigateur ne peut pas être lancé (SSH à distance, CI, etc.). Obtenez une clé depuis la page Bailian console API Key, puis exécutez :

bl auth login --api-key <your_API_Key>

La commande de connexion teste la clé avant de l'enregistrer.

Token Plan

Utilisez la API Key de votre abonnement Token Plan :

bl auth login --config token-plan --api-key <your_API_Key>

Le profil token-plan est fourni avec une URL de base par défaut intégrée, aucune configuration de point de terminaison supplémentaire n'est donc nécessaire.

Jeton d'accès AK/SK

Pour générer un jeton d'accès CLI à partir d'une AccessKey Alibaba Cloud (par exemple, pour l'associer à des outils comme Postman). --access-key-id et --access-key-secret sont requis :

bl auth generate-access-token --access-key-id <AccessKey ID> --access-key-secret <AccessKey Secret>

Le jeton d'accès temporaire généré peut être utilisé pour les appels ultérieurs, évitant ainsi l'exposition à long terme de votre AK/SK ; ajoutez --security-token lors de l'utilisation d'identifiants temporaires STS.

Variable d'environnement

Non persisté dans un fichier de configuration — définissez DASHSCOPE_API_KEY dans votre shell (le point de terminaison peut être remplacé par BAILIAN_BASE_URL). Idéal pour les environnements CI / non interactifs ; injectez via la gestion des secrets plutôt que de coder en dur dans les scripts.

Les API Keys standard et les clés d'abonnement Token Plan diffèrent comme suit :

Aspect	API Key standard	Clé API Token Plan
Facturation	Paiement à l'usage (inclut le quota gratuit pour les nouveaux utilisateurs)	Déduit de votre quota d'abonnement Token Plan
Portée	Appels de service de modèle	Appels aux modèles pris en charge par le Token Plan
Utilisation typique	Pas d'abonnement, ou paiement à l'usage	Abonnés au Token Plan consommant d'abord le quota du plan
Configuration	`bl auth login --api-key <Key>`	`bl auth login --config token-plan --api-key <sk-sp-Key>`

Vérifier

La commande de connexion teste déjà la fonctionnalité, vous n'avez donc qu'à confirmer l'état de la configuration :

bl auth status --output json

Aucun test d'appel de modèle répété n'est nécessaire. Si la connexion échoue, utilisez le hint ou le message dans la sortie pour le dépannage (réseau, clé invalide, base_url, etc.).

AvertissementLorsque vous signalez l'état de l'authentification, utilisez uniquement les champs masqués. N'affichez jamais une clé API complète et n'écrivez pas de vraies clés dans les référentiels, les journaux ou les parties publiques des enregistrements de chat.

Se déconnecter

Pour effacer les identifiants locaux et vous déconnecter, exécutez :

bl auth logout

Dépannage

bl : commande introuvable

Le répertoire bin global n'est pas dans votre PATH. Exécutez npm config get prefix et ajoutez son sous-répertoire bin au PATH, puis réessayez.

Erreur d'engines lors de l'installation

Version de Node.js trop ancienne. Mettez à niveau vers >= 18.17.0 et réinstallez.

401 / échec de l'authentification

Non connecté ou clé API invalide. Réexécutez la commande de connexion pour votre type de clé (clé API standard ou Token Plan).

Pourquoi un appel de modèle CLI ne déduit-il pas de mon Token Plan ?

L'identifiant actif est une clé API standard (le profil default). Le Token Plan nécessite que votre clé API d'abonnement soit connectée au profil token-plan ; exécutez bl auth status --output json pour voir quel identifiant est actif.

Comment faire pour que les appels de modèle CLI utilisent mon Token Plan ?

Connectez-vous avec votre clé API d'abonnement : bl auth login --config token-plan --api-key <sk-sp-Key>. Si le profil existe déjà, basculez vers celui-ci avec bl config use --name token-plan.

Puis-je utiliser toutes les fonctionnalités de la CLI avec uniquement une clé API Token Plan ?

Non. Les commandes d'appel de modèle fonctionnent ; les fonctionnalités de la console (telles que app list, usage free, workspace) nécessitent une connexion à la console (bl auth login --console), et la gestion des postes du Token Plan nécessite en outre des identifiants AK/SK OpenAPI Alibaba Cloud. Consultez Configurer l'authentification pour la comparaison.

Comment vérifier et changer la clé API active ?

Exécutez bl auth status --output json pour inspecter l'identifiant actif (masqué), bl config list pour lister tous les profils, et bl config use --name <profile> pour changer le profil actif.

Le réseau d'entreprise ne peut pas atteindre npm

Configurez un miroir ou un proxy, puis réinstallez.

Seul pnpm est disponible, pas de npm

Utilisez plutôt le script d'installation binaire (Node.js/npm non requis) : curl -fsSL https://bailian.aliyun.com/cli/install.sh | bash. Vous pouvez également installer ou réparer npm d'abord, puis utiliser npm install -g bailian-cli — mais n'utilisez pas pnpm / yarn pour installer la CLI.