DashScope API Endpoints 全景:标准 sk- vs Coding Plan sk-sp- — 路由混用会导致意外扣费

阿里云百炼提供两套 API Endpoints:标准 dashscope.aliyuncs.com(sk- Key,按量计费)与独立 coding.dashscope.aliyuncs.com(sk-sp- Key,按请求次数配额)。将订阅 Key 通过网关透传会静默触发按量扣费,配额看板显示零消耗。

发布于 来源 Alibaba Cloud Model Studio

归档条目:由 AI 根据所引信源辅助生成,发布时未经逐篇审阅。责任编辑:Joe Werner。

路由分叉图:一条被拦截的路径与一条持 Key 的畅通路径,分别代表 DashScope Coding Plan 的隔离 Endpoint 与标准 API 网关流量的分离

大多数团队把新 API Key 填入 gateway 时,默认它就能工作——同一个 endpoint、同一个计费面板、同一套配额计数器。DashScope Coding Plan 有意打破了这种假设:如果你的路由层没有针对它做区分,你会悄悄累积按量计费账单,而订阅的配额看板永远显示零消耗。

发生了什么

阿里云百炼将面向编程工具的 AI 模型订阅整合为 Coding Plan Pro(¥200/月)。该套餐以固定月费和请求次数上限的方式,统一提供 Qwen3.6-plus、Kimi K2.5、GLM-5、MiniMax-M2.5 等多个模型的访问权限,适用于 Claude Code、OpenClaw、Cursor 等 AI 编程工具。

关键基础设施细节:Coding Plan 发放独立的 API Key 和 Base URL,与标准 DashScope 按量计费 Endpoint 完全分离。

属性标准 DashScopeCoding Plan
API Key 前缀sk-sk-sp-
OpenAI Base URLhttps://dashscope.aliyuncs.com/compatible-mode/v1https://coding.dashscope.aliyuncs.com/v1
Anthropic Base URL(标准 Endpoint 不提供)https://coding.dashscope.aliyuncs.com/apps/anthropic
配额追踪按 Token 计费按请求次数计入套餐配额
API 自动化调用允许禁止

阿里云明确警告:Key 与 URL 混用会导致标准 Endpoint 将请求识别为普通按量付费调用。Coding Plan 的 sk-sp- Key 无法在标准 URL 下工作;标准 sk- Key 也不会消耗订阅配额。

套餐配额采用滚动窗口机制:每 5 小时 6,000 次请求(滚动恢复)、每周 45,000 次、每月 90,000 次。每次"请求"根据任务复杂度、上下文长度和工具调用情况,实际内部可能扩展为 5–30+ 次模型调用。

Lite 基础版已停止服务:新购于 2026 年 3 月 20 日截止,续费与升级于 4 月 13 日截止。

对 AI 工程团队的影响

1. 通过网关透传是计费陷阱。 如果团队将 sk-sp-* Key 填入标准 OpenAI 兼容 gateway——包括任何会重写 Header 或 Base URL 的路由器——订阅配额不会被消耗,请求要么直接失败,要么落入按量计费路径。阿里云官方文档明确指出:Key 与 Base URL 混用是最常见的错误配置,也是产生意外扣费的根本原因。

2. 禁止自动化调用是真实约束。 Coding Plan 服务条款明确禁止在自动化脚本、自定义应用后端或任何非交互式批量场景中使用订阅 API Key。违规可能导致订阅被暂停或 API Key 被封禁。这意味着该套餐在架构上不适合通过 gateway 做服务端路由,它是为以人为节奏的 IDE 内编程 agent 流量设计的。

3. 多地域进一步增加 Key 管理复杂度。 DashScope 标准服务有四个地域 Endpoint(北京、弗吉尼亚、新加坡、法兰克福),API Key 在不同地域间不通用。Coding Plan Endpoint 目前仅支持北京地域。在全球化部署的团队需要明确区分:哪些模型通过标准 DashScope 地域 Endpoint(经由 gateway)路由,哪些由编程工具直连 Coding Plan Endpoint。

