feat(finetune): clarify model flags; add price estimate & actual cost

- Rename for clarity: finetune --model → --base-model (create/price/
  capability/list); deploy create --model → --model-name, --name →
  --display-name
- Add `finetune price` (console domain) for pre-training cost estimate
  (sft/dpo/cpt)
- Add actual training cost (fee.ts) enriched into finetune get/watch
  from catalog price × reported usage

Author: gujieye

README.md

@@ -130,10 +130,10 @@ bl auth login --console
 
 # Fine-tune & deploy — a one-shot train-to-serve workflow
 bl dataset upload --file ./train.jsonl                 # Upload a .jsonl dataset (validated first)
-bl finetune text create --model qwen3-8b --datasets ./train.jsonl --training-type sft-lora  # Local paths auto-upload
+bl finetune text create --base-model qwen3-8b --datasets ./train.jsonl --training-type sft-lora  # Local paths auto-upload
 bl finetune watch --job-id ft-xxx --output json       # Non-blocking probe (running/succeeded return 0; failed/canceled report an error)
-bl finetune capability --model qwen3-8b               # Which training types a model supports
-bl deploy text create --model qwen3-8b --name my-svc --plan mu  # Deploy the trained model as an endpoint
+bl finetune capability --base-model qwen3-8b          # Which training types a model supports
+bl deploy text create --model-name qwen3-8b --display-name my-svc --plan mu  # Deploy the trained model as an endpoint
 
 # Browse models / apps / free-tier quota / usage statistics / workspaces
 bl model list                                        # Browse model families and pricing

README.zh.md

@@ -128,10 +128,10 @@ bl auth login --console
 
 # 微调与部署 — 从训练到服务的一站式流程
 bl dataset upload --file ./train.jsonl                 # 上传 .jsonl 数据集（先校验）
-bl finetune text create --model qwen3-8b --datasets ./train.jsonl --training-type sft-lora  # 本地路径自动上传
+bl finetune text create --base-model qwen3-8b --datasets ./train.jsonl --training-type sft-lora  # 本地路径自动上传
 bl finetune watch --job-id ft-xxx --output json       # 非阻塞探测（运行中/成功返回 0；失败/取消报错）
-bl finetune capability --model qwen3-8b               # 查询模型支持哪些训练方式
-bl deploy text create --model qwen3-8b --name my-svc --plan mu  # 把训练好的模型部署为推理服务
+bl finetune capability --base-model qwen3-8b          # 查询模型支持哪些训练方式
+bl deploy text create --model-name qwen3-8b --display-name my-svc --plan mu  # 把训练好的模型部署为推理服务
 
 # 浏览模型 / 应用 / 免费额度 / 用量统计 / 业务空间
 bl model list                                        # 浏览模型系列与价格信息

packages/cli/README.md

@@ -130,10 +130,10 @@ bl auth login --console
 
 # Fine-tune & deploy — a one-shot train-to-serve workflow
 bl dataset upload --file ./train.jsonl                 # Upload a .jsonl dataset (validated first)
-bl finetune text create --model qwen3-8b --datasets ./train.jsonl --training-type sft-lora  # Local paths auto-upload
+bl finetune text create --base-model qwen3-8b --datasets ./train.jsonl --training-type sft-lora  # Local paths auto-upload
 bl finetune watch --job-id ft-xxx --output json       # Non-blocking probe (running/succeeded return 0; failed/canceled report an error)
-bl finetune capability --model qwen3-8b               # Which training types a model supports
-bl deploy text create --model qwen3-8b --name my-svc --plan mu  # Deploy the trained model as an endpoint
+bl finetune capability --base-model qwen3-8b          # Which training types a model supports
+bl deploy text create --model-name qwen3-8b --display-name my-svc --plan mu  # Deploy the trained model as an endpoint
 
 # Browse models / apps / free-tier quota / usage statistics / workspaces
 bl model list                                        # Browse model families and pricing

packages/cli/README.zh.md

@@ -128,10 +128,10 @@ bl auth login --console
 
 # 微调与部署 — 从训练到服务的一站式流程
 bl dataset upload --file ./train.jsonl                 # 上传 .jsonl 数据集（先校验）
