跳轉到主要內容
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 令牌。Format: 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
  }
}