用途:作为阿里云百炼(Model Studio)请求的路由入口,把用户需求指向仓库中已有的本地子技能,避免在各处重复记录模型与参数细节。
主要能力:提供一张路由表,覆盖文本生成/推理/工具调用、代码与仓库推理、深度多步研究、文生图与图像编辑、文生视频/图生视频/参考生视频、数字人、表情化人像视频、动作迁移、TTS、ASR、实时语音识别与合成、实时语音翻译、声音克隆与声音设计、全模态交互、视觉推理、OCR/文档与表格解析、文本与多模态嵌入、重排、向量检索、文档理解、视频编辑、视频对口型替换,以及模型列表抓取更新等。
使用方式:先安装 SDK,建议使用虚拟环境以规避 PEP 668 限制: python3 -m venv .venv . .venv/bin/activate python -m pip install dashscope 然后配置 DASHSCOPE_API_KEY(优先环境变量,也可在 ~/.alibabacloud/credentials 中设置 dashscope_api_key)。异步任务(如视频)在返回 X-DashScope-Async: enable 与 task_id 后轮询: GET https://dashscope.aliyuncs.com/api/v1/tasks/<task_id> Authorization: Bearer $DASHSCOPE_API_KEY 建议轮询间隔 15-20 秒,最多 10 次,成功后下载 output.video_url。
适用场景:需要按输入输出类型(文本、图像、音频、视频)以及生成、编辑/理解、检索等意图,快速定位到对应子技能时使用。
限制:若需求未匹配到已有技能,应先明确模型能力与输入输出类型,必要时新增技能;仓库当前仍缺少图像翻译、虚拟试穿/数字人/高级视频人像等能力。多模态或 ASR 下载失败时优先使用公开 URL;ASR 参数错误时在 input_audio.data 使用 data URI;多模态嵌入返回 400 时确保 input.contents 为数组。验证方式为执行 mkdir -p output/aliyun-modelstudio-entry 并生成 validate.txt,命令退出码为 0 即通过;产物与证据保存在 output/aliyun-modelstudio-entry/ 下。