配置:在千聚获取API Key与Base URL
完成钉钉接入模型中转站方案的第一步,是配置正确的API Key与Base URL。千聚AI中转站采用OpenAI兼容接口,Base URL统一为:
https://api.token88.cc/v1
配置步骤如下:
- 注册并登录千聚平台,在控制台“API Key管理”页面生成一个专属Key。
- 复制生成的Key,并记下Base URL。
- 在钉钉开发环境(如钉钉开放平台或企业内部应用)中,将这两个参数配置到HTTP请求的客户端中。
这种统一配置方式非常适合降低接入复杂度,只需要一次配置,即可对接后续所有模型调用。更详细的配置方式可以查看千聚AI中转站官网上的Base URL接入文档。
充值:购买Token与余额管理
配置完成后,需要为账户充值Token。千聚支持按量购买,Token余额可以随时在控制台查看,消费记录清晰可查。充值流程非常简洁:
- 登录千聚账户,进入“Token购买”页面。
- 选择适合的Token套餐,支持多种支付方式完成充值。
- 充值成功后,Token实时到账,可以立即用于模型调用。
这种灵活的充值方式,让团队可以按需投入,避免资源浪费。对于钉钉场景下的高频调用,Token购买与余额管理功能可以更好地控制成本。
调用:使用OpenAI兼容接口发起请求
在钉钉接入模型中转站方案中,调用环节只需遵循OpenAI兼容接口规范。以下是一个简单的Python调用示例,仅展示API Key、Base URL与模型名三个关键配置:
from openai import OpenAI
client = OpenAI(
api_key="your-api-key",
base_url="https://api.token88.cc/v1"
)
response = client.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "你好"}]
)
在钉钉机器人或工作流中,只需将上述代码嵌入到后端服务,即可实现模型调用。千聚平台支持多种模型切换,方便根据业务需求选择合适的模型。需要提醒的是,模型名称请以千聚平台最新模型列表为准,实时信息可前往立即访问千聚查看。
在钉钉场景中的实践要点
将千聚接入钉钉时,建议注意以下几点:
- 网络请求超时设置:建议设置合理的超时时间,以应对模型响应延迟。
- 错误处理:对API调用返回的错误码进行捕获,便于排查问题。
- 模型切换:利用千聚的模型列表灵活切换,测试不同模型在钉钉场景下的表现。
这种方案很适合作为统一模型接入的备用方案或主方案,减少多平台切换的维护成本。
现在就可以开始行动:访问千聚AI中转站官网,注册账号,获取API Key,并完成一次模型调用测试。钉钉接入模型中转站方案的配置、充值、调用全流程,只需几分钟即可跑通。