-bl finetune text create --model qwen3-8b --datasets ./train.jsonl --training-type sft-lora  # 本地路径自动上传
+bl finetune text create --base-model qwen3-8b --datasets ./train.jsonl --training-type sft-lora  # 本地路径自动上传
 bl finetune watch --job-id ft-xxx --output json       # 非阻塞探测（运行中/成功返回 0；失败/取消报错）
-bl finetune capability --model qwen3-8b               # 查询模型支持哪些训练方式
-bl deploy text create --model qwen3-8b --name my-svc --plan mu  # 把训练好的模型部署为推理服务
+bl finetune capability --base-model qwen3-8b          # 查询模型支持哪些训练方式
+bl deploy text create --model-name qwen3-8b --display-name my-svc --plan mu  # 把训练好的模型部署为推理服务
 
 # 浏览模型 / 应用 / 免费额度 / 用量统计 / 业务空间
 bl model list                                        # 浏览模型系列与价格信息

packages/cli/src/commands.ts

@@ -71,6 +71,7 @@ import {
   finetuneExport,
   finetuneWatch,
   finetuneCapability,
+  finetunePrice,
   deployTextCreate,
   deployAudioCreate,
   deployImageCreate,
@@ -191,6 +192,7 @@ export const commands: Record<string, AnyCommand> = {
   "finetune export": finetuneExport,
   "finetune watch": finetuneWatch,
   "finetune capability": finetuneCapability,
+  "finetune price": finetunePrice,
   "deploy text create": deployTextCreate,
   "deploy audio create": deployAudioCreate,
   "deploy image create": deployImageCreate,

packages/commands/src/commands/deploy/create.ts

@@ -13,13 +13,13 @@ import {
 import { emitResult, emitBare } from "bailian-cli-runtime";
 
 const CREATE_FLAGS = {
-  model: {
+  modelName: {
     type: "string",
-    valueHint: "<name>",
-    description: "Model name (catalog model or fine-tuned output) (required)",
+    valueHint: "<model_name>",
+    description: "Model to deploy — fine-tuned output name or catalog model (required)",
     required: true,
   },
-  name: {
+  displayName: {
     type: "string",
     valueHint: "<display_name>",
     description: "Console display name for the deployment (required)",
@@ -63,7 +63,7 @@ const CREATE_FLAGS = {
 } satisfies FlagsDef;
 
 const CREATE_USAGE =
-  "--model <model_name> --name <display_name> [--plan <plan>] [--deploy-spec <id>] [--capacity <n>] [--billing-method <m>] [--input-tpm <n>] [--output-tpm <n>] [--thinking-output-tpm <n>]";
+  "--model-name <model_name> --display-name <display_name> [--plan <plan>] [--deploy-spec <id>] [--capacity <n>] [--billing-method <m>] [--input-tpm <n>] [--output-tpm <n>] [--thinking-output-tpm <n>]";
 
 const CREATE_NOTES = [
   "Plan defaults to `lora` (Token-billed) for text/image and `mu` (model-unit-",
@@ -77,14 +77,11 @@ const CREATE_NOTES = [
   "Use `bl deploy models --source base` to inspect available templates.",
   "After creation, status starts at PENDING and transitions to RUNNING.",
   "Invoke the deployed model with: bl text chat --model <deployed_model>",
-  "WARNING: --model is overloaded across commands and refers to DIFFERENT",
-  "values. `bl deploy <modality> create --model` takes the exported model_name",
-  "(e.g. `qwen3-8b-ft-...`), but the create response also returns a",
-  "`deployed_model` field (the deployment instance id, e.g.",
-  "`qwen3-8b-5ecb5f068d79`). The inference call `bl text chat --model` must use",
-  "the `deployed_model` from the create response — NOT the `model_name` you",
-  "passed to `deploy <modality> create`. Do not reuse the value across the two",
-  "commands.",
+  "NOTE: --model-name is the model being deployed (e.g. `qwen3-8b-ft-...`).",
+  "The create response also returns a `deployed_model` field — the deployment",
+  "instance id (e.g. `qwen3-8b-5ecb5f068d79`). Use that id for inference",
+  "(`bl text chat --model <deployed_model>`) and lifecycle commands",
+  "(`deploy get/scale/pause/resume/delete --deployed-model <id>`).",
 ];
 
 /**
@@ -118,8 +115,8 @@ async function runCreate(
   ctx: CommandContext<typeof CREATE_FLAGS>,
 ): Promise<void> {
   const { identity, settings, flags } = ctx;
-  const model = flags.model as string;
-  const name = flags.name as string;
+  const model = flags.modelName as string;
+  const name = flags.displayName as string;
   const plan = (flags.plan as string | undefined) || defaultDeployPlan(modality);
 
   // Plan-specific behaviour is owned by core `plans.ts`. The strategy resolves
@@ -165,10 +162,10 @@ export const deployTextCreate = defineCommand({
   usageArgs: CREATE_USAGE,
   flags: CREATE_FLAGS,
   exampleArgs: [
-    "--model my-qwen-sft --name my-sft-test",
-    "--model qwen3.6-flash-2026-04-16 --name my-flash --plan ptu --input-tpm 10000 --output-tpm 1000",
-    "--model qwen3-8b --name my-qwen3-mu --plan mu",
-    "--model qwen3-8b --name my-qwen3 --plan mu --deploy-spec MU1 --capacity 2",
+    "--model-name my-qwen-sft --display-name my-sft-test",
+    "--model-name qwen3.6-flash-2026-04-16 --display-name my-flash --plan ptu --input-tpm 10000 --output-tpm 1000",
+    "--model-name qwen3-8b --display-name my-qwen3-mu --plan mu",
+    "--model-name qwen3-8b --display-name my-qwen3 --plan mu --deploy-spec MU1 --capacity 2",
   ],
   notes: CREATE_NOTES,
   validate: (flags) => validateCreate("text", flags),
@@ -182,9 +179,9 @@ export const deployAudioCreate = defineCommand({
   usageArgs: CREATE_USAGE,
   flags: CREATE_FLAGS,
   exampleArgs: [
-    "--model my-cosyvoice-ft --name my-tts",
-    "--model my-cosyvoice-ft --name my-tts --deploy-spec dps-xxxx --capacity 1",
-    "--model my-cosyvoice-ft --name my-tts --dry-run",
+    "--model-name my-cosyvoice-ft --display-name my-tts",
+    "--model-name my-cosyvoice-ft --display-name my-tts --deploy-spec dps-xxxx --capacity 1",
+    "--model-name my-cosyvoice-ft --display-name my-tts --dry-run",
   ],
   notes: CREATE_NOTES,
   validate: (flags) => validateCreate("audio", flags),
@@ -198,9 +195,9 @@ export const deployImageCreate = defineCommand({
   usageArgs: CREATE_USAGE,
   flags: CREATE_FLAGS,
   exampleArgs: [
-    "--model my-wan-ft --name my-wan",
-    "--model my-wan-ft --name my-wan-mu --plan mu",
-    "--model my-wan-ft --name my-wan --dry-run",
+    "--model-name my-wan-ft --display-name my-wan",
+    "--model-name my-wan-ft --display-name my-wan-mu --plan mu",
+    "--model-name my-wan-ft --display-name my-wan --dry-run",
   ],
   notes: CREATE_NOTES,
   validate: (flags) => validateCreate("image", flags),

packages/commands/src/commands/finetune/capability.ts

@@ -43,7 +43,7 @@ async function fetchAllFoundationModels(settings: Settings): Promise<ModelCapabi
 }
 
 const CAPABILITY_FLAGS = {
-  model: {
+  baseModel: {
     type: "string",
     valueHint: "<m>",
     description: "List training types supported by this base model.",
@@ -59,29 +59,30 @@ export default defineCommand({
   description:
     "Query fine-tune training capability — by model (which training types it supports) or by training type (which models support it)",
   auth: "none",
-  usageArgs: "--model <m> | --training-type <t>",
+  usageArgs: "--base-model <m> | --training-type <t>",
   flags: CAPABILITY_FLAGS,
   exampleArgs: [
-    "--model qwen3-8b",
+    "--base-model qwen3-8b",
     "--training-type sft-lora",
     "--training-type cpt --output json",
     "--training-type sft --quiet",
   ],
   notes: [
-    "Exactly one of --model / --training-type is required.",
+    "Exactly one of --base-model / --training-type is required.",
     "Training-type values use the `<method>` / `<method>-lora` convention:",
     "sft | sft-lora | dpo | dpo-lora | cpt. (cpt has no -lora variant server-side.)",
     "Queries listFoundationModels, a public API — no console login needed.",
   ],
   validate: (f) => {
-    if (f.model && f.trainingType)
-      return "--model and --training-type are mutually exclusive; pass one.";
-    if (!f.model && !f.trainingType) return "one of --model / --training-type is required.";
+    if (f.baseModel && f.trainingType)
+      return "--base-model and --training-type are mutually exclusive; pass one.";
+    if (!f.baseModel && !f.trainingType)
+      return "one of --base-model / --training-type is required.";
     return undefined;
   },
   async run(ctx) {
     const { settings, flags } = ctx;
-    const model = flags.model || undefined;
+    const model = flags.baseModel || undefined;
     const trainingType = flags.trainingType || undefined;
 
     if (settings.dryRun) {

packages/commands/src/commands/finetune/checkpoints.ts

@@ -19,7 +19,7 @@ export default defineCommand({
   flags: CHECKPOINTS_FLAGS,
   exampleArgs: ["--job-id ft-xxx", "--job-id ft-xxx --output json"],
   notes: [
-    "`model_name` (shown for SUCCEEDED checkpoints) is the direct input for `deploy create --model`.",
+    "`model_name` (shown for SUCCEEDED checkpoints) is the direct input for `deploy create --model-name`.",
     "Checkpoints expire ~15 days after creation; `expire_time` shows the deadline. Export or deploy before expiry.",
   ],
   async run(ctx) {

packages/commands/src/commands/finetune/create.ts

@@ -215,10 +215,10 @@ type CommandModality = "text" | "audio" | "image";
  * output. Every modality's model consumes these.
  */
 const COMMON_FLAGS = {
-  model: {
+  baseModel: {
     type: "string",
     valueHint: "<model>",
-    description: "Base model to fine-tune",
+    description: "Base model to fine-tune (e.g. qwen3-8b; not the output model name)",
     required: true,
   },
   datasets: {
@@ -316,13 +316,13 @@ const IMAGE_FLAGS = {
 } satisfies FlagsDef;
 
 const TEXT_USAGE =
-  "--model <model> --datasets <id|path,...> [--validations <id|path,...>] [--model-name <name>] [--suffix <text>] [--n-epochs <n>] [--batch-size <n>] [--learning-rate <str>] [--max-length <n>] [--training-type <sft|sft-lora|dpo|dpo-lora|cpt>]";
+  "--base-model <model> --datasets <id|path,...> [--validations <id|path,...>] [--model-name <name>] [--suffix <text>] [--n-epochs <n>] [--batch-size <n>] [--learning-rate <str>] [--max-length <n>] [--training-type <sft|sft-lora|dpo|dpo-lora|cpt>]";
 
 const AUDIO_USAGE =
-  "--model <model> --datasets <id|path> [--validations <id|path>] [--model-name <name>] [--suffix <text>]";
+  "--base-model <model> --datasets <id|path> [--validations <id|path>] [--model-name <name>] [--suffix <text>]";
 
 const IMAGE_USAGE =
-  "--model <model> --datasets <id|path> [--validations <id|path>] [--model-name <name>] [--suffix <text>] [--generation-type <t2i|i2i>] [--learning-rate <str>]";
+  "--base-model <model> --datasets <id|path> [--validations <id|path>] [--model-name <name>] [--suffix <text>] [--generation-type <t2i|i2i>] [--learning-rate <str>]";
 
 const COMMON_NOTES = [
   "Creating a job uploads any local datasets and consumes training quota.",
@@ -382,7 +382,7 @@ async function runCreate<F extends FlagsDef>(
 ): Promise<void> {
   const { identity, settings } = ctx;
   const flags = ctx.flags as Record<string, unknown>;
-  const model = flags.model as string;
+  const model = flags.baseModel as string;
   const datasetsRaw = flags.datasets as string;
 
   // CosyVoice audio fine-tuning accepts exactly one training file
@@ -636,14 +636,14 @@ export const finetuneTextCreate = defineCommand({
   usageArgs: TEXT_USAGE,
   flags: TEXT_FLAGS,
   exampleArgs: [
-    "--model qwen3-8b --datasets file-xxx",
-    "--model qwen3-8b --datasets ./train.jsonl",
-    "--model qwen3-8b --datasets ./train.jsonl --validations ./eval.jsonl",
-    "--model qwen3-8b --datasets file-aaa,./extra.jsonl",
-    "--model qwen3-8b --datasets ./train.jsonl --training-type sft",
-    '--model qwen3-8b --datasets file-xxx --learning-rate "1.6e-5" --n-epochs 4',
-    "--model qwen3-8b --datasets file-xxx --output json",
-    "--model qwen3-8b --datasets file-xxx --dry-run",
+    "--base-model qwen3-8b --datasets file-xxx",
+    "--base-model qwen3-8b --datasets ./train.jsonl",
+    "--base-model qwen3-8b --datasets ./train.jsonl --validations ./eval.jsonl",
+    "--base-model qwen3-8b --datasets file-aaa,./extra.jsonl",
+    "--base-model qwen3-8b --datasets ./train.jsonl --training-type sft",
+    '--base-model qwen3-8b --datasets file-xxx --learning-rate "1.6e-5" --n-epochs 4',
+    "--base-model qwen3-8b --datasets file-xxx --output json",
+    "--base-model qwen3-8b --datasets file-xxx --dry-run",
   ],
   notes: TEXT_NOTES,
   run: (ctx) => runCreate("text", ctx),
@@ -656,11 +656,11 @@ export const finetuneAudioCreate = defineCommand({
   usageArgs: AUDIO_USAGE,
   flags: AUDIO_FLAGS,
   exampleArgs: [
-    "--model cosyvoice-v3-flash --datasets ./audio.zip",
-    "--model cosyvoice-v3-flash --datasets file-xxx",
-    "--model cosyvoice-v3-flash --datasets ./audio.zip --model-name my-tts",
-    "--model cosyvoice-v3-flash --datasets file-xxx --output json",
-    "--model cosyvoice-v3-flash --datasets ./audio.zip --dry-run",
+    "--base-model cosyvoice-v3-flash --datasets ./audio.zip",
+    "--base-model cosyvoice-v3-flash --datasets file-xxx",
+    "--base-model cosyvoice-v3-flash --datasets ./audio.zip --model-name my-tts",
+    "--base-model cosyvoice-v3-flash --datasets file-xxx --output json",
+    "--base-model cosyvoice-v3-flash --datasets ./audio.zip --dry-run",
   ],
   notes: AUDIO_NOTES,
   run: (ctx) => runCreate("audio", ctx),
@@ -673,12 +673,12 @@ export const finetuneImageCreate = defineCommand({
   usageArgs: IMAGE_USAGE,
   flags: IMAGE_FLAGS,
   exampleArgs: [
-    "--model wan2.7-image-pro --datasets ./images.zip",
-    "--model wan2.7-image-pro --datasets file-xxx",
-    "--model wan2.7-image-pro --datasets file-xxx --generation-type i2i",
-    "--model wan2.7-image-pro --datasets ./images.zip --model-name my-wan",
-    "--model wan2.7-image-pro --datasets file-xxx --output json",
-    "--model wan2.7-image-pro --datasets ./images.zip --dry-run",
+    "--base-model wan2.7-image-pro --datasets ./images.zip",
+    "--base-model wan2.7-image-pro --datasets file-xxx",
+    "--base-model wan2.7-image-pro --datasets file-xxx --generation-type i2i",
+    "--base-model wan2.7-image-pro --datasets ./images.zip --model-name my-wan",
+    "--base-model wan2.7-image-pro --datasets file-xxx --output json",
+    "--base-model wan2.7-image-pro --datasets ./images.zip --dry-run",
   ],
   notes: IMAGE_NOTES,
   run: (ctx) => runCreate("image", ctx),