Skip to content
文本生成

Messages ​

Anthropic Messages 协议。发送一组消息,返回模型生成的下一条消息。Claude 分组首选此接口。

POST/v1/messages

请求头 ​

x-api-keystring必填

ThetaIO API Key。也可用 Authorization: Bearer。

anthropic-versionstring

协议版本,例如 2023-06-01。官方 SDK 会自动添加。

anthropic-betastring

启用上游 Beta 特性,原样透传。

请求体 ​

modelstring必填

模型 ID,例如 claude-sonnet-4-6。可用值见 Models。

messagesobject[]必填

对话消息,role 为 user 或 assistant,content 为字符串或内容块数组(文本、图像、工具结果等)。

max_tokensinteger必填

本次生成的最大输出 Token 数。

systemstring | object[]

系统提示。

streamboolean

为 true 时以 SSE 流式返回。

toolsobject[]

可供模型调用的工具定义。

thinkingobject

扩展思考配置,支持情况取决于模型。

temperaturenumber

采样温度。

其余字段按 Anthropic 官方协议透传。

示例 ​

bash
curl https://api.thetaio.tech/v1/messages \
  -H "x-api-key: $THETAIO_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "system": "你是一名简洁的助手。",
    "messages": [{"role": "user", "content": "解释什么是提示缓存"}]
  }'
python
import anthropic

client = anthropic.Anthropic(base_url="https://api.thetaio.tech", api_key="sk-...")
with client.messages.stream(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "解释什么是提示缓存"}],
) as stream:
    for text in stream.text_stream:
        print(text, end="")

响应 ​

json
{
  "id": "msg_01...",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-6",
  "content": [{ "type": "text", "text": "提示缓存是……" }],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 32,
    "output_tokens": 210,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  }
}

计算 Token ​

POST/v1/messages/count_tokens

请求体与 /v1/messages 相同(无需 max_tokens),返回输入 Token 数。此接口校验余额,但不计费、不记录用量。

json
{ "input_tokens": 32 }