消息

POST

https://llm-api.mmchat.xyz/v1/messages

发送一个包含文本和/或图片内容的结构化输入消息列表，模型将生成对话中的下一条消息。
Messages API 既可用于单次查询，也可用于无状态的多轮对话。

Anthropic 官方文档参考：

快速开始

Messages API 文档

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://llm-api.mmchat.xyz/v1/messages' \
--header 'x-api-key: METACHAT_API_KEY' \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
        {
            "role": "user",
            "content": "Hello, world"
        }
    ]
}'

响应示例

200 - 成功示例

{
  "content": [
    {
      "text": "Hi! My name is Claude.",
      "type": "text"
    }
  ],
  "id": "msg_013Zva2CMHLNnXjNJJKqJ2EF",
  "model": "claude-sonnet-4-20250514",
  "role": "assistant",
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "type": "message",
  "usage": {
    "input_tokens": 2095,
    "output_tokens": 503
  }
}

请求参数

Header 参数

x-api-key

string

必需

MetaChat API Key

示例值:

METACHAT_API_KEY

anthropic-version

string

必需

Anthropic API 版本，目前最新版本 2023-06-01

示例值:

2023-06-01

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

model

string

必需

模型版本，目前支持 claude-opus-4-20250514、claude-sonnet-4-20250514、claude-3-5-haiku-20241022。

max_tokens

integer

必需

生成停止前的最大令牌数。

不同模型对此参数有不同的最大值限制，目前 Claude 4 Opus 为 32000，Claude 4 Sonnet 为 64000，Claude 3.5 Haiku 为 8192。

messages

array [object {2}]

必需

我们的模型经过训练，能够处理交替的用户和助手对话轮次。创建新消息时，您需要通过messages参数指定先前的对话轮次，随后模型将生成对话中的下一条消息。请求中连续的相同角色（如多个连续的用户或助手）将被合并为单条消息。

每条输入消息必须是一个包含 role(角色) 和 content(内容) 的对象。您可以提交单一用户角色的消息，也可以包含多条用户与助手的交互信息。

若最后一条消息采用助手角色，响应内容将直接承接该条消息的内容继续生成——这可用于限定模型部分输出范围。

单条用户消息示例：

[{"role": "user", "content": "你好Claude"}]

多轮对话示例：

[
  {"role": "user", "content": "你好"},
  {"role": "assistant", "content": "我是Claude，有什么可以帮您？"},
  {"role": "user", "content": "能用通俗语言解释LLM吗？"}
]

包含Claude半完成回复的示例：

[
  {"role":"user","content":"太阳的希腊名是？(A)索尔 (B)赫利俄斯 (C)桑恩"},
  {"role":"assistant","content":"最佳答案是("}
]

每条输入信息的"内容"可以是单个字符串或由多个类型化区块组成的数组。使用字符串等同于仅含一个文本类型区块的数组形式。以下两条输入完全等效：

{"role":"user","content":"你好Claude"}
{"role":"user","content":[{"type":"text","text":"你好Claude"}]}

从Claude3系列开始支持图像内容区块：

{"role":"user","content":[
    {
        type: 'image',
        source: {
            type:'base64',
            media_type:'image/jpeg',
            data:'/9j/4AAQSkZJRg...'
        }
    },
    {type:"text", text:"这张图里有什么?"}
]}

当前支持的图片源格式为base64编码；媒体类型包括JPEG、PNG、GIF及WebP格式。

更多范例请参阅官方文档。

请注意：系统提示词需通过顶层system参数传递——Messages API的消息角色中不设"system"类型。

role

string

可选

生成消息的对话角色。

此值始终为 "assistant"。

可用选项：

assistant

content

string

可选

模型生成的内容。

这是一个内容块数组，每个块都有一个决定其形态的type属性。

示例：

[{"type": "text", "text": "你好，我是Claude。"}]

如果请求输入的messages以助手回合结束，那么响应中的content将直接延续该最后回合。您可以使用这一特性来约束模型的输出。

例如，如果输入消息为：

[
  {"role": "user", "content": "太阳的希腊名是什么？(A) Sol (B) Helios (C) Sun"},
  {"role": "assistant", "content": "最佳答案是("}
]

那么响应内容可能是：

[{"type": "text", "text": "B)"}]

stream

boolean

流模式输出

可选

示例

返回响应

🟢200成功

application/json

Body

content

array [object {2}]

必需

text

string

可选

type

string

可选

string

必需

model

string

必需

role

string

必需

stop_reason

string

必需

stop_sequence

null

必需

type

string

必需

usage

object

必需

input_tokens

integer

必需

output_tokens

integer

必需

🟠400请求有误

修改于 2025-06-17 17:08:16

模型价格

接入说明