AGTCloud API Docs
文档指南API Reference集成与资源更新与帮助
文本与对话

Anthropic Messages

使用 Anthropic Messages 兼容结构发送消息与 Content Blocks。

Messages 接口使用 user、assistant 消息和 Content Blocks 创建模型响应,支持文本、图像、工具调用、流式输出与扩展思考。不同模型能够使用的内容块、工具和高级参数可能不同,请以当前 API Key 可见模型及实际接口能力为准。

POST/v1/messages

根据 user 与 assistant 消息生成下一条 assistant 响应。消息内容可以使用字符串,也可以使用文本、图像、工具和文档 Content Blocks。

接口支持普通 JSON 响应和 SSE 流式事件;图像、工具调用与扩展思考能力取决于所选模型。

Authorization

anthropicApiKey
x-api-key<token>

在 x-api-key Header 中传递 API Key。

In: header

Header Parameters

anthropic-version*string

指定要使用的 API 版本。

Default"2023-06-01"
anthropic-beta?string

指定要使用的 beta 版本。可以使用逗号分隔多个值,或多次发送该 Header。

Request Body

Messages 使用 Content Blocks 表达文本、图像、工具和扩展思考。请根据任务选择视图。

application/json
文本对话

使用 user 和 assistant 消息组织单轮或多轮文本对话;system 使用顶层字段。

model
当前 API Key 可见且支持 Messages 的模型 ID。
max_tokens
本次响应允许生成的最大 token 数量。
messages[]
按顺序排列的 user 与 assistant 消息。
application/json
{
  "model": "MODEL_ID",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "你好!请介绍一下自己。"
    }
  ]
}
字段参考完整字段保持一致,说明会针对当前使用场景突出重点

基础文本对话。messages 可以使用字符串内容,也可以使用 text 内容块。

图像、工具和扩展思考能力可能因模型与上游渠道不同而变化;建议先完成最小文本请求,再逐项启用高级字段。

Response Body

application/json

application/json

application/json

application/json

Anthropic Messages 官方文档查看上游协议定义与最新字段变化。