Chinese model APIs on one OpenAI-compatible key. Browse models

中文接入指南

五分钟接入中国大模型 API

保留 OpenAI SDK 写法,把 baseURL 改成 SmarToken,使用你的 SmarToken 密钥与目录中的模型 ID。英文完整参数表见 /docs。

  1. 1. 登录并充值

    使用 Google 登录,向美元钱包充值后再发生产流量。可先查看 中文定价。

  2. 2. 创建 API Key

    在控制台创建服务端密钥,必要时设置日/月预算与模型范围。

  3. 3. 设置 Base URL

    https://thesmartoken.com/v1

  4. 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. 5. 核对用量

    在控制台查看 token、美元成本与密钥预算;余额不足时接口返回 HTTP 402。

流式与非流式

  • stream: false(默认):一次返回完整 JSON。
  • stream: true:SSE 增量输出,适合聊天与长生成。
  • 工具调用、结构化输出、多模态输入等能力以英文 docs 当前声明为准,不要默认全部支持。

线路状态怎么理解

  • Live:可按文档直接用于生产验证与调用。
  • Integrating:已在公开目录中,专线仍在联调;上线前请复查 GET /v1/models。

常见错误信号

  • 401:密钥无效或缺失。
  • 402:余额不足,应停止自动重试并先充值。
  • 429:触发限流或预算;降低并发或提高预算。