创建对话请求(Anthropic)

Authorization

AuthorizationBearer <token>required

添加 Header 'Authorization: Bearer {账户 API Key}' 进行鉴权

In: header

Header Parameters

X-Trace-Idstring

请求追踪 ID。可自定义传入用于标记本次请求；若不传入，平台将自动生成。排查问题时，提供该值或响应头中的 x-siliconcloud-trace-id 均可。

traceparentstring

W3C Trace Context 标准追踪头。传入时，平台取其中的 trace-id 作为本次请求的追踪标识。

Request Body

modelstringrequired

对应的模型名称。为更好地提升服务质量，我们会对本服务提供的模型进行定期变更，包括但不限于模型上下线和模型服务能力的调整。在可行的情况下，我们会通过公告或消息推送等适当方式通知您此类变更。完整可用模型列表请查看对话模型。

Example"deepseek-ai/DeepSeek-V4-Flash"

messagesarray<object>required

对话消息列表

systemstring | array<Text>

系统提示词。系统提示词是一种为 LLM 提供上下文和指令的方式，例如指定特定的目标或角色。

stop_sequencesStop Sequences

将导致模型停止生成的自定义文本序列。我们的模型通常会在自然完成其回合时停止，这将导致响应的 stop_reason 为 "end_turn"。如果你希望模型在遇到自定义文本字符串时停止生成，可以使用 stop_sequences 参数。如果模型遇到其中一个自定义序列，响应的 stop_reason 值将为 "stop_sequence"，且响应的 stop_sequence 值将包含匹配的停止序列。

streamboolean

如果设置，token 将以 SSE（Server-Sent Events）的形式流式输出。流式传输通常以 data: [DONE] 结束

Value infalse | true

Exampletrue

max_tokensintegerrequired

要生成的最大 token 数量，不包含思维链部分。建议不要将 max_tokens 设置为窗口上限，为输入和系统开销预留约 10k token 的缓冲区。

temperaturenumber

使用的采样温度，取值范围在 0 到 2 之间。较高的值（如 0.8）会使输出更加随机，而较低的值（如 0.2）会使其更加集中和确定。

Formatfloat

Rangevalue <= 2

Example0.7

top_pnumber

一种替代温度采样的方法，称为核采样（nucleus sampling），模型会考虑具有 top_p 概率质量的 token 的结果。因此 0.1 表示仅考虑构成前 10% 概率质量的 token。我们通常建议调整此参数或温度，但不要同时调整两者。

Formatfloat

Rangevalue <= 1

Example0.7

top_knumber

Formatfloat

Rangevalue <= 100

Example50

toolsarray<object>

每个工具定义包括：

name：工具名称。
description：工具的描述，可选但强烈建议提供。
input_schema：模型在 tool_use 输出内容块中将生成的工具 input 形状的 JSON schema。

tool_choiceAuto | Tool | None

模型应如何使用提供的工具。模型可以使用特定工具、任何可用工具、自行决定，或完全不使用工具。

模型将自动决定是否使用工具。

disable_parallel_tool_useDisable Parallel Tool Use

是否禁用并行工具使用。默认值为 false。如果设置为 true，模型将最多输出一个工具使用。

typeTyperequired

Value in"auto"

模型将使用通过 tool_choice.name 指定的工具。

disable_parallel_tool_useDisable Parallel Tool Use

是否禁用并行工具使用。默认值为 false。如果设置为 true，模型将恰好输出一个工具使用。

nameNamerequired

要使用的工具名称。

typeTyperequired

Value in"tool"

模型将不被允许使用工具。

typeTyperequired

Value in"none"

thinkingThinkingDisabled | ThinkingEnabled

思维链控制参数。用于开启或关闭模型的思维链（thinking）功能。

关闭思维链。

typestringrequired

关闭思维链。

Value in"disabled"

开启思维链，并通过 budget_tokens 控制思维链长度。

typestringrequired

开启思维链。

Value in"enabled"

