关于¶
项目¶
DashScope Python SDK(PyPI 包名 dashscope)是
阿里云百炼(Model Studio)
的官方 Python 客户端,覆盖文本生成、多模态理解、向量嵌入、重排序、
图像/视频生成、语音合成与识别、微调、智能体强化学习、托管智能体与应用调用。
许可证¶
SDK 采用 Apache License 2.0 授权。第三方声明(如内置的 certifi CA 证书包)见 NOTICE。
兼容性与版本策略¶
- 2.x 是积极开发的主线:资源式
Client/AsyncClient、 类型化响应与异常。 - 完整 1.x 公共接口仍可从历史路径导入,由
dashscope.legacy_1x下 的冻结门面实现;不再新增能力。 - AgentStudio 与 Agentic RL 是应用子 SDK,拥有独立的客户端与返回类型
(AgentStudio 还有专用的资源与分页接口);错误则统一构建在
dashscope.errors体系上:AgentStudio 直接抛出主 SDK 异常,AgentStudioError等历史名称只是别名;Agentic RL 保留专用的AgenticRLError子类,但同属该体系。 - 需要 Python 3.9+;可选交互式助手(
dashscope[expert])需要 Python 3.10+。 - 当前 SDK 版本:2.1.1 —— 见发行说明。
获取帮助¶
- 在 GitHub Issues 反馈缺陷与需求。
- 浏览 API 参考或快速开始。
- 失败的调用可以自我解释:启用 devkit 诊断后,
DashScopeError.diagnosis会给出结构化修复建议 (见开发工具)。