Skip to main content
POST
Create a Message
BaseURL 说明:默认 BaseURL 为 https://direct.evolink.ai,对文本模型支持更好,支持长连接;https://api.evolink.ai 是多模态主力地址,对文本模型作为备用地址使用。

授权

Authorization
string
header
必填

##所有接口均需要使用Bearer Token进行认证##

获取 API Key:

访问 API Key 管理页面 获取您的 API Key

使用时在请求头中添加:

请求体

application/json
model
enum<string>
必填

用于生成响应的模型。请选择下方列出的受支持模型 ID。

可用选项:
claude-haiku-4-5-20251001,
claude-sonnet-4-5-20250929,
claude-opus-4-5-20251101,
claude-opus-4-6,
claude-fable-5,
claude-opus-5,
claude-opus-4-8,
claude-opus-4-7,
claude-sonnet-4-6,
claude-sonnet-5
示例:

"claude-opus-5"

max_tokens
integer
必填

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

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

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

1024

messages
InputMessage · object[]
必填

输入消息。

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

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

Required array length: 1 - 100000 elements
container

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

output_config
OutputConfig · object

模型输出的配置,例如输出格式。

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 扩展思考的配置。

type: "enabled" 需要 budget_tokens,最小为 1,024,并计入 max_tokens 上限。

type: "adaptive" 让 Claude 根据请求复杂度决定何时以及使用多少扩展思考。

type: "disabled" 关闭扩展思考。

tool_choice
Auto · object

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

tools
Custom tool · object[]

模型可使用的客户端工具定义。每个工具包含 name、可选的 descriptioninput_schema

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-5-20251101,
claude-opus-4-6,
claude-fable-5,
claude-opus-5,
claude-opus-4-8,
claude-opus-4-7,
claude-sonnet-4-6,
claude-sonnet-5
示例:

"claude-opus-5"

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 | null

上下文管理响应。

container
Container · object | null

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