指南

API 接口调用

通过 HTTP 请求直接调用 API，支持任何编程语言

接口地址

text

https://tokenhub.local/v1

认证方式

所有请求需要在 Header 中携带 API Key：

text

Authorization: Bearer sk-your-api-key

curl 调用

Chat Completions

bash

curl https://tokenhub.local/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "你好"}
    ],
    "max_tokens": 100
  }'

Claude Messages（条件能力）（需单独验证）

如当前环境尚未验证 Anthropic Messages 兼容路径，请先不要将下列示例视为默认可用能力：

bash

curl https://tokenhub.local/v1/messages \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "messages": [
      {"role": "user", "content": "你好"}
    ],
    "max_tokens": 100
  }'

获取模型列表

bash

curl https://tokenhub.local/v1/models \
  -H "Authorization: Bearer sk-your-api-key"

Python SDK

安装 OpenAI SDK：

bash

pip install openai

python

from openai import OpenAI

client = OpenAI(
    base_url="https://tokenhub.local/v1",
    api_key="sk-your-api-key",
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "你好"}],
    max_tokens=100,
)

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

Node.js SDK

bash

npm install openai

javascript

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://tokenhub.local/v1",
  apiKey: "sk-your-api-key",
});

const response = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [{ role: "user", content: "你好" }],
  max_tokens: 100,
});

console.log(response.choices[0].message.content);

流式输出

仅在当前网关流式能力已验证时启用 "stream": true；若环境尚未完成验证，请先按非流式调用路径接入：

python

stream = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "写一首诗"}],
    stream=True,
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

所有接口详细参数请参考左侧「接口文档」分组。

Related guides

API 接口列表