跳转到主要内容
POST
/
v1
/
messages
创建消息 (Create a Message)
curl --request POST \
  --url https://api.anthropic.com/v1/messages \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "model": "claude-opus-4-7",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "你好,Claude!请简要介绍一下你自己。"
    }
  ],
  "temperature": 1,
  "stream": false
}
'
{
  "id": "msg_01ABCDxyz0123456789",
  "content": [
    {
      "citations": [
        {
          "cited_text": "<string>",
          "document_index": 123,
          "document_title": "<string>",
          "end_char_index": 123,
          "file_id": "<string>",
          "start_char_index": 123,
          "type": "char_location"
        }
      ],
      "text": "<string>",
      "type": "text"
    }
  ],
  "model": "claude-opus-4-7",
  "role": "assistant",
  "type": "message",
  "usage": {
    "input_tokens": 123,
    "output_tokens": 123,
    "cache_creation": {
      "ephemeral_1h_input_tokens": 123,
      "ephemeral_5m_input_tokens": 123
    },
    "cache_creation_input_tokens": 123,
    "cache_read_input_tokens": 123,
    "inference_geo": "<string>",
    "iterations": [
      {
        "cache_creation": {
          "ephemeral_1h_input_tokens": 123,
          "ephemeral_5m_input_tokens": 123
        },
        "cache_creation_input_tokens": 123,
        "cache_read_input_tokens": 123,
        "input_tokens": 123,
        "output_tokens": 123,
        "type": "message"
      }
    ],
    "server_tool_use": {
      "web_fetch_requests": 123,
      "web_search_requests": 123
    },
    "service_tier": "standard",
    "speed": "standard"
  },
  "container": {
    "id": "<string>",
    "expires_at": "2023-11-07T05:31:56Z",
    "skills": [
      {
        "skill_id": "<string>",
        "type": "anthropic",
        "version": "<string>"
      }
    ]
  },
  "context_management": {
    "applied_edits": [
      {
        "cleared_input_tokens": 123,
        "cleared_tool_uses": 123,
        "type": "clear_tool_uses_20250919"
      }
    ]
  },
  "stop_details": {
    "category": "cyber",
    "explanation": "<string>",
    "type": "refusal"
  },
  "stop_reason": "end_turn",
  "stop_sequence": "\n\nHuman:"
}

Documentation Index

Fetch the complete documentation index at: https://docs.senseaudio.cn/llms.txt

Use this file to discover all available pages before exploring further.

授权

x-api-key
string
header
必填

请求头

anthropic-beta
string

可选请求头,用于指定要使用的 Beta 版本,多个值使用逗号分隔。

示例:

"message-batches-2024-09-24,prompt-caching-2024-07-31"

anthropic-version
string
默认值:2023-06-01

Anthropic API 版本。

示例:

"2023-06-01"

请求体

application/json
max_tokens
integer
必填

生成的最大 token 数,达到该值后模型将停止生成。

示例:

1024

messages
object[]
必填

输入消息列表。单次请求最多包含 100,000 条消息。

Maximum array length: 100000
model
必填

用于补全你提示词的模型。

可用选项:
claude-opus-4-7,
claude-mythos-preview,
claude-opus-4-6,
claude-sonnet-4-6,
claude-haiku-4-5,
claude-haiku-4-5-20251001,
claude-opus-4-5,
claude-opus-4-5-20251101,
claude-sonnet-4-5,
claude-sonnet-4-5-20250929,
claude-opus-4-1,
claude-opus-4-1-20250805,
claude-opus-4-0,
claude-opus-4-20250514,
claude-sonnet-4-0,
claude-sonnet-4-20250514,
claude-3-haiku-20240307
示例:

"claude-opus-4-7"

cache_control
object

顶层缓存控制;将自动在请求中最后一个可缓存的内容块上添加 cache_control 标记。

container

容器标识符,用于跨请求复用。

context_management
object

上下文管理配置。控制 Claude 在多次请求之间如何管理上下文。

inference_geo
string | null

指定推理处理的地理区域。

示例:

"us"

mcp_servers
object[]

本次请求中使用的 MCP 服务器

metadata
object

描述请求相关的元数据对象。

output_config
object

模型输出配置选项,例如输出格式等。

output_format
object

已废弃:请改用 output_config.format。

service_tier
enum<string>
默认值:auto

是否优先使用优先容量(可用时),或仅使用标准容量。

可用选项:
auto,
standard_only
示例:

"auto"

speed
enum<string> | null
默认值:standard

推理速度模式。'fast' 模式启用每秒更高输出 token 数的推理。

可用选项:
standard,
fast
示例:

"standard"

stop_sequences
string[]

自定义停止文本序列,模型在生成到这些序列时会停止。

stream
boolean
默认值:false

是否通过 Server-Sent Events (SSE) 以增量方式流式返回响应。

示例:

false

system

系统提示词(System Prompt)。

示例:

"你是一个严谨且乐于助人的人工智能助手。"

temperature
number
默认值:1

响应的随机性强度。默认值为 1.0。

必填范围: 0 <= x <= 1
示例:

1

thinking
object

启用思考模式的配置。

tool_choice
object

由模型自行决定是否使用工具。

tools
object[]

模型可以使用的工具定义列表。

用户自定义工具定义。

top_k
integer

仅从每个后续 token 的 top-K 个候选中采样。

示例:

5

top_p
number

使用核采样(nucleus sampling)。

示例:

0.9

user_profile_id
string | null

用于归属本次请求的用户配置 ID。

示例:

"user-profile-123"

响应

成功响应:非流式模式返回完整消息,流式模式(stream=true)返回 Server-Sent Events 事件流。

模型生成的消息响应对象。

id
string
必填

唯一对象标识符。

示例:

"msg_01ABCDxyz0123456789"

content
object[]
必填

响应内容块列表。

model
必填

用于补全你提示词的模型。

可用选项:
claude-opus-4-7,
claude-mythos-preview,
claude-opus-4-6,
claude-sonnet-4-6,
claude-haiku-4-5,
claude-haiku-4-5-20251001,
claude-opus-4-5,
claude-opus-4-5-20251101,
claude-sonnet-4-5,
claude-sonnet-4-5-20250929,
claude-opus-4-1,
claude-opus-4-1-20250805,
claude-opus-4-0,
claude-opus-4-20250514,
claude-sonnet-4-0,
claude-sonnet-4-20250514,
claude-3-haiku-20240307
示例:

"claude-opus-4-7"

role
enum<string>
默认值:assistant
必填

消息角色,响应固定为 assistant。

可用选项:
assistant
示例:

"assistant"

type
enum<string>
默认值:message
必填

对象类型,固定为 message。

可用选项:
message
示例:

"message"

usage
object
必填

Billing and rate-limit usage.

container
object

Information about the container used in the request (for the code execution tool)

context_management
object
stop_details
object
stop_reason
enum<string>
可用选项:
end_turn,
max_tokens,
stop_sequence,
tool_use,
pause_turn,
compaction,
refusal,
model_context_window_exceeded
stop_sequence
string | null

触发停止生成的自定义停止序列(若命中)。

示例:

"\n\nHuman:"