> ## 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 endpoints प्रदान करता है, जिनमें से प्रत्येक एक अलग फॉर्मेट का पालन करता है। तीनों एक ही authentication और बेस URL (`https://api-llm.sunra.ai`) का उपयोग करते हैं, इसलिए आप अपने stack के अनुसार कोई भी फॉर्मेट चुन सकते हैं।

शुरू करने से पहले, अपने [डैशबोर्ड](https://sunra.ai/dashboard/api-tokens) से एक API key प्राप्त करें।

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

[Chat Completions](/hi/llm/chat) endpoint **OpenAI Chat Completions** फॉर्मेट का पालन करता है। यह roles (`system`, `user`, `assistant`) के साथ संदेशों की एक सूची स्वीकार करता है और एक completion लौटाता है।

इस endpoint का उपयोग तब करें जब आप OpenAI SDKs और टूलिंग के साथ सीधी संगतता चाहते हों।

**मुख्य विशेषताएं:** streaming, फ़ंक्शन कॉलिंग, विज़न (इमेज, ऑडियो, वीडियो, फ़ाइलें), रीज़निंग, स्ट्रक्चर्ड आउटपुट (JSON schema / ग्रामर), 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](/hi/llm/messages) endpoint **Anthropic Messages API** फॉर्मेट का पालन करता है। यह रिच कंटेंट ब्लॉक के साथ `user` / `assistant` मैसेज roles और एक अलग `system` पैरामीटर का उपयोग करता है।

इस endpoint का उपयोग तब करें जब आप Anthropic Claude मॉडल और एक्सटेंडेड थिंकिंग, प्रॉम्प्ट कैशिंग, साइटेशन, और बिल्ट-इन टूल्स (वेब सर्च, कोड एक्सीक्यूशन) जैसी सुविधाओं तक नेटिव पहुँच चाहते हों।

**मुख्य विशेषताएं:** streaming, एक्सटेंडेड थिंकिंग, प्रॉम्प्ट कैशिंग, टूल का उपयोग (कस्टम + बिल्ट-इन), 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](/hi/llm/responses) endpoint **OpenAI Responses API** फॉर्मेट का पालन करता है। यह लचीले इनपुट आइटम (संदेश, फ़ंक्शन कॉल, रीज़निंग) स्वीकार करता है और स्ट्रक्चर्ड आउटपुट आइटम लौटाता है।

इस endpoint का उपयोग तब करें जब आपको OpenAI Responses की नवीनतम सुविधाएं चाहिए जैसे बिल्ट-इन वेब सर्च, फ़ाइल सर्च, कोड इंटरप्रेटर, कंप्यूटर यूज़, MCP टूल इंटीग्रेशन, या इमेज जनरेशन।

**मुख्य विशेषताएं:** streaming, फ़ंक्शन कॉलिंग, वेब सर्च, फ़ाइल सर्च, कोड इंटरप्रेटर, कंप्यूटर यूज़, 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?" }
    ]
  }'
```

## सही endpoint कैसे चुनें

|                        | Chat Completions    | Anthropic Messages        | Responses                                                |
| ---------------------- | ------------------- | ------------------------- | -------------------------------------------------------- |
| **फॉर्मेट**            | OpenAI Chat         | Anthropic Messages        | OpenAI Responses                                         |
| **सबसे उपयुक्त**       | OpenAI SDK संगतता   | Claude-नेटिव सुविधाएं     | OpenAI की नवीनतम सुविधाएं                                |
| **Streaming**          | SSE                 | SSE                       | SSE                                                      |
| **फ़ंक्शन कॉलिंग**     | हाँ                 | हाँ (कस्टम + बिल्ट-इन)    | हाँ                                                      |
| **रीज़निंग**           | हाँ                 | एक्सटेंडेड थिंकिंग        | हाँ                                                      |
| **स्ट्रक्चर्ड आउटपुट** | JSON schema, ग्रामर | JSON schema               | JSON schema                                              |
| **बिल्ट-इन टूल्स**     | —                   | वेब सर्च, कोड एक्सीक्यूशन | वेब सर्च, फ़ाइल सर्च, कोड इंटरप्रेटर, कंप्यूटर यूज़, MCP |

तीनों endpoints एक ही authentication साझा करते हैं — बस अपनी API key को `Authorization` हेडर में Bearer टोकन के रूप में पास करें।