创建消息（Anthropic Messages）

Anthropic Messages 接口。Anthropic SDK 和 Claude Code 的 Base URL 填 https://bigmodel.io，客户端会自己拼上 /v1/messages。Anthropic 分组原生提供；OpenAI 分组在允许 Messages 调度时会转换处理；仅对话补全分组（DeepSeek、GLM 平台）返回 404。

#请求

POST https://bigmodel.io/v1/messages

#认证

任选其一。

#请求头

#请求体

标准 Anthropic Messages 请求体。

#响应

#响应字段

stream: true 时返回 Anthropic 事件流：message_start、content_block_start、content_block_delta、content_block_stop、message_delta、message_stop。

#示例

curl https://bigmodel.io/v1/messages \
  -H "Authorization: Bearer $BIGMODEL_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.3",
    "max_tokens": 256,
    "system": "你是一个简洁的助手。",
    "messages": [{"role": "user", "content": "用一句话解释 HTTP 429。"}]
  }'

import os
from anthropic import Anthropic

client = Anthropic(base_url="https://bigmodel.io", api_key=os.environ["BIGMODEL_API_KEY"])

msg = client.messages.create(
    model="glm-5.3",
    max_tokens=256,
    system="你是一个简洁的助手。",
    messages=[{"role": "user", "content": "用一句话解释 HTTP 429。"}],
)
print(msg.content[0].text)

import Anthropic from '@anthropic-ai/sdk'

const client = new Anthropic({baseURL: 'https://bigmodel.io', apiKey: process.env.BIGMODEL_API_KEY})

const msg = await client.messages.create({
  model: 'glm-5.3',
  max_tokens: 256,
  system: '你是一个简洁的助手。',
  messages: [{role: 'user', content: '用一句话解释 HTTP 429。'}],
})
console.log(msg.content[0].text)

响应示例（id、文本和 token 数仅作示意）：

{
  "id": "msg_...",
  "type": "message",
  "role": "assistant",
  "model": "glm-5.3",
  "content": [
    {"type": "text", "text": "HTTP 429 表示你在一段时间内请求过多，需要稍后重试。"}
  ],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 21, "output_tokens": 19, "cache_creation_input_tokens": 0, "cache_read_input_tokens": 0}
}

#流式输出

with client.messages.stream(
    model="glm-5.3",
    max_tokens=256,
    messages=[{"role": "user", "content": "从 1 数到 3。"}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

const stream = client.messages.stream({
  model: 'glm-5.3',
  max_tokens: 256,
  messages: [{role: 'user', content: '从 1 数到 3。'}],
})
stream.on('text', text => process.stdout.write(text))
await stream.finalMessage()

#提示词缓存

{
  "model": "glm-5.3",
  "max_tokens": 256,
  "system": [
    {"type": "text", "text": "<较长且稳定的指令>", "cache_control": {"type": "ephemeral"}}
  ],
  "messages": [{"role": "user", "content": "第一个问题"}]
}

#说明

• 仅对话补全分组返回 404。 DeepSeek、GLM 平台分组的 Key 会收到 not_found_error："… platform only supports /v1/chat/completions; /v1/messages is not available"。请改用对话补全，或换一个提供 Messages 的分组的 Key。
• OpenAI 分组只有在分组允许时才转换 Messages 请求，否则返回 403："This group does not allow /v1/messages dispatch"。
• model 必填，缺少时返回 400 invalid_request_error。分组不提供或拼错的模型返回 503 api_error（"No available accounts"），不是 404。
• 提示词缓存。 cache_control 会透传。最多保留 4 个缓存断点，多余的依次从 tools、messages、system 中移除。thinking 块上的 cache_control 会被去掉。缓存写入和读取分别按模型的缓存写入价、缓存读取价计费。详见提示词缓存。
• 思考。 thinking 和 output_config.effort 会被读取并转发。如果对话历史中的思考块或工具 ID 无法被模型接受，会返回 409 malformed_session_state，请开新会话。详见推理与思考。
• metadata.user_id。 同一会话发送固定的值，会话中的请求会被一致地处理，有助于提示缓存命中。
• 错误使用 Anthropic 结构 {"type":"error","error":{...}}，Key 检查阶段的错误除外（{"code","message"}）。流式过程中的错误以 SSE error 事件返回。完整列表见错误码。

#相关文档

• Claude Code
• Anthropic SDK
• 计算 token
• 提示词缓存