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"
}

图片生成（Images）

GPT 图片模型（gpt-image-2.5-flare、gpt-image-2.5-sunburst）使用 OpenAI Images 协议，按生成张数计费。在 Codex 中通过技能调用的方式见 用 Codex 生成图片。

GPT 图片模型一律返回 Base64 编码的图片（b64_json），不支持 response_format 参数；旧版 DALL·E 模型的 url 返回和 style 参数不适用于本系列。

文生图

POST /v1/images/generations

完整地址：

https://api.tokenflows.org/v1/images/generations

Content-Type: application/json

常用参数

关于 size 自定义分辨率：宽高须均为 16 的倍数，宽高比在 1:3 到 3:1 之间，最高支持 3840x2160（超过 2560x1440 为实验性支持）。

示例请求

{
  "model": "gpt-image-2.5-flare",
  "prompt": "一只戴贝雷帽、坐在木桌上的小水獭，柔和光线",
  "size": "1024x1024",
  "quality": "high",
  "n": 1
}

示例响应

{
  "created": 1718000000,
  "data": [
    {
      "b64_json": "iVBORw0KGgo..."
    }
  ],
  "output_format": "png",
  "quality": "high",
  "size": "1024x1024"
}

data[].b64_json 为 Base64 编码的图片内容，需自行解码保存为文件。

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

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

错误码

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