Messages

POST

/v1/messages

根据输入的对话消息生成下一条 assistant 消息，兼容 Anthropic Messages API。

model、max_tokens 和 messages 按 Anthropic 官方协议为必填参数。消息内容既可以是
字符串，也可以是由文本、图片、文档、工具调用和工具结果组成的内容块数组。系统提示词
必须使用顶层 system 参数，不能在 messages 中使用 system 角色。

设置 stream: true 后，服务端通过 SSE 返回具名事件。标准事件顺序为
message_start、一组内容块事件、message_delta 和 message_stop，期间可能出现
ping 或 error 事件。

927AI 会将 anthropic-beta 请求头和 Messages 请求体中的兼容字段转发给上游。部分高级
字段是否生效取决于模型能力、上游渠道和渠道设置，请以 927AI 模型与价格页面为准。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json必填

{
    "model": "claude-fable-5",
    "max_tokens": 1024,
    "messages": [
        {
            "role": "user",
            "content": "你好，请用一句话介绍你自己。"
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://vip.927ai.ai/v1/messages' \
--header 'anthropic-version;' \
--header 'anthropic-beta;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "claude-fable-5",
    "max_tokens": 1024,
    "messages": [
        {
            "role": "user",
            "content": "你好，请用一句话介绍你自己。"
        }
    ]
}'

返回响应

🟢200

application/json

请求成功。非流式请求返回 Message 对象，流式请求返回 SSE 事件。

Body

示例

文本响应工具调用响应

{
    "id": "msg_927ai_example",
    "type": "message",
    "role": "assistant",
    "model": "claude-fable-5",
    "content": [
        {
            "type": "text",
            "text": "我是一个通过 927AI API 提供服务的 Claude 助手。"
        }
    ],
    "stop_reason": "end_turn",
    "stop_sequence": null,
    "usage": {
        "input_tokens": 18,
        "cache_creation_input_tokens": 0,
        "cache_read_input_tokens": 0,
        "output_tokens": 22
    }
}

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🟠404NotFound

🟠413PayloadTooLarge

🟠429RateLimited

🔴500InternalError

🔴504Timeout

🔴529Overloaded

图片编辑