跳转到主要内容
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
  }
}

Authorizations

Authorization
string
header
required

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

获取 API 密钥:

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

添加到请求头:

Authorization: Bearer YOUR_API_KEY

Body

application/json
model
enum<string>
required

将完成你的提示的模型。

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

"claude-sonnet-4-5-20250929"

messages
InputMessage · object[]
required

输入消息。

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

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

max_tokens
integer
required

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

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

Required range: x >= 1
Examples:

1024

container

跨请求重用的容器标识符。 包含要加载技能的容器参数。

context_management
object | null

上下文管理配置。

mcp_servers
RequestMCPServerURLDefinition · object[]

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

Maximum length: 20
metadata
object

描述请求元数据的对象。

service_tier
enum<string>

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

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

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

stream
boolean

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

system

系统提示。

Examples:

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

temperature
number

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

默认为 1.0。范围从 0.01.0

Required range: 0 <= x <= 1
Examples:

1

thinking
object

启用 Claude 扩展思考的配置。

  • Enabled
  • Disabled
tool_choice
object

模型应如何使用提供的工具。 模型将自动决定是否使用工具。

  • Auto
  • Any
  • Tool
  • None
tools
Tools · array

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

  • Custom tool
  • Bash tool (2024-10-22)
  • Bash tool (2025-01-24)
  • Code execution tool (2025-05-22)
  • CodeExecutionTool_20250825
  • Computer use tool (2024-01-22)
  • MemoryTool_20250818
  • Computer use tool (2025-01-24)
  • Text editor tool (2024-10-22)
  • Text editor tool (2025-01-24)
  • Text editor tool (2025-04-29)
  • TextEditor_20250728
  • Web search tool (2025-03-05)
  • WebFetchTool_20250910
top_k
integer

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

Required range: x >= 0
Examples:

5

top_p
number

使用核采样。

Required range: 0 <= x <= 1
Examples:

0.7

Response

消息对象

id
string
required

唯一对象标识符。

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

Examples:

"msg_013Zva2CMHLNnXjNJJKqJ2EF"

type
string
required

对象类型。

对于 Messages,这始终是 "message"

Allowed value: "message"
role
string
required

生成消息的对话角色。

这始终是 "assistant"

Allowed value: "assistant"
content
Content · array
required

模型生成的内容。

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

  • Text
  • Thinking
  • Redacted thinking
  • Tool use
  • Server tool use
  • Web search tool result
  • ResponseWebFetchToolResultBlock
  • Code execution tool result
  • ResponseBashCodeExecutionToolResultBlock
  • ResponseTextEditorCodeExecutionToolResultBlock
  • MCP tool use
  • MCP tool result
  • Container upload
model
enum<string>
required

处理请求的模型。

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

"claude-sonnet-4-5-20250929"

stop_reason
enum<string> | null
required

我们停止的原因。

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

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

usage
object
required

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

context_management
object | null

上下文管理响应。

container
object | null

此请求中使用的容器信息。 请求中使用的容器信息(用于代码执行工具)