技能介绍

在处理 AI 生成任务时，开发者常面临工具分散、命令不一致的问题：文生图需要调用不同接口，语音合成和视频编辑又得切换平台，导致工作流碎片化。百炼 AI 工具包通过统一的 CLI 命令层，将阿里云百炼的多模态生成能力整合为可脚本化的工具集，让工程师能在一个命令行界面完成从输入到输出的全链路操作。

多模态任务覆盖：支持文生图（bl image generate）、图像编辑（bl image edit）、文生视频（bl video generate）、语音合成与识别（bl speech synthesize/recognize）、视觉理解（bl vision describe）及文本对话（bl text chat），默认模型覆盖 qwen-image-2.0、happyhorse-1.0-t2v、cosyvoice-v3-flash 等。
本地文件直传：图像、视频等本地文件可直接通过路径参数传入（如 --image ./photo.png），无需先上传至 URL，减少中间环节。
异步任务处理：视频生成默认等待完成后下载，也可通过 --no-wait 立即返回任务 ID，适合长任务的场景化管理。
全局参数控制：通过 --api-key 临时指定密钥、--region 切换区域、--output 调整输出格式，支持非交互模式（--non-interactive）适配自动化流程。

密钥安全：API Key 不写入代码，需通过 --api-key 参数或环境变量注入，避免敏感信息泄露。
默认行为差异：图像生成默认扩展提示词，若需严格按原提示生成需添加 --no-prompt-extend；视频生成是异步操作，默认等待完成，加 --no-wait 可提前获取任务 ID。
文档优先：遇到参数或功能疑问时，优先通过 --help 查看命令级帮助，每个子命令均有完整使用说明。