Saltar al contenido principal
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.

​
Chat Completions — /v1/chat/completions

El endpoint de Chat Completions 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. 
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 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. 
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 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. 
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 CompletionsAnthropic MessagesResponses
FormatoOpenAI ChatAnthropic MessagesOpenAI Responses
Ideal paraCompatibilidad con SDK de OpenAIFunciones nativas de ClaudeFunciones más recientes de OpenAI
StreamingSSESSESSE
Llamadas a funcionesSíSí (personalizadas + integradas)Sí
RazonamientoSíPensamiento extendidoSí
Salida estructuradaJSON schema, gramáticaJSON schemaJSON schema
Herramientas integradas—Búsqueda web, ejecución de códigoBú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.