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.
Authentifiez-vous avec une clé API, une connexion via navigateur console ou OpenAPI AK/SK (les identifiants peuvent coexister). Aucune authentification requise.
Utilisation
Exemple : S'authentifier via connexion par navigateur pour la console
Affiche l'état d'authentification actuel. Aucune authentification requise.
Utilisation
Cette commande ne prend en charge que les options globales.
Exemple : Afficher l'état d'authentification en sortie JSON
Efface les identifiants stockés ; la déconnexion complète efface également l'URL de base du modèle. Aucune authentification requise.
Utilisation
Exemple : Effacer uniquement le access_token de la console
Génère un jeton d'accès CLI à l'aide d'AK/SK OpenAPI. Aucune authentification requise.
Utilisation
Exemple : Générer un jeton d'accès CLI avec AK/SK et un jeton STS facultatif
Définit une valeur de configuration. Aucune authentification requise.
Utilisation
Exemple : Définir la clé de configuration language sur zh-CN
Affiche la configuration actuelle. Aucune authentification requise.
Utilisation
Cette commande ne prend en charge que les options globales.
Exemple : Afficher la configuration actuelle en sortie JSON
Liste les profils de configuration et affiche le profil actif. Aucune authentification requise.
Utilisation
Cette commande ne prend en charge que les options globales.
Exemple : Liste des profils de configuration avec le profil actif en sortie JSON
Définit le profil de configuration actif. Aucune authentification requise.
Utilisation
Exemple : Définir le profil de configuration actif sur token-plan
Ouvre une interface web locale pour gérer les profils de configuration. Aucune authentification requise.
Utilisation
Exemple : Ouvrir l'interface web de gestion de configuration sur le port 8787
Configurer un agent de codage pour utiliser l'API DashScope. Aucune authentification requise.
Utilisation
Exemple : Configurer l'agent de codage pour utiliser l'API DashScope avec les paramètres spécifiés
Le format de sortie par défaut est text. Passez à JSON avec
Télécharger un fichier local vers le stockage temporaire DashScope (48h). Nécessite une authentification par clé API.
Utilisation
Exemple : Télécharger photo.jpg vers le stockage DashScope lié au modèle qwen3-vl-plus
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
Exemple : Répertorier les modèles fournis par alibaba
Recherche dans le catalogue de modèles par mot-clé, classée par pertinence. Aucune authentification requise.
Utilisation
Exemple:Rechercher les modèles dont le nom contient qwen
Affiche un exemple SDK prêt à l'emploi pour appeler un modèle. Aucune authentification requise.
Utilisation
Exemple:Générer un exemple Python pour qwen-max
Exemple:Générer un exemple curl pour qwen-max
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
Exemple : Recommander les meilleurs modèles pour une demande de chatbot à compréhension visuelle
Exemple : Ignorer la clarification de l'Agent et exécuter directement le moteur de recommandation
Exécuter une définition de flux de travail de pipeline. Aucune authentification requise.
Utilisation
Exemple : Exécuter un flux de travail de pipeline à partir de workflow.yaml avec l'entrée {'brief':'hello'}
Valider une définition de pipeline sans l'exécuter. Aucune authentification requise.
Utilisation
Exemple : Valider une définition de pipeline à partir d’un fichier
Installer ou mettre à jour un Pack de commandes autorisé. Aucune authentification requise.
Utilisation
Exemple : Installer un Pack de commandes autorisé
Répertorier les Packs de commandes installés et leur état de chargement. Aucune authentification requise.
Utilisation
Cette commande ne prend en charge que les options globales.
Exemple : Répertorier les Packs de commandes installés avec sortie JSON
Supprimer un Pack de commandes installé. Aucune authentification requise.
Utilisation
Exemple : Supprimer un Pack de commandes installé par son nom
Lier un pack de commandes local autorisé pour le développement. Aucune authentification requise.
Utilisation
Exemple : Lier le pack de commandes local pour le développement
Initialiser l'espace de travail Bailian et activer les services postpayés. Aucune authentification requise.
Utilisation
Exemple : Initialiser l'espace de travail avec des clés d'accès
Lister tous les espaces de travail.
Utilisation
Exemple : Lister les espaces de travail avec une limite
Appeler une API console Bailian via la passerelle CLI.
Utilisation
Exemple : Appeler l'API console Bailian avec des données
Mettre à jour le CLI vers la dernière version ou une version spécifiée. Aucune authentification requise.
Utilisation
Exemple : Mettre à jour le CLI vers une version spécifique
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
| 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 |
--no-browser | switch | non | Avec --console, affiche l'URL de connexion sans ouvrir de navigateur |
--token-stdin | switch | non | Avec --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> | string | non | Région de la passerelle console (par ex. cn-beijing, ap-southeast-1) |
--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 |
-
Si aucun navigateur ne peut être ouvert, utilisez
bl auth login --console --console-site international --no-browserpour 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, puisALIBABA_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 configurationsecurity_tokenouALIBABA_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 logout
Efface les identifiants stockés ; la déconnexion complète efface également l'URL de base du modèle. Aucune authentification requise.
Utilisation
| 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 |
bl auth generate-access-token
Génère un jeton d'accès CLI à l'aide d'AK/SK OpenAPI. Aucune authentification requise.
Utilisation
| 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) |
Configuration
bl config set
Définit une valeur de configuration. Aucune authentification requise.
Utilisation
| 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 |
bl config show
Affiche la configuration actuelle. Aucune authentification requise.
Utilisation
- 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 use
Définit le profil de configuration actif. Aucune authentification requise.
Utilisation
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
--name <name> | string | Oui | Nom de profil existant, ou par défaut |
bl config ui
Ouvre une interface web locale pour gérer les profils de configuration. Aucune authentification requise.
Utilisation
| 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 |
bl config agent
Configurer un agent de codage pour utiliser l'API DashScope. Aucune authentification requise.
Utilisation
| Paramètre | Type | Requis | Description |
|---|---|---|---|
--agent <name> | string | Oui | Agent cible : claude-code, qwen-code, opencode, openclaw, hermes, codex, pi |
--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 |
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=1pour activer quiet. Les scripts qui extrayaient des ID, chemins ou réponses depuis quiet doivent lire les champs JSON. --introspectaffiche 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
| 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) |
- 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
| 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) |
- 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 model search
Recherche dans le catalogue de modèles par mot-clé, classée par pertinence. Aucune authentification requise.
Utilisation
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
--keyword <kw> | string | Oui | Mot-clé comparé à l’ID, au nom, aux capacités, aux fonctionnalités et à la description du modèle |
--limit <n> | number | Non | Nombre maximal de résultats (par défaut : 20) |
--provider <p> | array | Non | Filtrer par fournisseur (répétable, par ex. --provider alibaba --provider deepseek) |
--capability <c> | array | Non | Filtrer par code de capacité (TG, Reasoning, VU, IG, VG, TTS, ASR, etc.) |
--feature <f> | array | Non | Filtrer par fonctionnalité (function-calling, web-search, structured-outputs, etc.) |
--context-window <w> | array | Non | Filtrer par plage de fenêtre de contexte |
--input-modality <m> | array | Non | Exiger une modalité d’entrée (Text, Image, Video, Audio) |
--output-modality <m> | array | Non | Exiger une modalité de sortie (Text, Image, Video, Audio) |
--include-deprecated | switch | Non | Inclure les modèles déjà hors ligne |
- 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
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
--model <model> | string | Oui | Modèle pour lequel générer un exemple |
--sdk <sdk> | string | Non | Type de SDK : openai (par défaut) ou dashscope |
--api <style> | string | Non | Style d’API : completions (par défaut) ou responses |
--lang <lang> | string | Non | Langage de l’extrait (par défaut : python) ; indiquez une valeur non prise en charge pour lister les options |
- 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.
--apiacceptecompletionsouresponses; 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
| Paramètre | Type | Requis | Description |
|---|---|---|---|
--message <text> | string | Oui | Décrire vos exigences |
--top <n> | number | non | Nombre de recommandations (par défaut : 3) |
--model <model> | string | non | LLM utilisé à chaque étape : agent, intention, score et explication (par défaut : qwen-flash-2025-07-28) |
--no-agent | switch | non | Ignore la boucle d'agent et exécute directement le moteur déterministe |
--trace | switch | non | Écrit la trace complète de routage et de performance sur stderr |
--think | switch | non | Affiche le processus de décision du moteur sur stderr |
--no-thinking | switch | non | Paramètre de compatibilité obsolète, sans effet ; les appels de recommandation désactivent toujours le mode réflexion |
- 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.
--traceet--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
| 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 |
--events jsonlutilise 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
| Paramètre | Type | Requis | Description |
|---|---|---|---|
--file <path> | string | Oui | Fichier de définition du pipeline (YAML/JSON) |
bl plugin install
Installer ou mettre à jour un Pack de commandes autorisé. Aucune authentification requise.
Utilisation
| Paramètre | Type | Requis | Description |
|---|---|---|---|
--package <name[@version]> | string | Oui | Nom du Pack de commandes autorisé et éventuelle version ou balise |
bl plugin list
Répertorier les Packs de commandes installés et leur état de chargement. Aucune authentification requise.
Utilisation
bl plugin remove
Supprimer un Pack de commandes installé. Aucune authentification requise.
Utilisation
| Paramètre | Type | Requis | Description |
|---|---|---|---|
--name <package> | string | Oui | Nom du Pack de commandes autorisé |
bl plugin link
Lier un pack de commandes local autorisé pour le développement. Aucune authentification requise.
Utilisation
| Paramètre | Type | Requis | Description |
|---|---|---|---|
--path <directory> | string | Oui | Répertoire du package du pack de commandes local |
bl workspace init
Initialiser l'espace de travail Bailian et activer les services postpayés. Aucune authentification requise.
Utilisation
| 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) |
bl workspace list
Lister tous les espaces de travail.
Utilisation
| Paramètre | Type | Requis | Description |
|---|---|---|---|
--list <n> | string | Non | Limiter le nombre de résultats |
bl console call
Appeler une API console Bailian via la passerelle CLI.
Utilisation
| 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 |
bl update
Mettre à jour le CLI vers la dernière version ou une version spécifiée. Aucune authentification requise.
Utilisation
| Paramètre | Type | Requis | Description |
|---|---|---|---|
--to <version> | string | Non | Installer cette version exacte au lieu de la dernière |
bl updaterenvoie un code de sortie non nul en cas d'échec de la mise à niveau ou si la dernière version est introuvable.
bl --help pour afficher tous les groupes de commandes.