Anthropic Messages

第 1 版 · 更新于 2026-11-12 · 阅读约 1 分钟

通过 Runtoken 调用原生 Anthropic Messages 接口。

准备工作#

开始前，请准备：

• 在控制台创建的平台 API Key。
• 使用 Anthropic Messages 协议的准确模型 ID。
• 可发送相应请求头的服务端 HTTP 环境。

接口与鉴权#

在 x-api-key 中填写平台 Key，并携带 anthropic-version 请求头。

本例使用 anthropic-version: 2023-06-01，向 https://api.runtoken.net 发送 JSON。

发送请求#

提交用户消息，通过 max_tokens 设置本次输出的 token 预算，并开启流式输出。

curl -N 'https://api.runtoken.net/v1/messages' \
  -H 'x-api-key: YOUR_PLATFORM_KEY' \
  -H 'anthropic-version: 2023-06-01' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "YOUR_MODEL_ID",
    "max_tokens": 256,
    "messages": [{ "role": "user", "content": "Hello!" }],
    "stream": true
  }'

运行示例前，请替换以下占位值。

max_tokens 在本例中设为 256，表示本次输出的 token 预算，不是平台限额。

管理对话#

由应用保留对话，并在每轮请求中提交需要的消息。推理不会自动保存上一轮的上下文。

请按 Messages 协议处理返回的流式数据，不要套用 Chat Completions 的事件结构。

模型专属选项#

增加图像输入、工具、扩展推理或其他协议请求头之前，应确认所选模型是否支持。示例中的版本请求头不代表原生 API 的全部能力均已开放。

处理输出中断#

平台可以在开始输出前切换通道，开始输出后不会再切换。如果流式连接中断，应保留已收到的内容，再决定是否重新请求；中断的请求可能进入计费复核。

下一步#

另一种原生协议的接入方式见 Gemini v1beta，接口总览见接入指南。