DEVELOPER HUB / 02

对接文档

保留熟悉的开发方式,打开更大的 AI 疆域。从配置端点到处理响应,在这里完成你的第一次调用。

BUILD WITH OJ一个入口,连接多元 AI 能力。
QUICKSTART

从一行配置开始

使用 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对话生成
参数类型说明
modelstring · 必填控制台中对应的模型 ID
messagesarray · 必填包含 role、content 的对话列表
streamboolean设为 true 时使用流式输出,默认 false
temperaturenumber调节输出随机性;是否支持取决于模型
查看成功响应示例 +
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}
}

在你熟悉的工具里使用

Cursor / VS Code在支持自定义 OpenAI 端点的工具中,填入 Base URL、API Key 与实际模型 ID。具体字段以插件版本为准。
LangChain使用 ChatOpenAI 配置 base_url、api_key 与 model,复用现有应用中的链式调用。
Claude Code需要 Anthropic 兼容的 Messages 接口。启用前请确认网关支持情况及专用端点,勿直接套用聊天接口配置。

遇到问题,从这里排查

状态可能原因处理方式
400参数格式错误检查 model、messages 和模型支持的参数。
401鉴权失败检查 Authorization 中的 Bearer Key 是否有效。
403权限受限检查项目、模型权限及账户状态。
429触发速率限制降低并发,结合 Retry-After 做退避重试。
5xx网关或上游错误记录请求 ID,适度重试并反馈错误时间。
准备将 AI 接入团队业务?

一起规划接入方式、用量预算与上线流程。

了解企业合作 ↗