参考文档

API 参考

TokenFast 提供与 OpenAI 兼容的 Endpoint。所有请求均应发送至下方的 Base URL，并在 Authorization header 中携带您的 API Key。

Base URL: https://api.tokenfast.ai/v1

Endpoint 列表

POST /v1/chat/completions —— 创建一次对话补全
GET /v1/models —— 列出当前可用模型
GET /v1/usage/keys —— 查询账户下每把 Key 的用量

POST/v1/chat/completions

为给定的对话生成模型响应。这是与语言模型交互的主要 Endpoint。

请求体

参数	类型	说明
`model`必填	`string`	要使用的 Model 的 ID（例如：gpt-4o、claude-sonnet-4-6、gemini-2.5-pro）。
`messages`必填	`array`	组成本次对话的消息列表。每条消息包含一个角色（system、user 或 assistant）和对应内容。
`temperature`	`number`	采样温度，取值范围 0 到 2。值越高，输出越随机。默认值：1。
`max_tokens`	`integer`	响应中生成的 Token 数上限。默认值因模型而异。
`top_p`	`number`	核采样（Nucleus sampling）参数，可作为 temperature 的替代方案。默认值：1。
`stream`	`boolean`	若为 true，部分消息增量将以 server-sent events 的形式推送。默认值：false。
`stop`	`string \| array`	最多 4 个停止序列，API 在生成到该序列时将停止继续输出 Token。
`presence_penalty`	`number`	基于 Token 是否已在文本中出现进行惩罚。取值范围：-2.0 到 2.0。
`frequency_penalty`	`number`	基于 Token 在文本中出现的频次进行惩罚。取值范围：-2.0 到 2.0。
`tools`	`array`	模型可调用的工具（函数）列表。每个工具需定义类型、函数名、说明以及参数 schema。
`tool_choice`	`string \| object`	控制调用哪个工具。可选值："none"、"auto"，或指定具体的工具对象。
`response_format`	`object`	用于指定响应格式的对象。如需 JSON 模式，请使用 {"type": "json_object"}。

Message 对象

字段	类型	说明
`role`必填	`string`	消息作者的角色："system"、"user" 或 "assistant"。
`content`必填	`string`	消息的内容。
`name`	`string`	可选的参与者名称。

请求示例

cURL

curl https://api.tokenfast.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Explain quantum computing in simple terms."}
    ],
    "temperature": 0.7,
    "max_tokens": 512
  }'

响应示例

JSON

{
  "id": "chatcmpl-abc123def456",
  "object": "chat.completion",
  "created": 1712345678,
  "model": "gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Quantum computing uses quantum bits (qubits) that can exist in multiple states simultaneously..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 28,
    "completion_tokens": 156,
    "total_tokens": 184
  }
}

GET/v1/models

列出当前可用的模型及其能力与定价信息。该 Endpoint 无需鉴权。

参数

该 Endpoint 不接收任何参数。

请求示例

cURL

curl https://api.tokenfast.ai/v1/models

响应示例

JSON

{
  "object": "list",
  "data": [
    {
      "id": "gpt-4o",
      "object": "model",
      "owned_by": "openai",
      "capabilities": ["chat", "code", "vision", "function_calling", "json_mode"],
      "context_window": 128000,
      "pricing": {
        "input_per_million": 2.50,
        "output_per_million": 10.00
      }
    },
    {
      "id": "claude-sonnet-4-6",
      "object": "model",
      "owned_by": "anthropic",
      "capabilities": ["chat", "code", "vision", "function_calling"],
      "context_window": 200000,
      "pricing": {
        "input_per_million": 3.00,
        "output_per_million": 15.00
      }
    }
  ]
}

GET/v1/usage/keys

返回账户级用量报表：名下每把 API Key 的消费、请求数与 Token 用量，按自然日（北京时间）分桶。使用「用量查询 Key」（uk- 开头）鉴权——在控制台「设置」页生成的只读凭证，与调模型的 LLM Key 相互独立。

参数

`start`	`date，可选`	起始日期 YYYY-MM-DD（含当天，按北京时间切日）。默认为 end 往前 29 天。
`end`	`date，可选`	结束日期 YYYY-MM-DD（含当天）。默认为今天。单次跨度上限 92 天。

请求示例

cURL

curl "https://api.tokenfast.ai/v1/usage/keys?start=2026-06-09&end=2026-07-08" \
  -H "Authorization: Bearer uk-your-usage-query-key"

响应示例

JSON

{
  "object": "usage.keys",
  "start": "2026-06-09",
  "end": "2026-07-08",
  "timezone": "Asia/Shanghai",
  "keys": [
    {
      "name": "production-backend",
      "hint": "sk-...Xy4a",
      "status": "ACTIVE",
      "blocked": false,
      "created_at": "2026-07-01T02:10:00.000Z",
      "total": {
        "spend_usd": 12.48,
        "requests": 1042,
        "prompt_tokens": 180311,
        "completion_tokens": 95204
      },
      "daily": [
        {
          "date": "2026-07-08",
          "spend_usd": 1.02,
          "requests": 88,
          "prompt_tokens": 15200,
          "completion_tokens": 8100
        }
      ]
    }
  ]
}

区间内有用量的已吊销 Key 也会返回（status 为 REVOKED），保证历史报表完整；没有流量的日期不会出现在 daily 里。

限流

每把查询 Key 每分钟 30 次，每 IP 每分钟 120 次。

超限返回 429 并带 Retry-After 响应头。查询 Key 不能调用模型，该限流与您的 LLM 调用完全无关。做 T+1 日报，每天查一次即可。

鉴权

除 GET /v1/models 外，所有 Endpoint 均需在 Authorization header 中通过 Bearer Token 进行鉴权：

Authorization: Bearer sk-your-api-key

您可在控制台中创建并管理 API Key。若请求未携带有效 Key，您将收到 401 Unauthorized 响应。

Rate Limit

Rate Limit 按 API Key 单独计算。当请求超过限额时，API 将返回 429 状态码。响应 header 包括：

Header	说明
x-ratelimit-limit-requests	当前 Key 每分钟的最大请求数
x-ratelimit-remaining-requests	当前时间窗口内剩余的请求数
x-ratelimit-limit-tokens	当前 Key 每分钟的最大 Token 数
x-ratelimit-remaining-tokens	当前时间窗口内剩余的 Token 数
retry-after	建议的等待时长（秒），仅在 429 响应中返回

更多细节请参阅错误码页面。