4. 数据授权条款不同。 Coding Plan 服务协议包含一项条款,授权阿里云将输入和输出内容用于模型训练和服务优化,这与标准 DashScope 按量服务的协议存在差异。有数据治理要求的团队在为开发者机器开通 Coding Plan 前,需单独评估此条款。

5. RAM 子账号须主账号授权。 Coding Plan 必须由主账号购买;RAM 子账号需要主账号在百炼控制台完成授权操作后才能订阅。这引入了额外的管理员依赖——开发者无法自助开通订阅访问权限。

Router/Operator 视角分析

Coding Plan 架构在两种路由模式之间划出了清晰的边界:

Gateway 路由流量(标准 DashScope,按量计费):qwen3.7-max、qwen3.6-plus、qwen3.6-flash,以及 deepseek-v4-pro、kimi-k2.6 等第三方模型,均通过 dashscope.aliyuncs.com/compatible-mode/v1 访问。这是 router 发挥价值的路径——fallback、延迟对冲、provider 成本比较和统一计费。

Coding Plan 订阅流量:由编程工具直接访问 coding.dashscope.aliyuncs.com,不应有任何 gateway 夹在工具和这个 Endpoint 之间。订阅的请求次数配额追踪只有在使用专属 Key/URL 对时才能正常工作,且服务条款明确禁止 gateway 自动化。

对于使用 TheRouter 统一管理 DashScope 流量的团队,结论很明确:不要将 Coding Plan Key 通过 TheRouter 路由。 将 TheRouter 用于 DashScope 按量计费 API 调用,将 Coding Plan 直连配置留给 Alibaba 为其设计的开发者工作站工具。

一个工程团队的实际分工建议:

  • 生产 Pipeline、Eval、批量任务、Agent 后端:通过 gateway 路由,使用标准 sk- Key 和 dashscope.aliyuncs.com Endpoint
  • 开发者 IDE 编程 Agent(Claude Code、Cursor、OpenClaw):直接配置 sk-sp- Key 和 coding.dashscope.aliyuncs.com Endpoint,不经过任何代理

在路由策略文档中明确记录这条边界,可以防止新开发者将错误的 Key 填入错误的配置字段。

TheRouter 用户应关注的事项

如果你今天已在通过 TheRouter 使用标准 DashScope 凭据路由 Qwen 模型,你的现有配置不受 Coding Plan 影响,继续使用标准 DashScope provider 配置和 sk- API Key 即可。

如果你的团队正在为开发者编程工具评估 Coding Plan:

  1. 配置前核对 Key 格式。 sk-sp- 前缀是 Coding Plan Key 最快速的识别标志——不要将其路由到任何 gateway。
  2. 排查路由配置中的 Base URL。 如果任何配置文件指向 coding.dashscope.aliyuncs.com 同时又经过了代理层,移除该代理跳转。
  3. 订阅前审阅数据授权条款。 如果团队有数据治理要求或合规合同限制训练数据使用,在为开发者机器开通 Coding Plan 前单独评估。
  4. 关注请求次数消耗速率。 复杂编程 Agent 工作流可能快速耗尽每 5 小时 6,000 次的配额。在 Coding Plan 配额页面监控用量,合理调整会话频率。
  5. 排查 Lite 版遗留 Key。 如果团队仍有开发者持有 Lite 版 Key(4 月 13 日后已停止续费),这些 Key 已失效。审计内部 Cursor/Claude Code 配置分发,确认没有 Lite Key 仍在使用中。
编辑风格插图,展示分叉的 API 路由路径,其中标有 agents sessions 的分支偏离主网关,背景为低饱和深色调

OpenAI Agents API 公测:网关运营商需要正视的新绕道路径

OpenAI 的 Agents API 公测版引入了 client.beta.agents 这个独立命名空间,它根本不经过 /v1/chat/completions。对于通过 AI 网关路由流量的团队来说,这意味着账单盲区、缺失的审计记录,以及一个需要单独管理的 API key 权限范围。

来源 OpenAI
帮助与联系