Skip to main content

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.
Ajoutez --help à toute commande pour obtenir les détails complets des paramètres, par exemple bl config show --help. Tous les paramètres qui acceptent une URL de fichier acceptent également un chemin local — le CLI télécharge automatiquement le fichier vers un stockage temporaire (valide pendant 48 heures), vous n'avez donc jamais besoin d'héberger vous-même des fichiers en tant qu'URL. Les détails des commandes de cette page sont vérifiés avec bl 2.8.0. Les indicateurs globaux peuvent précéder le chemin complet de la commande, par exemple bl --config token-plan auth status ; les indicateurs propres à la commande et les identifiants doivent toujours suivre le chemin.

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 [--no-browser | --token-stdin --console-region <region>] | --open-api --access-key-id <id> --access-key-secret <secret>
ParamètreTypeObligatoireDescription
--api-key <key>stringNonClé API du modèle à valider et stocker
--base-url <url>stringNonURL de base de l'API modèle à valider et stocker avec --api-key
--consoleswitchNonSe 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
--no-browserswitchnonAvec --console, affiche l'URL de connexion sans ouvrir de navigateur
--token-stdinswitchnonAvec --console, lit et valide un jeton d'accès console depuis stdin ; nécessite --console-region et n'ouvre ni navigateur ni serveur local
--console-region <region>stringnonRégion de la passerelle console (par ex. cn-beijing, ap-southeast-1)
--console-site <site>stringNonSite de la console : domestique, international
--open-apiswitchNonStocker les identifiants Alibaba Cloud OpenAPI AK/SK
--access-key-id <id>stringNonID de clé d'accès Alibaba Cloud à stocker
--access-key-secret <secret>stringNonSecret de clé d'accès Alibaba Cloud à stocker
Exemple : S'authentifier via connexion par navigateur pour la console
bl auth login --console --console-site international
  • Si aucun navigateur ne peut être ouvert, utilisez bl auth login --console --console-site international --no-browser pour afficher l'URL de connexion, ou importez un jeton d'accès depuis stdin avec --token-stdin.
  • L'AK/SK OpenAPI est résolu comme un groupe complet dans cet ordre : paramètres de commande, BAILIAN_ACCESS_KEY_ID / BAILIAN_ACCESS_KEY_SECRET, configuration Bailian, puis ALIBABA_CLOUD_ACCESS_KEY_ID / ALIBABA_CLOUD_ACCESS_KEY_SECRET. Les champs ne sont pas combinés entre sources. Les jetons STS proviennent de la même source : BAILIAN_SECURITY_TOKEN, la clé de configuration security_token ou ALIBABA_CLOUD_SECURITY_TOKEN.
  • Les commandes métier de la console n'acceptent pas de flags AK/SK temporaires. Si le jeton de console est absent ou expiré, la CLI en obtient un automatiquement avec l'AK/SK disponible, avec au plus un échange par requête.

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ètreTypeObligatoireDescription
--consoleswitchNonEffacer uniquement le access_token de la console, garder api_key intact
--open-apiswitchNonEffacer 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ètreTypeObligatoireDescription
--access-key-id <id>stringOuiID de clé d'accès Alibaba Cloud
--access-key-secret <secret>stringOuiSecret de clé d'accès Alibaba Cloud
--security-token <token>stringNonJeton 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ètreTypeObligatoireDescription
--key <key>stringOuiClé 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>stringOuiValeur à 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
  • Affiche les sources effectives de la clé API et de la Base URL et signale lorsque la requête utilise des valeurs issues de sources de configuration différentes.

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ètreTypeObligatoireDescription
--name <name>stringOuiNom 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ètreTypeObligatoireDescription
--port <port>numberNonPort sur lequel écouter (par défaut : port libre aléatoire)
--no-openswitchNonNe 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ètreTypeRequisDescription
--agent <name>stringOuiAgent cible : claude-code, qwen-code, opencode, openclaw, hermes, codex, pi
--base-url <url>stringNonURL de base de l'API
--region <region>stringNonRégion Model Studio (par exemple, cn-beijing, ap-southeast-1) ; convertie en --base-url. Uniquement pour le plan Token
--api-key <key>stringNonClé API
--key <encoded>stringNonClé API obfusquée provenant de la console web (commence par "o1_") ; décodée en --api-key
--model <model>stringOuiNom du modèle par défaut
--context-window <tokens>numberNonuniquement OpenClaw : taille de fenêtre contextuelle du modèle en jetons (par défaut : 256000)
--wire-api <api>stringNonuniquement 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-intl.aliyuncs.com/apps/anthropic --api-key sk-xxxxx --model qwen3-max

