Anthropic Messages API

接口

POST /v1/messages
x-api-key: tp_your_api_key
anthropic-version: 2023-06-01
Content-Type: application/json

也可以使用 TokenPostie 标准 Bearer 鉴权:

Authorization: Bearer tp_your_api_key

使用前提

先调用 GET /v1/models,把返回的 data[].id 填入 model。不要猜测模型名,也不要把文档里的占位符当成真实模型。

请求体

字段必填说明
modelGET /v1/models 返回且 capability 为 llm 的模型 id
max_tokens最大输出 token 数,必须是正整数
messages支持 userassistant
system系统提示词,支持字符串或 text block 数组
temperature目标模型支持时透传

content 首期只支持字符串或 text block:

{ "type": "text", "text": "你好" }

示例

curl -X POST "https://newapi.yxhhkj.com/v1/messages" \
  -H "x-api-key: tp_your_api_key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "model_from_models_api",
    "max_tokens": 1024,
    "system": "请保持简洁。",
    "messages": [
      {
        "role": "user",
        "content": [
          { "type": "text", "text": "请用一句话介绍 TokenPostie" }
        ]
      }
    ]
  }'

流式响应

纯文本请求支持 stream: true,返回 Anthropic-compatible SSE。流中上游异常会转换成 event: error,只包含 TokenPostie 标准错误码和安全文案。

当前限制

TokenPostie Messages V1 暂不支持以下 Anthropic 能力:

  • 工具调用 toolstool_choice
  • thinking、top_k、stop_sequences
  • cache_control
  • 图片、文档、工具结果等非 text content block

如果请求包含这些字段,TokenPostie 会在调用上游前返回明确错误。请保留响应里的请求 ID,方便排障。

计费口径

该入口与 Chat Completions 共用同一套余额、限额、请求日志和账单口径。计费 token 以 TokenPostie 记录的已确认用量为准,不以请求前估算值为准。