> ## 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.

# Panduan Cepat LLM

Sunra menyediakan tiga endpoint API LLM, masing-masing mengikuti format yang berbeda. Ketiganya menggunakan autentikasi dan base URL yang sama (`https://api-llm.sunra.ai`), sehingga Anda dapat memilih format mana pun yang sesuai dengan stack Anda.

Sebelum memulai, dapatkan API key dari [dashboard](https://sunra.ai/dashboard/api-tokens) Anda.

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

Endpoint [Chat Completions](/id/llm/chat) mengikuti format **OpenAI Chat Completions**. Endpoint ini menerima daftar pesan dengan peran (`system`, `user`, `assistant`) dan mengembalikan sebuah completion.

Gunakan endpoint ini ketika Anda menginginkan kompatibilitas langsung dengan SDK dan tooling OpenAI.

**Fitur utama:** streaming, function calling, vision (gambar, audio, video, file), reasoning, structured outputs (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`

Endpoint [Anthropic Messages](/id/llm/messages) mengikuti format **Anthropic Messages API**. Endpoint ini menggunakan peran pesan `user` / `assistant` dengan blok konten yang kaya dan parameter `system` terpisah.

Gunakan endpoint ini ketika Anda menginginkan akses native ke model Anthropic Claude dan fitur-fitur seperti extended thinking, prompt caching, citations, dan built-in tools (web search, code execution).

**Fitur utama:** streaming, extended thinking, prompt caching, tool use (custom + built-in), input PDF/dokumen, citations, structured outputs.

```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`

Endpoint [Responses](/id/llm/responses) mengikuti format **OpenAI Responses API**. Endpoint ini menerima input items yang fleksibel (pesan, function calls, reasoning) dan mengembalikan structured output items.

Gunakan endpoint ini ketika Anda membutuhkan fitur-fitur terbaru OpenAI Responses seperti built-in web search, file search, code interpreter, computer use, integrasi MCP tools, atau image generation.

**Fitur utama:** streaming, function calling, web search, file search, code interpreter, computer use, MCP tools, image generation, reasoning, structured outputs.

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

## Memilih endpoint yang tepat

|                       | Chat Completions          | Anthropic Messages         | Responses                                                    |
| --------------------- | ------------------------- | -------------------------- | ------------------------------------------------------------ |
| **Format**            | OpenAI Chat               | Anthropic Messages         | OpenAI Responses                                             |
| **Terbaik untuk**     | Kompatibilitas SDK OpenAI | Fitur native Claude        | Fitur terbaru OpenAI                                         |
| **Streaming**         | SSE                       | SSE                        | SSE                                                          |
| **Function calling**  | Ya                        | Ya (custom + built-in)     | Ya                                                           |
| **Reasoning**         | Ya                        | Extended thinking          | Ya                                                           |
| **Structured output** | JSON schema, grammar      | JSON schema                | JSON schema                                                  |
| **Built-in tools**    | —                         | Web search, code execution | Web search, file search, code interpreter, computer use, MCP |

Ketiga endpoint menggunakan autentikasi yang sama — cukup kirimkan API key Anda sebagai Bearer token di header `Authorization`.