跳转到主要内容
POST
/
v1
/
messages
创建消息
curl --request POST \
  --url https://www.anyfast.ai/v1/messages \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "claude-sonnet-5",
  "messages": [
    {
      "role": "user",
      "content": "你好,Claude!"
    }
  ],
  "max_tokens": 1024,
  "system": "<string>",
  "metadata": {
    "user_id": "<string>"
  },
  "stop_sequences": [
    "<string>"
  ],
  "temperature": 1,
  "top_p": 0.5,
  "top_k": 1,
  "stream": false,
  "tools": [
    {
      "name": "<string>",
      "input_schema": {},
      "description": "<string>"
    }
  ],
  "tool_choice": {
    "name": "<string>"
  },
  "output_config": {
    "effort": "high"
  },
  "thinking": {}
}
'
{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "你好!我能帮你做什么?"
    }
  ],
  "model": "claude-sonnet-5",
  "usage": {
    "input_tokens": 123,
    "output_tokens": 123,
    "cache_creation_input_tokens": 123,
    "cache_read_input_tokens": 123
  },
  "stop_sequence": "<string>"
}

请求体

application/json
model
enum<string>
必填

模型 ID。

可用选项:
claude-sonnet-5
示例:

"claude-sonnet-5"

messages
object[]
必填

输入消息列表。每条消息包含角色和内容。

Minimum array length: 1
示例:
[{ "role": "user", "content": "你好,Claude!" }]
max_tokens
integer
必填

生成前允许的最大 token 数。Claude Sonnet 5 最多支持 128K 输出 Token。

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

1024

system

系统提示词,用于提供上下文和指令。

metadata
object

请求的元数据对象。

stop_sequences
string[]

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

temperature
number
默认值:1

注入到响应中的随机性程度。在 Claude Sonnet 5 上,非默认值会返回 400 错误。

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

1

top_p
number

核采样。在 Claude Sonnet 5 上,非默认值会返回 400 错误。

必填范围: 0 <= x <= 1
top_k
integer

每个后续 token 仅从前 K 个选项中采样。在 Claude Sonnet 5 上,非默认值会返回 400 错误。

必填范围: x >= 0
stream
boolean
默认值:false

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

tools
object[]

模型可使用的工具定义。

tool_choice
object

模型如何使用工具。

output_config
object

支持自适应思维 effort 的模型输出控制配置。

thinking
object

自适应思维配置。Claude Sonnet 5 默认启用自适应思维;请用 output_config.effort 控制深度。不支持手动扩展思维。

响应

消息创建成功

id
string
必填
示例:

"msg_01XFDUDYJgAACzvnptvVoYEL"

type
string
必填
示例:

"message"

role
string
必填
示例:

"assistant"

content
object[]
必填
示例:
[{ "type": "text", "text": "你好!我能帮你做什么?" }]
model
string
必填
示例:

"claude-sonnet-5"

stop_reason
enum<string>
必填

被模型拒绝的请求会返回 refusal

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