Messages（Anthropic）¶

使用 Anthropic Messages 请求形态调用 Genesis 模型，并返回内容块形式的生成结果。

POST https://token.moi.matrixorigin.cn/v1/messages

调用前准备¶

准备具有 Genesis 权限的访问凭据和支持 Messages 形态的模型 ID。

请求体¶

将 $GENESIS_ACCESS_TOKEN 替换为访问令牌或服务账号 API Key，将 $MODEL_ID 替换为要调用的模型 ID。

请求示例

curl -X POST \
  "https://token.moi.matrixorigin.cn/v1/messages" \
  -H "Authorization: Bearer $GENESIS_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "'"$MODEL_ID"'",
    "max_tokens": 256,
    "messages": [
      {
        "role": "user",
        "content": "用一句话解释数据血缘。"
      }
    ],
    "stream": false
  }'

参数说明

参数

字段	类型	必填	说明
`model`	string	是	要调用的 Messages 模型 ID。
`max_tokens`	integer	是	本次请求允许的最大输出 Token 数。
`messages`	array of object	是	按对话顺序传入的消息列表。
`stream`	boolean	否	设为 `true` 时返回 Anthropic Messages SSE 事件。

消息项

下面表格展开示例中 messages 数组的每一项；每一行是该数组项的一个字段。

字段	类型	必填	说明
`role`	string	是	消息角色。
`content`	string	是	消息的文本内容。

成功响应¶

服务返回内容块形式的生成结果。

响应示例

{
  "id": "<MESSAGE_ID>",
  "type": "message",
  "role": "assistant",
  "model": "<MODEL_ID>",
  "content": [
    {
      "type": "text",
      "text": "数据血缘描述数据从来源、处理到消费环节的关系。"
    }
  ],
  "stop_reason": "end_turn"
}

字段说明

通用字段

字段	类型	说明
`id`	string	本次 Messages 请求的标识。
`type`	string	响应对象类型，示例为 `message`。
`role`	string	响应消息的角色，示例为 `assistant`。
`model`	string	实际处理请求的模型 ID。
`content`	array of object	内容块列表。
`stop_reason`	string 或 null	当前生成结束原因。

内容项

下面表格展开示例中 content 数组的每一项；每一行是该数组项的一个字段。

字段	类型	说明
`type`	string	内容块类型。
`text`	string	内容块类型为 `text` 时的生成文本。
`thinking`	string	内容块类型为 `thinking` 时的推理内容。

错误响应¶

响应示例

{
  "error": {
    "message": "<可读错误信息>",
    "type": "<错误类型，可能省略>",
    "code": "<错误代码，可能省略>"
  }
}

字段说明

通用字段

字段	类型	说明
`error`	object	错误对象。

错误对象

下面表格展开示例中 error 对象；每一行是该对象的一个字段。

字段	类型	说明
`message`	string	可读错误信息。
`type`	string	模型服务返回的错误类别，可能省略。
`code`	string 或 null	模型服务返回的错误代码，可能省略。

最后更新于 2026 年 9 月 1 日