跳转到主要内容
POST
/
v1
/
messages
curl -X POST https://api-llm.sunra.ai/v1/messages \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "Hello, how are you?"
      }
    ]
  }'

{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello! I'm doing well, thank you for asking. How can I help you today?"
    }
  ],
  "model": "anthropic/claude-sonnet-4-20250514",
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 12,
    "output_tokens": 19
  }
}
使用 Anthropic Messages API 格式创建消息。支持文本、图像、PDF、工具和扩展思维。

​
认证

​
Authorization
string
必填
Bearer 令牌。在 Authorization 请求头中使用您的 API 密钥作为 Bearer 令牌。格式：Bearer <SUNRA_KEY>

​
请求

此端点接受一个 JSON 对象。
​
model
string
必填
将完成您的提示的模型。在 sunra.ai/models 浏览可用模型。
​
messages
object[]
必填
输入消息。每条输入消息都有一个 role 和 content。
​
max_tokens
integer
必填
停止前生成的最大令牌数。请注意，模型可能会在达到此最大值之前停止。
​
system
string | object[]
系统提示。系统提示是一种为模型提供上下文和指令的方式。可以是字符串或内容块数组。
​
stream
boolean
默认值:false
是否使用服务器发送事件（SSE）增量流式传输响应。
​
temperature
number
默认值:1
注入到响应中的随机性量。范围从 0.0 到 1.0。对于分析/多选任务使用接近 0.0 的 temperature，对于创意和生成任务使用接近 1.0 的值。
​
top_p
number
使用核采样。在核采样中，我们按概率递减顺序计算所有后续令牌选项的累积分布，并在达到由 top_p 指定的特定概率时截断。
​
top_k
integer
仅从每个后续令牌的前 K 个选项中采样。用于移除”长尾”低概率响应。仅建议高级用例使用。
​
stop_sequences
string[]
自定义文本序列，将导致模型停止生成。返回的文本将不包含停止序列。
​
tools
object[]
模型可以使用的工具定义。
​
tool_choice
object
模型应如何使用提供的工具。
​
metadata
object
描述请求元数据的对象。
​
thinking
object
扩展思维的配置。启用后，模型将在响应之前进行思考。

​
响应

成功的消息响应。
​
id
string
唯一消息标识符，例如 msg_01XFDUDYJgAACzvnptvVoYEL。
​
type
string
对象类型。始终为 message。
​
role
string
生成消息的对话角色。始终为 assistant。
​
content
object[]
模型生成的内容。这是一个内容块数组。
​
model
string
处理请求的模型。
​
stop_reason
string | null
模型停止的原因。可以是 end_turn（模型到达自然停止点）、max_tokens（超过 max_tokens 或模型的最大值）、stop_sequence（生成了您的自定义停止序列之一）或 tool_use（模型调用了一个或多个工具）。
​
stop_sequence
string | null
生成了哪个自定义停止序列（如果有）。
​
usage
object
计费和速率限制使用情况。
curl -X POST https://api-llm.sunra.ai/v1/messages \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "Hello, how are you?"
      }
    ]
  }'

{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello! I'm doing well, thank you for asking. How can I help you today?"
    }
  ],
  "model": "anthropic/claude-sonnet-4-20250514",
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 12,
    "output_tokens": 19
  }
}