> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sunra.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# LLM 快速入門

Sunra 提供三個 LLM API 端點，每個端點遵循不同的格式。三個端點使用相同的驗證方式和基礎 URL（`https://api-llm.sunra.ai`），您可以選擇最適合您技術棧的格式。

在開始之前，請從您的[控制面板](https://sunra.ai/dashboard/api-tokens)取得 API 金鑰。

## Chat Completions — `/v1/chat/completions`

[Chat Completions](/zh-Hant/llm/chat) 端點遵循 **OpenAI Chat Completions** 格式。它接受帶有角色（`system`、`user`、`assistant`）的訊息列表，並回傳補全結果。

當您需要與 OpenAI SDK 和工具實現即插即用的相容性時，請使用此端點。

**主要功能：** 串流傳輸、函式呼叫、視覺（圖片、音訊、影片、檔案）、推理、結構化輸出（JSON schema / grammar）、logprobs。

```bash theme={null}
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](/zh-Hant/llm/messages) 端點遵循 **Anthropic Messages API** 格式。它使用 `user` / `assistant` 訊息角色，支援豐富的內容區塊和獨立的 `system` 參數。

當您需要原生存取 Anthropic Claude 模型及延伸思考、提示快取、引用和內建工具（網頁搜尋、程式碼執行）等功能時，請使用此端點。

**主要功能：** 串流傳輸、延伸思考、提示快取、工具使用（自訂 + 內建）、PDF/文件輸入、引用、結構化輸出。

```bash theme={null}
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](/zh-Hant/llm/responses) 端點遵循 **OpenAI Responses API** 格式。它接受靈活的輸入項目（訊息、函式呼叫、推理），並回傳結構化的輸出項目。

當您需要最新的 OpenAI Responses 功能（如內建網頁搜尋、檔案搜尋、程式碼解譯器、電腦使用、MCP 工具整合或圖片生成）時，請使用此端點。

**主要功能：** 串流傳輸、函式呼叫、網頁搜尋、檔案搜尋、程式碼解譯器、電腦使用、MCP 工具、圖片生成、推理、結構化輸出。

```bash theme={null}
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 金鑰即可。