TokenPostie 最终用户文档

模型列表 API

接口

GET /v1/models
Authorization: Bearer tp_your_api_key

用途

GET /v1/models 用于发现当前 API Key 实际可调用的模型。返回结果会受到以下条件影响：

  • API Key 是否有效。
  • API Key 的模型 allow-list。
  • 项目的模型 allow-list。
  • 模型是否已经商业发布。
  • 上游 route 是否启用。

返回示例

{
  "object": "list",
  "data": [
    {
      "id": "TokenPostie-deepseek-v4-flash",
      "object": "model",
      "created": 0,
      "owned_by": "tokenpostie",
      "capability": "llm"
    }
  ]
}

字段说明

字段含义
id请求其他接口时使用的模型名
objectOpenAI 兼容对象类型
owned_by固定为 tokenpostie
capability能力类型，例如 llm、embedding、rerank

客户端建议

  • 应在应用启动或 API Key 变更时调用一次模型列表。
  • 不要把文档示例中的占位模型名当成真实模型名。
  • 如果返回列表为空，应检查 API Key、模型授权、项目策略或余额状态。