budget_tokensintegerrequired

思维链的 token 预算，控制思维链的长度。

Example1024

modelstringrequired

对应的模型名称。为更好地提升服务质量，我们会对本服务提供的模型进行定期变更，包括但不限于模型上下线和模型服务能力的调整。在可行的情况下，我们会通过公告或消息推送等适当方式通知您此类变更。完整可用视觉输入模型列表请查看模型广场。

Example"moonshotai/Kimi-K2.7-Code"

messagesarray<object>required

对话消息列表

systemstring | array<Text>

系统提示词。系统提示词是一种为 LLM 提供上下文和指令的方式，例如指定特定的目标或角色。

stop_sequencesStop Sequences

streamboolean

如果设置，token 将以 SSE（Server-Sent Events）的形式流式输出。流式传输通常以 data: [DONE] 结束

Value infalse | true

Exampletrue

max_tokensintegerrequired

要生成的最大 token 数量，不包含思维链部分。建议不要将 max_tokens 设置为窗口上限，为输入和系统开销预留约 10k token 的缓冲区。

temperaturenumber

使用的采样温度，取值范围在 0 到 2 之间。较高的值（如 0.8）会使输出更加随机，而较低的值（如 0.2）会使其更加集中和确定。

Formatfloat

Rangevalue <= 2

Example0.7

top_pnumber

Formatfloat

Rangevalue <= 1

Example0.7

top_knumber

Formatfloat

Rangevalue <= 100

Example50

toolsarray<object>

每个工具定义包括：

name：工具名称。
description：工具的描述，可选但强烈建议提供。
input_schema：模型在 tool_use 输出内容块中将生成的工具 input 形状的 JSON schema。

tool_choiceAuto | Tool | None

模型应如何使用提供的工具。模型可以使用特定工具、任何可用工具、自行决定，或完全不使用工具。

模型将自动决定是否使用工具。

disable_parallel_tool_useDisable Parallel Tool Use

是否禁用并行工具使用。默认值为 false。如果设置为 true，模型将最多输出一个工具使用。

typeTyperequired

Value in"auto"

模型将使用通过 tool_choice.name 指定的工具。

disable_parallel_tool_useDisable Parallel Tool Use

是否禁用并行工具使用。默认值为 false。如果设置为 true，模型将恰好输出一个工具使用。

nameNamerequired

要使用的工具名称。

typeTyperequired

Value in"tool"

模型将不被允许使用工具。

typeTyperequired

Value in"none"

thinkingThinkingDisabled | ThinkingEnabled

思维链控制参数。用于开启或关闭模型的思维链（thinking）功能。

关闭思维链。

typestringrequired

关闭思维链。

Value in"disabled"

开启思维链，并通过 budget_tokens 控制思维链长度。

typestringrequired

开启思维链。

Value in"enabled"

budget_tokensintegerrequired

思维钾的 token 预算，控制思维链的长度。

Example1024

Response Body

模型响应。响应头中包含 x-siliconcloud-trace-id 字段，作为请求的唯一追踪标识，便于日志查询和问题排查；用户自定义传入的 X-Trace-Id 请求头（如有）也会以该字段原样返回。排查问题时，提供任一 trace ID 即可。

TypeScript Definitions

Use the response body type in TypeScript.

idstring

typeType

对象类型。

对于 Messages，此值始终为 "message"。

Default"message"

Value in"message"

roleRole

生成消息的对话角色。

此值始终为 "assistant"。

Default"assistant"

Value in"assistant"

contentContent

模型生成的内容。这是一个内容块数组，每个内容块都有一个决定其结构的 type。示例：

[{"type": "text", "text": "Hi"}]

如果请求输入的 messages 以 assistant 角色结尾，那么响应的 content 将直接延续该最后一条消息。您可以利用这一点来约束模型的输出。例如，如果输入的 messages 为：

[
  {"role": "user", "content": "What's the Greek name for Sun? (A) Sol (B) Helios (C) Sun"},
  {"role": "assistant", "content": "The best answer is ("}
]

