如何认证

/v1/* 兼容 API（包括 GET /v1/models）需要用户 API Key 鉴权。公开模型列表请使用 /api/v1/public/model/list。

TokenMP 同时支持 OpenAI 常用的 Authorization Bearer 与 Anthropic 客户端常用的 x-api-key；如果两个 Header 同时存在，服务端会优先使用 x-api-key。

Authorization: Bearer sk-xxx...
x-api-key: sk-xxx...

支持的 API 端点

发送一条 Chat 请求

{
  "model": "glm-5.1",
  "messages": [
    {"role": "system", "content": "你是一个有帮助的助手。"},
    {"role": "user", "content": "你好！"}
  ],
  "stream": false,
  "temperature": 0.7,
  "max_tokens": 2048
}

生成一张图片

POST /v1/images/generations 使用 OpenAI Images 兼容格式，适用于 Panel 中已启用且声明图片生成能力的模型。

模型 ID、尺寸、返回格式和可用参数以 /v1/models、当前路由配置和上游供应商能力为准。

// Request
{
  "model": "image-generation-model",
  "prompt": "一只橘猫坐在赛博朋克风格的屋顶上",
  "size": "1024x1024",
  "n": 1
}

// Response
{
  "created": 1765699200,
  "data": [
    {
      "url": "https://example.com/generated-image.png"
    }
  ]
}

模型上下文与输出上限

下面是 TokenMP 文档建议的模型能力标注。上下文窗口是输入、历史、工具结果和预留输出的总预算；max_tokens / max output 是单次生成上限，实际请求还会受上游、路由和工具客户端限制。

长上下文不等于每次都应塞满上下文。Agent 工具通常还需要给工具调用、压缩摘要和最终输出预留空间；如果出现 context length 或 max_tokens 报错，请减少输入文件、降低 max_tokens 或切换更大上下文模型。

模型限制资料来源

客户端错误 (4xx)

项目内稳定错误码以 internal/errorcodes/codes.go 为准。Management API 在 envelope.error_code 返回；/v1/* 协议兼容接口在 OpenAI 风格 error.code 返回；请求日志保存 request_logs.error_code。

上游供应商原始错误不会直接作为平台 error_code 暴露；管理员排障字段使用 provider_error_code、provider_error_type 和 provider_http_status 保存原始信号。HTTP 列为常见终态，少数上游归一化错误会保留上游实际状态码。

兼容 OpenAI 的 error.type 仍可能是 invalid_request_error、authentication_error、insufficient_balance、rate_limit_exceeded、upstream_error 或 server_error；客户端判断业务原因时应优先读取稳定平台码 error.code / error_code。

服务端与上游错误 (5xx)

兑换码错误