DEVELOPERS / API

API 文档

OpenAI 协议完全兼容，已有应用无需改造代码即可迁移。

BASE URL

https://api.smartokenx.com/v1

端点一览

方法	路径	说明
POST	/v1/chat/completions	对话补全，支持流式 SSE 输出。
POST	/v1/completions	文本补全（兼容 legacy 模型）。
POST	/v1/embeddings	文本向量化，支持 bge、m3e 等开源模型。
GET	/v1/models	列出当前可用模型与上下文长度。
POST	/v1/rerank	段落重排，常用于 RAG 检索增强。
GET	/v1/usage	查询账户用量与配额。

示例请求

curl https://api.smartokenx.com/v1/chat/completions \
  -H "Authorization: Bearer $SMARTOKENX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v3",
    "stream": true,
    "messages": [
      {"role": "user", "content": "用一句话介绍 SmarTokenX"}
    ]
  }'

认证

所有请求需在 Header 携带 Authorization: Bearer YOUR_API_KEY。可在控制台「API Keys」管理与轮换密钥。

错误码

401 — 鉴权失败，API Key 无效或过期
429 — 触发限流，请稍后重试或升级套餐
500 — 服务端异常，自动 fail-over 到备用集群