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

# Inicio rápido con LLM

Sunra ofrece tres endpoints de API para LLM, cada uno con un formato diferente. Los tres utilizan la misma autenticación y URL base (`https://api-llm.sunra.ai`), por lo que puedes elegir el formato que mejor se adapte a tu stack.

Antes de comenzar, obtén una clave de API desde tu [panel de control](https://sunra.ai/dashboard/api-tokens).

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

El endpoint de [Chat Completions](/es/llm/chat) sigue el formato de **OpenAI Chat Completions**. Acepta una lista de mensajes con roles (`system`, `user`, `assistant`) y devuelve una respuesta generada.

Usa este endpoint cuando quieras compatibilidad directa con los SDKs y herramientas de OpenAI.

**Características principales:** streaming, llamadas a funciones, visión (imágenes, audio, video, archivos), razonamiento, salidas estructuradas (JSON schema / gramática), 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`

El endpoint de [Anthropic Messages](/es/llm/messages) sigue el formato de la **API Anthropic Messages**. Utiliza roles de mensaje `user` / `assistant` con bloques de contenido enriquecido y un parámetro `system` separado.

Usa este endpoint cuando quieras acceso nativo a los modelos Anthropic Claude y funciones como pensamiento extendido, caché de prompts, citas y herramientas integradas (búsqueda web, ejecución de código).

**Características principales:** streaming, pensamiento extendido, caché de prompts, uso de herramientas (personalizadas + integradas), entrada de PDF/documentos, citas, salidas estructuradas.

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

El endpoint de [Responses](/es/llm/responses) sigue el formato de la **API OpenAI Responses**. Acepta elementos de entrada flexibles (mensajes, llamadas a funciones, razonamiento) y devuelve elementos de salida estructurados.

Usa este endpoint cuando necesites las funciones más recientes de OpenAI Responses, como búsqueda web integrada, búsqueda de archivos, intérprete de código, uso de computadora, integración de herramientas MCP o generación de imágenes.

**Características principales:** streaming, llamadas a funciones, búsqueda web, búsqueda de archivos, intérprete de código, uso de computadora, herramientas MCP, generación de imágenes, razonamiento, salidas estructuradas.

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

## Cómo elegir el endpoint adecuado

|                             | Chat Completions                 | Anthropic Messages                | Responses                                                                         |
| --------------------------- | -------------------------------- | --------------------------------- | --------------------------------------------------------------------------------- |
| **Formato**                 | OpenAI Chat                      | Anthropic Messages                | OpenAI Responses                                                                  |
| **Ideal para**              | Compatibilidad con SDK de OpenAI | Funciones nativas de Claude       | Funciones más recientes de OpenAI                                                 |
| **Streaming**               | SSE                              | SSE                               | SSE                                                                               |
| **Llamadas a funciones**    | Sí                               | Sí (personalizadas + integradas)  | Sí                                                                                |
| **Razonamiento**            | Sí                               | Pensamiento extendido             | Sí                                                                                |
| **Salida estructurada**     | JSON schema, gramática           | JSON schema                       | JSON schema                                                                       |
| **Herramientas integradas** | —                                | Búsqueda web, ejecución de código | Búsqueda web, búsqueda de archivos, intérprete de código, uso de computadora, MCP |

Los tres endpoints comparten la misma autenticación — simplemente pasa tu clave de API como token Bearer en el encabezado `Authorization`.