Sortie et diagnostics

Le format de sortie par défaut est text. Passez à JSON avec --output json, DASHSCOPE_OUTPUT=json ou la clé de configuration output.
  • Le mode JSON renvoie le résultat métier complet sur stdout. Les avertissements, diagnostics et erreurs sont écrits séparément sur stderr au format JSONL, afin que les scripts et les agents puissent les analyser indépendamment.
  • Le mode quiet masque uniquement la progression et les messages de processus, tout en conservant les résultats complets, les avertissements et les erreurs. Définissez DASHSCOPE_QUIET=1 pour activer quiet. Les scripts qui extrayaient des ID, chemins ou réponses depuis quiet doivent lire les champs JSON.
  • --introspect affiche le schéma de commande lisible par machine (JSON) puis quitte, afin que les agents puissent découvrir les commandes et paramètres.
  • La connexion interactive, l'interface de configuration locale et les flux d'événements Pipeline utilisent la sortie text. Pour obtenir du JSON en sortie audio en streaming, indiquez un fichier avec --out.

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ètreTypeRequisDescription
--file <path>stringOuiFichier local à télécharger (image, vidéo, audio)
--model <model>stringOuiNom 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
  • Le service d'upload est choisi à partir de l'Endpoint du modèle actif. Les uploads temporaires officiels ne prennent en charge que les régions Pékin et Singapour ; les régions non prises en charge et Token Plan échouent explicitement.
  • Un proxy d'upload personnalisé explicitement spécifié n'est plus rejeté selon le type de clé.
  • Les uploads de fichiers locaux vers l'OSS temporaire respectent --timeout.

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ètreTypeRequisDescription
--model <model>stringNonAfficher les détails complets d'une famille de modèles spécifique (active le mode détaillé)
--page <n>numberNonNuméro de page (par défaut : 1)
--page-size <n>numberNonNombre de résultats par page (par défaut : 10)
--provider <p>arrayNonFiltrer par fournisseur (répétable, par exemple --provider alibaba --provider deepseek)
--capability <c>arrayNonFiltrer par code de capacité (TG, Reasoning, VU, IG, VG, TTS, ASR, …)
--feature <f>arrayNonFiltrer par fonctionnalité (function-calling, web-search, structured-outputs, …)
--context-window <w>arrayNonFiltrer par plage de taille de fenêtre contextuelle
--input-modality <m>arrayNonExiger une modalité d'entrée (répétable : Text, Image, Video, Audio)
--output-modality <m>arrayNonExiger une modalité de sortie (répétable : Text, Image, Video, Audio)
--include-deprecatedswitchNonInclure les modèles déjà hors ligne (masqués par défaut)
--enrichswitchNonRé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.
Recherche dans le catalogue de modèles par mot-clé, classée par pertinence. Aucune authentification requise. Utilisation
bl model search --keyword <kw> [--limit <n>] [--provider <p>...] [--capability <c>...] [--feature <f>...] [--context-window <w>...] [--input-modality <m>...] [--output-modality <m>...] [--include-deprecated]
ParamètreTypeObligatoireDescription
--keyword <kw>stringOuiMot-clé comparé à l’ID, au nom, aux capacités, aux fonctionnalités et à la description du modèle
--limit <n>numberNonNombre maximal de résultats (par défaut : 20)
--provider <p>arrayNonFiltrer par fournisseur (répétable, par ex. --provider alibaba --provider deepseek)
--capability <c>arrayNonFiltrer par code de capacité (TG, Reasoning, VU, IG, VG, TTS, ASR, etc.)
--feature <f>arrayNonFiltrer par fonctionnalité (function-calling, web-search, structured-outputs, etc.)
--context-window <w>arrayNonFiltrer par plage de fenêtre de contexte
--input-modality <m>arrayNonExiger une modalité d’entrée (Text, Image, Video, Audio)
--output-modality <m>arrayNonExiger une modalité de sortie (Text, Image, Video, Audio)
--include-deprecatedswitchNonInclure les modèles déjà hors ligne
Exemple:Rechercher les modèles dont le nom contient qwen
bl model search --keyword qwen
  • La recherche parcourt tout le catalogue mais masque les modèles hors ligne par défaut ; utilisez --include-deprecated pour les inclure.
  • L’API du catalogue de modèles est publique ; aucune connexion à la console n’est nécessaire.

bl model code