那么响应的 content 可能为：

[{"type": "text", "text": "B)"}]

modelModel

处理请求的模型。

stop_reasonStop Reason

我们停止生成的原因。此值可能是以下之一：

"end_turn": 模型到达了一个自然的停止点，或者您提供的自定义 stop_sequences was generated
"max_tokens": 我们超出了请求的 max_tokens or the model's maximum
"tool_use": 模型调用了一个或多个工具
"refusal": 流式分类器介入处理潜在的政策违规在非流式模式下，此值始终为非 null。在流式模式下，它在 message_start 事件中为 null，其他情况下为非 null。

stop_sequenceStop Sequence

如果存在，则生成的是哪个自定义停止序列。如果您的一个自定义停止序列被生成，此值将为非 null 字符串。被生成。

usageUsage

curl --request POST \
  --url https://api.siliconflow.cn/v1/messages \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Flash",
    "messages": [
      {"role": "user", "content": "你好，请介绍一下你自己"}
    ],
    "max_tokens": 4096
  }'

import requests

url = "https://api.siliconflow.cn/v1/messages"
payload = {
    "model": "deepseek-ai/DeepSeek-V4-Flash",
    "messages": [
        {"role": "user", "content": "你好，请介绍一下你自己"}
    ],
    "max_tokens": 4096
}
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

curl --request POST \
  --url https://api.siliconflow.cn/v1/messages \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ***" \
  -d '{
    "model": "moonshotai/Kimi-K2.7-Code",
    "messages": [
      {
        "role": "user",
        "content": [
          {"type": "text", "text": "描述这张图片"},
          {"type": "image", "source": {"type": "url", "url": "https://example.com/image.jpg"}}
        ]
      }
    ],
    "max_tokens": 4096
  }'

import requests

url = "https://api.siliconflow.cn/v1/messages"
payload = {
    "model": "deepseek-ai/DeepSeek-V4-Flash",
    "messages": [
        {"role": "user", "content": "波士顿今天天气怎么样？"},
        {"role": "assistant", "content": "波士顿今天晴，气温 20°C。"},
        {"role": "user", "content": "那纽约呢？"}
    ],
    "max_tokens": 4096,
    "stream": True,
    "tools": [
        {
            "name": "get_current_weather",
            "description": "Get the current weather in a given location",
            "input_schema": {
                "type": "object",
                "properties": {
                    "location": {
                        "type": "string",
                        "description": "The city and state, e.g. San Francisco, CA"
                    },
                    "unit": {"type": "string", "enum": ["celsius", "fahrenheit"]}
                },
                "required": ["location"]
            }
        }
    ],
    "tool_choice": {"type": "auto"}
}
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers, stream=True)
for line in response.iter_lines():
    if line:

{
  "content": [
    {
      "type": "thinking",
      "thinking": "...",
      "signature": "tvshsltrjs"
    },
    {
      "text": "Hello! I'm GLM, trained by Z.ai. How can I assist you today? Whether you have questions or just want to chat, I'm happy to help.",
      "type": "text"
    }
  ],
  "id": "msg_T15jjp718fACotrwiLp3KwVu",
  "model": "deepseek-ai/DeepSeek-V4-Flash",
  "role": "assistant",
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "type": "message",
  "usage": {
    "input_tokens": 6,
    "output_tokens": 215
  }
}

{
  "code": 20012,
  "message": "string",
  "data": "string"
}

"Invalid token"

"Forbidden"

"404 page not found"

{
  "message": "Request was rejected due to rate limiting. If you want more, please contact contact@siliconflow.cn. Details:TPM limit reached.",
  "data": "string"
}

{
  "code": 50505,
  "message": "Model service overloaded. Please try again later.",
  "data": "string"
}

"string"

创建对话请求(Anthropic)

Authorization

Header Parameters

Request Body

Response Body

200

400

401

403

404

429

503

504

Default

Streaming

Function