类别：task

阿里云 Model Studio 入口（路由）

将请求路由至已有的本地技能，避免重复定义模型/参数细节。

前提条件

• 安装 SDK（推荐使用虚拟环境，以规避 PEP 668 限制）：

python3 -m venv .venv
. .venv/bin/activate
python -m pip install dashscope

• 配置 DASHSCOPE_API_KEY（推荐通过环境变量设置；也可写入 ~/.alibabacloud/credentials 中的 dashscope_api_key 字段）。

路由表（当前本仓库支持的能力）

未匹配到技能时的处理方式

• 首先明确模型能力范围及输入/输出类型。
• 若所需能力在本仓库中缺失，请先新增对应技能。

本仓库当前缺失的常见能力（待补齐缺口）

• 图像翻译

• 虚拟试穿 / 数字人 / 高级视频角色（advanced video personas）

• 多模态/ASR 下载失败时，优先使用上述公开 URL。

• ASR 参数报错时，请使用 input_audio.data 中的数据 URI 格式。

• 多模态嵌入返回 400 错误时，请确保 input.contents 是一个数组。

异步任务轮询模板（适用于视频类/长耗时任务）

当响应头包含 X-DashScope-Async: enable 并返回 task_id 时，按如下方式轮询：

GET https://dashscope.aliyuncs.com/api/v1/tasks/
Authorization: Bearer $DASHSCOPE_API_KEY

成功响应示例字段：

{
  "output": {
    "task_status": "SUCCEEDED",
    "video_url": "https://..."
  }
}

注意事项：

• 推荐轮询间隔为 15–20 秒，最多尝试 10 次。
• 任务成功后，请下载 output.video_url 指向的资源。

澄清性问题（不确定时请主动询问）

1. 您正在处理的是文本、图像、音频还是视频？
2. 该操作属于生成、编辑/理解，还是检索？
3. 您需要的是语音相关能力（TTS/ASR/实时翻译），还是检索相关能力（嵌入/重排序/向量数据库）？
4. 您需要可运行的 SDK 脚本，还是仅需 API 接口与参数说明？

参考资料

• 模型列表与链接：output/alicloud-model-studio-models-summary.md

• API 接口、参数与示例：参见对应子技能目录下的 SKILL.md 及 references/*.md

• 官方信源列表：references/sources.md

验证

mkdir -p output/aliyun-modelstudio-entry
echo "validation_placeholder" > output/aliyun-modelstudio-entry/validate.txt

通过标准：命令退出码为 0，且成功生成 output/aliyun-modelstudio-entry/validate.txt 文件。

输出与证据

• 所有产物、命令输出及 API 响应摘要均需保存至 output/aliyun-modelstudio-entry/ 目录下。
• 证据文件中须包含关键参数（如地域、资源 ID、时间范围等），以保障可复现性。

工作流

1. 确认用户意图、地域、标识符，以及操作是否为只读或可变更（mutating）。
2. 首先执行一个最小化的只读查询，用于验证连通性与权限。
3. 在显式指定参数、限定作用范围的前提下，执行目标操作。
4. 校验结果，并保存输出与证据文件。