Affiche un exemple SDK prêt à l'emploi pour appeler un modèle. Aucune authentification requise. Utilisation
bl model code --model <model> [--sdk <sdk>] [--api <style>] [--lang <lang>]
ParamètreTypeObligatoireDescription
--model <model>stringOuiModèle pour lequel générer un exemple
--sdk <sdk>stringNonType de SDK : openai (par défaut) ou dashscope
--api <style>stringNonStyle d’API : completions (par défaut) ou responses
--lang <lang>stringNonLangage de l’extrait (par défaut : python) ; indiquez une valeur non prise en charge pour lister les options
Exemple:Générer un exemple Python pour qwen-max
bl model code --model qwen-max
Exemple:Générer un exemple curl pour qwen-max
bl model code --model qwen-max --lang curl
  • La sortie texte contient uniquement l’extrait ; vous pouvez la rediriger vers un fichier. Utilisez --output json pour obtenir l’extrait et ses métadonnées.
  • L’URL de base de l’exemple contient un espace réservé [workspace-id]. Remplacez-le, ou définissez BAILIAN_WORKSPACE_ID et utilisez l’endpoint DashScope.
  • Les combinaisons disponibles sont publiées par modèle ; indiquez une valeur inconnue pour afficher la liste.
  • --api accepte completions ou responses ; il est ignoré lorsque le SDK ne prend en charge qu'un seul style.

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ètreTypeRequisDescription
--message <text>stringOuiDécrire vos exigences
--top <n>numbernonNombre de recommandations (par défaut : 3)
--model <model>stringnonLLM utilisé à chaque étape : agent, intention, score et explication (par défaut : qwen-flash-2025-07-28)
--no-agentswitchnonIgnore la boucle d'agent et exécute directement le moteur déterministe
--traceswitchnonÉcrit la trace complète de routage et de performance sur stderr
--thinkswitchnonAffiche le processus de décision du moteur sur stderr
--no-thinkingswitchnonParamètre de compatibilité obsolète, sans effet ; les appels de recommandation désactivent toujours le mode réflexion
Exemple : Recommander les meilleurs modèles pour une demande de chatbot à compréhension visuelle
bl advisor recommend --message "I need a visual-understanding chatbot"
Exemple : Ignorer la clarification de l'Agent et exécuter directement le moteur de recommandation
bl advisor recommend --message "Créer une diffusion en direct d'humain numérique" --no-agent
  • Le flux de recommandation suit analyse d'intention → routage → rappel des candidats → score → classement. Les terminaux interactifs prennent en charge les clarifications de l'agent et les recommandations en plusieurs étapes, tout en conservant la structure JSON du résultat.
  • --trace et --think écrivent uniquement sur stderr et ne modifient pas le résultat de recommandation sur stdout.

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ètreTypeRequisDescription
--file <path>stringOuiFichier de définition du pipeline (YAML/JSON)
--input <json>stringNonEntrée en temps réel sous forme de JSON inline
--input-file <path>stringNonEntrée en temps réel provenant d'un fichier JSON
--concurrency <n>numberNonNombre maximal d'étapes parallèles (par défaut : 1)
--events <format>stringNonÉmettre des événements de cycle de vie : jsonl
--step-timeout <seconds>numberNonDé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"}'
  • --events jsonl utilise le mode de sortie texte. Les flux d'événements Pipeline ne peuvent pas être mélangés avec d'autres formats de sortie.

bl pipeline validate

Valider une définition de pipeline sans l'exécuter. Aucune authentification requise. Utilisation
bl pipeline validate --file <path>
ParamètreTypeRequisDescription
--file <path>stringOuiFichier 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ètreTypeRequisDescription
--package <name[@version]>stringOuiNom 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ètreTypeRequisDescription
--name <package>stringOuiNom du Pack de commandes autorisé
Exemple : Supprimer un Pack de commandes installé par son nom
bl plugin remove --name @ali/bailian-plugin-agent
Lier un pack de commandes local autorisé pour le développement. Aucune authentification requise. Utilisation
bl plugin link --path <directory>
ParamètreTypeRequisDescription
--path <directory>stringOuiRé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ètreTypeRequisDescription
--access-key-id <id>stringNonIdentifiant de clé d'accès Alibaba Cloud
--access-key-secret <secret>stringNonSecret de clé d'accès Alibaba Cloud
--security-token <token>stringNonJeton 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ètreTypeRequisDescription
--list <n>stringNonLimiter 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ètreTypeRequisDescription
--api <api>stringOuiNom de l'API (par exemple : zeldaEasy.broadscope-bailian.memory-library.getLibraries)
--data <json>stringOuiDonné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ètreTypeRequisDescription
--to <version>stringNonInstaller 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
  • bl update renvoie un code de sortie non nul en cas d'échec de la mise à niveau ou si la dernière version est introuvable.
Exécutez bl --help pour afficher tous les groupes de commandes.