API 参考

TokenFlows 提供 OpenAI 兼容协议和 Anthropic 兼容协议。你可以按 SDK、工具或模型类型选择对应端点。

基础 URL

Claude Code 的 ANTHROPIC_BASE_URL 请填写 https://api.tokenflows.org，不要加 /v1。

认证

OpenAI 兼容协议使用 Authorization 头：

Authorization: Bearer YOUR_API_KEY

Anthropic 兼容协议推荐使用 x-api-key 头，也兼容 Bearer Token：

x-api-key: YOUR_API_KEY

Authorization: Bearer YOUR_API_KEY

OpenAI Chat Completions

POST /v1/chat/completions

完整地址：

https://api.tokenflows.org/v1/chat/completions

常用参数

示例请求

{
  "model": "gpt-5.5",
  "messages": [
    {"role": "system", "content": "你是一个 helpful assistant。"},
    {"role": "user", "content": "介绍一下 TokenFlows"}
  ],
  "temperature": 0.7,
  "max_tokens": 1024
}

示例响应

{
  "id": "chatcmpl_xxx",
  "object": "chat.completion",
  "created": 1718000000,
  "model": "gpt-5.5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "TokenFlows 是一个面向开发者和 AI Agent 的模型网关。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 20,
    "completion_tokens": 100,
    "total_tokens": 120
  }
}

OpenAI Responses API

POST /v1/responses

完整地址：

https://api.tokenflows.org/v1/responses

Responses API 适合 GPT 系列、推理任务、工具调用和 Agent 工作流。

示例请求

{
  "model": "gpt-5.5",
  "input": "用三句话介绍 TokenFlows"
}

Anthropic Messages

POST /v1/messages

完整地址：

https://api.tokenflows.org/v1/messages

常用参数

示例请求

{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "system": "你是一个 helpful assistant。",
  "messages": [
    {"role": "user", "content": "介绍一下 TokenFlows"}
  ],
  "temperature": 0.7
}

示例响应

{
  "id": "msg_xxx",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-6",
  "content": [
    {
      "type": "text",
      "text": "TokenFlows 是一个面向开发者和 AI Agent 的模型网关。"
    }
  ],
  "usage": {
    "input_tokens": 20,
    "output_tokens": 100
  }
}

模型列表

GET /v1/models

完整地址：

https://api.tokenflows.org/v1/models

返回当前可用模型及元数据。站内可视化列表见 模型列表。

错误码

更多排查建议见 常见问题。