LLM 快速入門 - Sunra.ai

Sunra 提供三個 LLM API 端點，每個端點遵循不同的格式。三個端點使用相同的驗證方式和基礎 URL（https://api-llm.sunra.ai），您可以選擇最適合您技術棧的格式。在開始之前，請從您的控制面板取得 API 金鑰。

Chat Completions — `/v1/chat/completions`

Chat Completions 端點遵循 OpenAI Chat Completions 格式。它接受帶有角色（system、user、assistant）的訊息列表，並回傳補全結果。當您需要與 OpenAI SDK 和工具實現即插即用的相容性時，請使用此端點。 主要功能： 串流傳輸、函式呼叫、視覺（圖片、音訊、影片、檔案）、推理、結構化輸出（JSON schema / grammar）、logprobs。

curl -X POST https://api-llm.sunra.ai/v1/chat/completions \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "messages": [
      { "role": "system", "content": "You are a helpful assistant." },
      { "role": "user", "content": "What is the capital of France?" }
    ]
  }'

Anthropic Messages — `/v1/messages`

Anthropic Messages 端點遵循 Anthropic Messages API 格式。它使用 user / assistant 訊息角色，支援豐富的內容區塊和獨立的 system 參數。當您需要原生存取 Anthropic Claude 模型及延伸思考、提示快取、引用和內建工具（網頁搜尋、程式碼執行）等功能時，請使用此端點。 主要功能： 串流傳輸、延伸思考、提示快取、工具使用（自訂 + 內建）、PDF/文件輸入、引用、結構化輸出。

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?" }
    ]
  }'

Responses — `/v1/responses`

Responses 端點遵循 OpenAI Responses API 格式。它接受靈活的輸入項目（訊息、函式呼叫、推理），並回傳結構化的輸出項目。當您需要最新的 OpenAI Responses 功能（如內建網頁搜尋、檔案搜尋、程式碼解譯器、電腦使用、MCP 工具整合或圖片生成）時，請使用此端點。 主要功能： 串流傳輸、函式呼叫、網頁搜尋、檔案搜尋、程式碼解譯器、電腦使用、MCP 工具、圖片生成、推理、結構化輸出。

curl -X POST https://api-llm.sunra.ai/v1/responses \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "input": [
      { "type": "message", "role": "user", "content": "Hello, how are you?" }
    ]
  }'

選擇合適的端點

	Chat Completions	Anthropic Messages	Responses
格式	OpenAI Chat	Anthropic Messages	OpenAI Responses
最適合	OpenAI SDK 相容性	Claude 原生功能	最新 OpenAI 功能
串流傳輸	SSE	SSE	SSE
函式呼叫	是	是（自訂 + 內建）	是
推理	是	延伸思考	是
結構化輸出	JSON schema、grammar	JSON schema	JSON schema
內建工具	—	網頁搜尋、程式碼執行	網頁搜尋、檔案搜尋、程式碼解譯器、電腦使用、MCP

三個端點共享相同的驗證方式——只需在 Authorization 標頭中以 Bearer 權杖的形式傳遞您的 API 金鑰即可。