OpenAI 兼容接入

Tokeness 提供 OpenAI 兼容接口。大多数支持自定义 OpenAI Base URL 的 SDK、Chat 客户端和自动化工具都可以接入。

本页配置的是 OpenAI 兼容协议，示例使用 POST /v1/chat/completions。它只说明 Tokeness 对该协议的接入边界，不代表 Anthropic API 的所有字段、工具调用或其他能力都会在转换后保持一致，也不能仅凭返回内容证明模型身份。

基础配置

Base URL: https://n.tokeness.dev/v1
API Key: 你的 Tokeness API Key

代码调用

先安装 SDK：

npm install openai

pip install openai

Node.js

创建 test-tokeness.mjs，把 YOUR_TOKENESS_API_KEY 和 YOUR_MODEL_NAME 换成自己的值。

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: 'YOUR_TOKENESS_API_KEY',
  baseURL: 'https://n.tokeness.dev/v1'
})

const completion = await client.chat.completions.create({
  model: 'YOUR_MODEL_NAME',
  messages: [
    { role: 'system', content: 'You are a concise assistant.' },
    { role: 'user', content: 'Say hello from Tokeness.' }
  ]
})

console.log(completion.choices[0]?.message?.content)

运行：

node test-tokeness.mjs

Python

创建 test_tokeness.py，把 YOUR_TOKENESS_API_KEY 和 YOUR_MODEL_NAME 换成自己的值。

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_TOKENESS_API_KEY",
    base_url="https://n.tokeness.dev/v1",
)

response = client.chat.completions.create(
    model="YOUR_MODEL_NAME",
    messages=[
        {"role": "user", "content": "Say hello from Tokeness."}
    ],
)

print(response.choices[0].message.content)

cURL

curl https://n.tokeness.dev/v1/chat/completions \
  -H "Authorization: Bearer $TOKENESS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_NAME",
    "messages": [
      { "role": "user", "content": "Say hello from Tokeness." }
    ]
  }'

模型名称

模型名称以控制台“模型广场”或后台返回为准。复制模型名时保留大小写、连字符和版本号。

首次接入时，先从模型广场复制一个可用模型名，再回到示例里替换 YOUR_MODEL_NAME。

模型广场

常见错误

现象	可能原因
401 或鉴权失败	Key 错误、Key 被禁用、请求头缺少 Bearer
余额不足	钱包余额不足或 Key 额度耗尽
模型不存在	模型名拼写错误，或当前分组不支持该模型
请求格式错误	使用了非 OpenAI 兼容格式，或 Base URL 少了 /v1