中文接入指南
五分钟接入中国大模型 API
保留 OpenAI SDK 写法,把 baseURL 改成 SmarToken,使用你的 SmarToken 密钥与目录中的模型 ID。英文完整参数表见 /docs。
- 1. 登录并充值
使用 Google 登录,向美元钱包充值后再发生产流量。可先查看 中文定价。
- 2. 创建 API Key
在控制台创建服务端密钥,必要时设置日/月预算与模型范围。
- 3. 设置 Base URL
https://thesmartoken.com/v1 - 4. 发送首个请求
curl --fail-with-body -sS "https://thesmartoken.com/v1/chat/completions" \ -H "Authorization: Bearer $SMTOKEN_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model":"deepseek-chat", "messages":[{"role":"user","content":"用一句话介绍你自己"}], "max_tokens":64 }' - 5. 核对用量
在控制台查看 token、美元成本与密钥预算;余额不足时接口返回 HTTP 402。
流式与非流式
stream: false(默认):一次返回完整 JSON。stream: true:SSE 增量输出,适合聊天与长生成。- 工具调用、结构化输出、多模态输入等能力以英文 docs 当前声明为准,不要默认全部支持。
线路状态怎么理解
- Live:可按文档直接用于生产验证与调用。
- Integrating:已在公开目录中,专线仍在联调;上线前请复查 GET /v1/models。
常见错误信号
- 401:密钥无效或缺失。
- 402:余额不足,应停止自动重试并先充值。
- 429:触发限流或预算;降低并发或提高预算。