从一行配置开始
使用 OpenAI 兼容接口,将 Base URL 指向 OjToken,并填入你的项目密钥。以下端点为品牌示例,正式接入时请替换为控制台提供的地址。
BASE URL · 示例端点
https://api.ojtoken.ai/v1最小接入示例
先安装对应 SDK:Python 使用 pip install openai,Node.js 使用 npm install openai。在运行环境中设置 OJTOKEN_API_KEY。
quickstart.pyOJ / SDK
API 参考
下面展示标准聊天接口的请求结构。模型支持的参数和功能以实际接口说明为准。
POST
/v1/chat/completions对话生成| 参数 | 类型 | 说明 |
|---|---|---|
model | string · 必填 | 控制台中对应的模型 ID |
messages | array · 必填 | 包含 role、content 的对话列表 |
stream | boolean | 设为 true 时使用流式输出,默认 false |
temperature | number | 调节输出随机性;是否支持取决于模型 |
查看成功响应示例 +
response.json
{
"id": "chatcmpl-example",
"object": "chat.completion",
"model": "deepseek-v4.1-flash",
"choices": [{
"index": 0,
"message": {"role": "assistant", "content": "Hello!"},
"finish_reason": "stop"
}],
"usage": {"prompt_tokens": 12, "completion_tokens": 3, "total_tokens": 15}
}在你熟悉的工具里使用
遇到问题,从这里排查
| 状态 | 可能原因 | 处理方式 |
|---|---|---|
400 | 参数格式错误 | 检查 model、messages 和模型支持的参数。 |
401 | 鉴权失败 | 检查 Authorization 中的 Bearer Key 是否有效。 |
403 | 权限受限 | 检查项目、模型权限及账户状态。 |
429 | 触发速率限制 | 降低并发,结合 Retry-After 做退避重试。 |
5xx | 网关或上游错误 | 记录请求 ID,适度重试并反馈错误时间。 |