先弄清楚:这里的中转站是什么意思
在 AI 接入场景中,中转站是位于你的应用与上游模型之间的接口网关。你把请求发送到平台提供的地址,平台完成鉴权、路由和转发,再把模型回复交给应用。这里讨论的是 AI 接口服务。
对使用者来说,最需要确认的是三项内容:API 地址、平台密钥和可用模型名称。本教程以云路 API 为例,说明如何把这三项配置正确。其他平台的地址、模型和规则可能不同。
云路 API 是独立服务,与页面提及的模型厂商相互独立。接口兼容范围、价格和实际可用模型,应以当前平台说明为准。
第一步:注册账号并完成邮箱验证
打开云路 API 注册页面,填写自己的邮箱,获取注册验证码,再按页面提示创建账号。验证码有效期为 10 分钟,过期后重新申请,不要把验证码交给他人。
注册后使用自己的账号登录控制台。如果忘记密码,可以申请密码重置邮件,并在有效链接中自行设置新密码。登录密码用于账号登录,不能填进客户端的 API Key 字段。
第二步:先看可用额度和模型价格
进入钱包,确认当前账户是否有可用额度;同时打开模型广场查看想用的模型、输入输出价格与缓存计费说明。账户额度和应用密钥的独立额度是两项检查,都可能影响调用。
云路 API 钱包以 USD 额度展示;在线充值的实际收款金额和支付方式在报价及收银台中确认。本文不要求先完成付款。充值后是否到账,应以钱包中的核验结果为准。
调用模型通常会消耗额度,包括客户端的连接检测。先选一个实际开放的模型,发送一条短消息,确认配置正确后再进行较长的任务。
第三步:为当前应用创建 API 密钥
打开密钥管理,创建一个专门用于当前客户端或项目的应用密钥,名称可用于区分用途。按实际需要设置额度、有效期和允许的模型,再保存创建结果。
在第三方客户端中,API Key 填这把云路 API 密钥。不要填写邮箱验证码、网站登录密码、兑换码或上游账号凭据。不同应用使用独立密钥,更便于查看用量和停用。
不要把完整密钥放进公开截图、网页前端或代码仓库。发现泄露时,到密钥管理页面停用相关密钥,再创建新的密钥更新应用配置。
第四步:按客户端协议填写接口地址
客户端可能把这个字段称为 API 地址、Base URL 或服务地址。首先确认客户端使用哪种协议,再按下面的规则填写:
| 使用方式 | 地址 | 最终请求路径 |
|---|---|---|
| OpenAI SDK/兼容聊天 | https://api.yunluapi.com/v1 | /v1/chat/completions |
| GPT Responses | https://api.yunluapi.com/v1 | /v1/responses |
| Anthropic SDK/Messages | https://api.yunluapi.com | /v1/messages |
有些客户端会自动补全 /v1,此时按客户端说明填写域名根地址。关键是最终请求路径正确,不能重复出现 /v1/v1,也不能把主站登录页当成 API 地址。
需要具体操作时,分别查看Cherry Studio 配置教程、OpenAI 兼容接口说明或Claude Messages 接入说明。
第五步:选模型,发送第一条短消息
从模型广场或客户端获取的列表中选择一个有权限使用的模型,模型 ID 要完整填写,不能随意缩写。例如当前配置中有 gpt-6-luna 和 claude-sonnet-5,它们是两个不同的模型名称。
如果暂时不配置外部客户端,可先打开登录后的网页游乐场,选择模型并发送一句简单的问题。使用外部客户端时,先填好地址、密钥和模型,再进行短消息检测;检测成功后确认服务商已启用。
如果是自己编程接入,可从技术指南的 cURL、Python 与 JavaScript 示例开始。先验证一条请求,再增加流式输出、图片或其他功能;这些扩展能力还取决于模型、协议和客户端的支持情况。
第六步:核对调用结果与用量日志
收到回复后,到用量日志核对请求时间、模型、输入输出用量和扣费记录。实际费用取决于使用的模型、计费条件和真实用量,不能只凭一次回复长短估算所有调用成本。
流式请求还要检查是否正常结束。收到 HTTP 200 或看到少量文字,并不一定意味着整次请求成功;遇到错误事件、截断或超时,应同时查看客户端提示和站内日志。
没有成功时,按现象排查
- 401:鉴权失败
- 核对是否使用平台应用密钥,是否复制完整,是否有多余空格,以及密钥是否过期或被禁用。
- 404:接口路径不对
- 检查 Base URL 是否重复附加版本路径,客户端的协议类型是否与所选模型一致。
- 余额或额度不足
- 分别检查账户可用额度和当前应用密钥的限额;有余额也不代表密钥一定有权限调用所有模型。
- 429、超时或模型暂时不可用
- 降低并发,按返回提示等待后再试,不要立即无限重复请求。渠道额度和上游状态也会影响可用性。
- 客户端没有显示刚添加的模型
- 检查模型是否真正加入列表、服务商是否启用,以及当前对话是否选中了正确的服务商和模型。
仍无法解决时,通过站内工单提供发生时间、模型、请求 ID 和脱敏后的错误信息;不要发送完整密钥或验证码。
完成前,再核对这份清单
- 账号可以正常登录,并有可用模型额度。
- 客户端使用的是云路 API 应用密钥。
- API 地址和最终请求路径与客户端协议一致。
- 模型 ID 来自当前可用列表,并在密钥允许范围内。
- 短消息已经成功完成,站内有对应的调用记录。
这些步骤完成后,就可以继续配置自己的日常工作流。价格查询回到模型广场,接口参数和代码示例查看技术接入指南;本文仅作为新手操作文章,不替代具体客户端的版本说明。