类别：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 字段）。

路由表（当前本仓库中已支持）

未匹配时的处理方式

• 首先明确模型能力及输入/输出类型。
• 若该能力在仓库中尚未支持，请先新增对应技能。

本仓库中常见缺失能力（待补齐项）

• 文本生成/对话（LLM）

• 多模态嵌入（multimodal embeddings）

• 面向 OCR 的专用信息抽取与图像翻译

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

• 对于多模态/ASR 下载失败的情况，优先使用上方列出的公开 URL。

• 对于 ASR 参数错误，请使用 input_audio.data 中的数据 URI（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/alicloud-ai-entry-modelstudio
echo "validation_placeholder" > output/alicloud-ai-entry-modelstudio/validate.txt

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

输出与证据

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

工作流

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