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 }