Protokener / DOCUMENTATION
快速开始
从账户、密钥到第一次调用。保留熟悉的 SDK，只更换平台地址与模型。
示例使用占位密钥；模型与价格以实时目录为准。
接入前准备
- 登录金融控制台，确认账户已有可用的订阅或流量积分。
- 在 API 密钥页面创建独立应用密钥，检查有效期、积分上限与模型权限。
- 通过模型目录选择支持目标协议的在线模型；展示名称不能代替精确 Model ID。
- 在服务器或本地安全保存密钥，不要写入公开仓库或网页前端。
选择接入方式
| OpenAI SDK / Chat Completions | https://protokener.com/v1 · 适用于通用对话与兼容工具 |
|---|---|
| OpenAI Responses / Codex | https://protokener.com/v1 · 选择支持 Responses 的模型 |
| Anthropic / Claude Code | https://protokener.com · 客户端追加 /v1/messages |
| WorkBuddy / CodeBuddy | 下载平台完整配置包，无需手动拼接地址 |
先读取模型目录
curl https://protokener.com/v1/models \
-H "Authorization: Bearer $PROTOKENER_API_KEY"目录返回当前密钥可见的实时模型，不代表每个模型都支持全部协议。保留 id 中的路由前缀。请在控制台查看协议、能力与倍率，再选择对应接口。
cURL：发送第一条消息
curl https://protokener.com/v1/chat/completions \
-H "Authorization: Bearer $PROTOKENER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MODEL_ID",
"messages": [
{
"role": "user",
"content": "Hello, Protokener!"
}
],
"stream": true
}'Python SDK
# 安装：python -m pip install openai
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["PROTOKENER_API_KEY"],
base_url="https://protokener.com/v1",
)
response = client.chat.completions.create(
model="MODEL_ID",
messages=[{"role": "user", "content": "Hello, Protokener!"}],
)
print(response.choices[0].message.content)JavaScript SDK
// 安装：npm install openai；保存为 quick-start.mjs
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.PROTOKENER_API_KEY,
baseURL: "https://protokener.com/v1",
});
const response = await client.chat.completions.create({
model: "MODEL_ID",
messages: [{ role: "user", content: "Hello, Protokener!" }],
});
console.log(response.choices[0].message.content);验证调用与下一步
在使用记录中核对模型、结果、计费来源与积分消耗。读取目录不等于已完成推理；若出现错误，保留发生时间、错误码和请求 ID，切勿提供完整密钥。
资料来源：front/src/components/direct-api-guide.tsx · server/src/relay/relay.controller.ts