How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/modelstudioai/cli --skill bailian-finetuneBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
Bailian fine-tuning pipeline (bl dataset / bl finetune / bl deploy)
CRITICAL — Before executing, MUST read the shared protocol in [`../bailian-protocol/SKILL.md`](../bailian-protocol/SKILL.md): Version & updates (pre-flight checklist), Call attribution (every Agent `bl` command), Setup & auth, and CLI errors: report an issue. Command details are authoritative in [`reference/`](reference/index.md) (dataset / finetune / deploy) and `bl <command> --help` — do not guess flags. Examples in `reference/` stay bare; wrap with Call attribution when running. The training pipeline uses an API key; Console dataset-version and independent-deployment queries use Console authentication. If that protocol file is missing, stop and run `bl skill init`; do not guess auth/consent.
Call attribution: Examples below and in reference/ stay bare bl …. When running a command, wrap it with `bailian-protocol` → Call attribution (bash or PowerShell). One sample for this skill (BAILIAN_SKILL_NAME=bailian-finetune; replace codex with this host). After deploy, bl text chat is owned by bailian-cli. When copying commands into a reusable script / template / task definition, switch to the protocol `script` template (never keep `agent`); the sample below is for this-turn inline execution only. Strip attribution when handing a command to the user to paste.
BAILIAN_CALLER_TYPE=agent BAILIAN_CALLER_NAME=codex BAILIAN_SKILL_NAME=bailian-finetune BAILIAN_SKILL_VERSION=<metadata.version> bl dataset validate --file train.jsonlEnd-to-end workflow (follow in order)
1. Validate data bl dataset validate --file train.jsonl [--schema chatml|dpo|cpt|tts|image]
2. Upload data bl dataset upload --file train.jsonl # returns a file-id
3. Create job bl finetune text|audio|image create --base-model <base> --datasets <file-id|path>
4. Watch progress bl finetune watch --job-id ft-xxx # or get / logs
5. Pick artifact bl finetune checkpoints --job-id ft-xxx
6. Export model bl finetune export --job-id ft-xxx --checkpoint ckpt-N --model-name my-model
7. Compress model bl finetune compress templates --model my-model # optional; full-parameter models only
bl finetune compress create --model my-model --template-id <template-id>
bl finetune compress watch --job-id quant-xxx --follow
8. Deploy service bl deploy text|audio|image create --model-name <my-model|quantized-output> --display-name my-svc- Unsure which training methods a base model supports →
bl finetune capability --base-model <base>or--training-type sft|sft-lora|dpo|cpt. - Text
--training-typevalues:sft/sft-lora/dpo/dpo-lora/cpt. Audio bases includecosyvoice-v3-flash; image bases includewan2.7-image-pro. - Deployment plans: audio defaults to
--plan mu; text/image default tolora. - For
risk: highorrequires_confirmation, followbailian-protocol; never add--yesautomatically.
When to use which command
| Intent | Command | ||
|---|---|---|---|
| Validate / upload training data | bl dataset validate / upload (.jsonl or .zip) | ||
| Dataset list / detail / delete | bl dataset list / get / delete | ||
| Console dataset groups / discover version and file IDs | bl dataset groups → bl dataset version --dataset-group-id <group-id> (Console auth) | ||
| Console version detail / import and release state | bl dataset version --dataset-id <version-id> (Console auth; optional --include-status) | ||
| Console independent deployment services | bl deploy instances (Console auth; not capacity instances or replicas) | ||
| Create a fine-tuning job | `bl finetune text\ | audio\ | image create` |
| Job list / detail / follow | bl finetune list / get / watch / logs | ||
| Artifacts and export | bl finetune checkpoints / export | ||
| Quantize / compress a full model | bl finetune compress templates / create / watch / get / logs / list | ||
| Cancel / delete a compression job | bl finetune compress cancel / delete | ||
| Cancel / delete a fine-tuning job | bl finetune cancel / delete | ||
| Import an external OSS LoRA model | Hand-off: bl cmodel import * — hub-owned commands; see bailian-cli reference or bl cmodel --help | ||
| Trainable capability lookup | bl finetune capability | ||
| Deploy / lifecycle | `bl deploy text\ | audio\ | image create, list / get / update / scale / delete / models` |
| Query throughput reservations | bl deploy list --plan ptu / bl deploy get | ||
| Query capacity instances | bl deploy capacity list / get | ||
| Query / wait for a capacity operation | bl deploy operation get / wait | ||
| Buy / scale / renew / release capacity | bl deploy capacity create / scale / renew / delete | ||
| Unsubscribe a prepaid instance | bl deploy capacity unsubscribe (builds the billing console refund link) | ||
| Configure ModelCode overflow strategy | bl deploy overflow |
The capacity list / get, operation get / wait and deploy list / get queries are read-only. Capacity values are kTPM; effective, configured and target capacities are distinct. deploy list --status filters only the fetched page locally, with the server total left unfiltered. operation get reports status as data; operation wait exits non-zero on failure or timeout and refreshes capacity after success. Use IDs returned by the API; waiting never retries a write.
The capacity create / scale / renew / delete and overflow commands are high-risk writes: preview with --dry-run, then confirm with the runtime-injected --yes. Each write is submitted once and never auto-retried; HTTP 200 is not success, so pass --wait or check operation_status. Scale values are one instance's absolute kTPM, not deltas or ModelCode totals, and zero is not release. capacity delete releases an instance but keeps the ModelCode; active prepaid instances cannot be DELETEd — run capacity unsubscribe --instance-id <id> to get the billing console refund link and finish there (no API exists for refunds). Release is confirmed by deleted=true. overflow applies to the whole ModelCode, not one instance. There is no estimator or standalone auto-renewal endpoint — renewal settings ride along purchase/scale/renew.
Console reads are separate from API-key file/deployment queries; the API Key / file_id semantics of dataset list are unchanged. Discover records[].datasetGroupId with dataset groups, then pass it to dataset version --dataset-group-id <group-id> to get {result:[...]} with result[].datasetId and an optional fileId. Use dataset version --dataset-id <version-id> for details; exactly one of --dataset-group-id and --dataset-id is required, and they cannot be combined. fileId is not datasetId; never pass a file ID from dataset list as a Console version ID. Groups are paginated and contain only one nested version preview; version --dataset-group-id normalizes array responses to result without promising exhaustive results or exposing pagination. Keep the same workspace throughout this chain. --include-status is available only in detail mode (dataset version --dataset-id <version-id> --include-status) and preserves raw version and task state; missing/unknown state never means validation success or training readiness, and the returned task is not guaranteed to be the latest. A failed follow-up query retains metadata and exits nonzero. deploy instances returns one page (records is the list, items the total); reading does not establish inference or pause permission. With --workspace-id, these commands resolve that workspace's Console identity before business requests and stop on resolution failure. For an error-report file key, hand off to bailian-cli (file url); an existing report URL can be used directly.
Flags, usage, and examples: see `reference/` or bl <command> --help — do not guess flags.
Quick examples
bl dataset validate --file train.jsonl
bl dataset upload --file train.jsonl
bl finetune text create --base-model qwen3-8b --training-type sft-lora --datasets file-xxx
bl finetune watch --job-id ft-xxx
bl finetune export --job-id ft-xxx --checkpoint ckpt-3 --model-name my-qwen-sft
# Optional quantization (Beijing region; full-parameter fine-tuned models only)
bl finetune compress templates --model my-qwen-sft
bl finetune compress create --model my-qwen-sft --template-id quant-xxx --suffix int4
bl finetune compress watch --job-id quant-xxx --follow
bl deploy text create --model-name <my-qwen-sft-or-quantized-output> --display-name my-svcCommon hand-offs
软 hand-off(按 skill 名;已安装则 Read,否则 --help / 提示 bl skill init):
- After deployment, try the model or generate content → skill
bailian-gen(media) orbl text chat(fallback:bl image\|video\|text --help). - Unsure which base model to pick →
bailian-model-recommend/bl advisor recommend. - Training quota / usage questions → skill
bailian-cli(fallback:bl quota/bl usage --help).
references
- bailian-protocol — shared protocol (install via
bl skill init) - reference/ — command details