跳转到主要内容
POST
/
v1
/
messages
Create a Message
curl --request POST \
  --url https://api.evolink.ai/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "claude-sonnet-4-5-20250929",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Hello, world"
    }
  ]
}
'
{
  "model": "claude-haiku-4-5-20251001",
  "id": "msg_bdrk_017XLrAa77zWvfBGQ6ESvrxz",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "# Hey there! 👋\n\nHow's it going? What can I help you with today?"
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 8,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0,
    "output_tokens": 24
  }
}

授权

Authorization
string
header
必填

##所有 API 都需要 Bearer Token 身份验证##

获取 API 密钥:

访问 API 密钥管理页面 获取你的 API 密钥

添加到请求头:

Authorization: Bearer YOUR_API_KEY

请求体

application/json
model
enum<string>
必填

将完成你的提示的模型。

可用选项:
claude-haiku-4-5-20251001,
claude-sonnet-4-5-20250929,
claude-opus-4-1-20250805,
claude-sonnet-4-20250514,
claude-opus-4-5-20251101
示例:

"claude-sonnet-4-5-20250929"

messages
InputMessage · object[]
必填

输入消息。

可以处理交替的 userassistant 对话回合。创建新的 Message 时,需要通过 messages 参数指定之前的对话回合,然后模型会生成对话中的下一条 Message。请求中连续的 userassistant 回合将被合并为一个回合。

每条输入消息必须是一个包含 rolecontent 的对象。可以指定单个 user 角色消息,也可以包含多个 userassistant 消息。

max_tokens
integer
必填

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

请注意,我们的模型可能会在达到此最大值之前停止。此参数仅指定要生成的绝对最大令牌数。

必填范围: x >= 1
示例:

1024

container

包含要加载技能的容器参数。

context_management
ContextManagementConfig · object

上下文管理配置。

mcp_servers
RequestMCPServerURLDefinition · object[]

此请求中要使用的 MCP 服务器

Maximum array length: 20
metadata
Metadata · object

描述请求元数据的对象。

service_tier
enum<string>

确定此请求是使用优先容量(如果可用)还是标准容量。

可用选项:
auto,
standard_only
stop_sequences
string[]

会导致模型停止生成的自定义文本序列。

stream
boolean

是否使用服务器发送事件增量流式传输响应。

system

系统提示。

示例:

"Today's date is 2024-06-01."

temperature
number

注入响应中的随机性程度。

默认为 1.0。范围从 0.01.0

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

1

thinking
Enabled · object

启用 Claude 扩展思考的配置。

tool_choice
Auto · object

模型应如何使用提供的工具。

tools
(Custom tool · object | Bash tool (2024-10-22) · object | Bash tool (2025-01-24) · object | Code execution tool (2025-05-22) · object | CodeExecutionTool_20250825 · object | Computer use tool (2024-01-22) · object | MemoryTool_20250818 · object | Computer use tool (2025-01-24) · object | Text editor tool (2024-10-22) · object | Text editor tool (2025-01-24) · object | Text editor tool (2025-04-29) · object | TextEditor_20250728 · object | Web search tool (2025-03-05) · object | WebFetchTool_20250910 · object)[]

模型可能使用的工具定义。

top_k
integer

对于每个后续令牌,仅从前 K 个选项中采样。

必填范围: x >= 0
示例:

5

top_p
number

使用核采样。

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

0.7

响应

消息对象

id
string
必填

唯一对象标识符。

ID 的格式和长度可能随时间变化。

示例:

"msg_013Zva2CMHLNnXjNJJKqJ2EF"

type
string
必填

对象类型。

对于 Messages,这始终是 "message"

Allowed value: "message"
role
string
必填

生成消息的对话角色。

这始终是 "assistant"

Allowed value: "assistant"
content
(Text · object | Thinking · object | Redacted thinking · object | Tool use · object | Server tool use · object | Web search tool result · object | ResponseWebFetchToolResultBlock · object | Code execution tool result · object | ResponseBashCodeExecutionToolResultBlock · object | ResponseTextEditorCodeExecutionToolResultBlock · object | MCP tool use · object | MCP tool result · object | Container upload · object)[]
必填

模型生成的内容。

这是一个内容块数组,每个块都有一个决定其结构的 type

model
enum<string>
必填

处理请求的模型。

可用选项:
claude-haiku-4-5-20251001,
claude-sonnet-4-5-20250929,
claude-opus-4-1-20250805,
claude-sonnet-4-20250514
示例:

"claude-sonnet-4-5-20250929"

stop_reason
enum<string> | null
必填

我们停止的原因。

可用选项:
end_turn,
max_tokens,
stop_sequence,
tool_use,
pause_turn,
refusal,
model_context_window_exceeded
stop_sequence
string | null
必填

生成的自定义停止序列(如果有)。

usage
Usage · object
必填

计费和速率限制使用情况。

context_management
ResponseContextManagement · object

上下文管理响应。

container
Container · object

此请求中使用的容器信息。