Ejemplos

Respuestas reales, ruta por ruta

Seis peticiones a la API de Serenity Edge con su respuesta tal como llegó: un resumen, una factura leída, un ticket clasificado, frases comparadas, resultados ordenados y datos personales enmascarados.

Respuestas reales de la API, generadas el 14 de octubre de 2026. Esta página no hace llamadas en vivo.

Al crear tu cuenta de Serenity Star recibes un crédito de bienvenida para probar los modelos de chat.

Las rutas de decisiones, embeddings, rerank y anonimización necesitan una clave de API de Serenity Edge.Cómo conseguirla

Chat: resumen de un correo

Orion Plus resume en tres puntos el correo de un cliente, con un mensaje de sistema que fija el idioma y el tono.

Ruta: POST /v1/chat/completions
Modelo: orion-plus
Tokens: 82 de entrada y 78 de salida

Petición

{
  "model": "orion-plus",
  "messages": [
    {
      "role": "system",
      "content": "Responde en español, de forma breve y profesional."
    },
    {
      "role": "user",
      "content": "Resume en tres viñetas este correo: 'Hola, el pedido 8812 llegó con dos cajas dañadas. Necesito reposición antes del viernes porque tenemos una feria el sábado. Si no es posible, prefiero el reembolso de esas dos cajas.'"
    }
  ],
  "max_tokens": 200,
  "temperature": 0.3
}

Respuesta

Reporte de incidencia: El pedido 8812 llegó con dos cajas dañadas.
Solicitud prioritaria: Se requiere reposición antes del viernes para cumplir con la feria del sábado.
Alternativa: En caso de no poder realizar la reposición a tiempo, se prefiere el reembolso de las cajas afectadas.

OCR: lectura de una factura

PaddleOCR-VL 1.6 recibe la imagen de una factura con la instrucción «OCR:» y devuelve su texto, con la disposición de la tabla.

Ruta: POST /v1/chat/completions
Modelo: paddleocr-vl-1.6
Tokens: 1243 de entrada y 196 de salida

Petición

Factura de ejemplo n.º 2026-0418 a Talleres Ribera, S.L., con tres conceptos, base imponible, IVA y total. — Imagen enviada

{
  "model": "paddleocr-vl-1.6",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "image_url",
          "image_url": {
            "url": "data:image/png;base64,…"
          }
        },
        {
          "type": "text",
          "text": "OCR:"
        }
      ]
    }
  ],
  "max_tokens": 1024
}

La imagen en base64 se ha omitido de la petición.

Respuesta

FACTURA N.º 2026-0418

Fecha: 14/10/2026    Vencimiento: 13/11/2026
Cliente: Talleres Ribera, S.L.    NIF B12345678

Concepto                          Uds.           Precio           Importe
Mantenimiento preventivo              2          180,00        360,00
Sustitución de filtros              6          24,50        147,00
Desplazamiento                1          45,00        45,00

Base imponible                    552,00
IVA 21 %                          115,92
TOTAL (EUR)                    667,92

Decisiones: triaje de un ticket

Vista previa

Orion Compass responde a tres preguntas sobre un ticket de soporte en una sola llamada: si pide un reembolso, qué equipo debe atenderlo y con qué urgencia. Cada respuesta llega con su probabilidad.

Ruta: POST /v1/decisions
Modelo: orion-compass
Tokens: 370 de entrada

Petición

{
  "model": "orion-compass",
  "input": "Ticket 4821. Cliente: Me habéis cobrado dos veces el mismo pedido la semana pasada. Devolvedme el cargo duplicado hoy o lo reclamaré al banco.",
  "questions": [
    {
      "type": "predicate",
      "name": "reembolso",
      "instructions": "¿Pide el cliente un reembolso?"
    },
    {
      "type": "choice",
      "name": "equipo",
      "instructions": "¿Qué equipo debe atender el ticket?",
      "choices": [
        {
          "value": "facturacion",
          "description": "Pagos, cargos y reembolsos"
        },
        {
          "value": "logistica",
          "description": "Envíos y entregas"
        },
        {
          "value": "tecnico",
          "description": "Problemas de la aplicación"
        }
      ]
    },
    {
      "type": "score",
      "name": "urgencia",
      "instructions": "¿Qué urgencia tiene el ticket?",
      "levels": [
        {
          "value": 1,
          "label": "baja"
        },
        {
          "value": 2,
          "label": "normal"
        },
        {
          "value": 3,
          "label": "alta"
        },
        {
          "value": 4,
          "label": "crítica"
        }
      ]
    }
  ]
}

Respuesta

Ticket 4821. Cliente: Me habéis cobrado dos veces el mismo pedido la semana pasada. Devolvedme el cargo duplicado hoy o lo reclamaré al banco.

reembolsoSí o no

¿Pide el cliente un reembolso?

Sí (más probable)99,5 %
No0,5 %

equipoUna opción

¿Qué equipo debe atender el ticket?

facturacion (más probable)99,9 %
logistica< 0,1 %
tecnico< 0,1 %

urgenciaEscala

¿Qué urgencia tiene el ticket?

baja0,6 %
normal11,3 %
alta (más probable)61,9 %
crítica26,2 %

Embeddings: similitud entre frases

Qwen3 Embedding 0.6B convierte tres preguntas de clientes en vectores. Las dos primeras piden lo mismo con otras palabras y quedan mucho más cerca entre sí que de la tercera.

Ruta: POST /v1/embeddings
Modelo: qwen3-embedding-0.6b
Tokens: 33 de entrada

Petición

{
  "model": "qwen3-embedding-0.6b",
  "input": [
    "¿Cómo cambio la dirección de entrega?",
    "Quiero modificar dónde recibo mi pedido.",
    "¿Cuál es el horario de atención?"
  ]
}

Respuesta

Textos

1¿Cómo cambio la dirección de entrega?
2Quiero modificar dónde recibo mi pedido.
3¿Cuál es el horario de atención?

1024 dimensiones por vector

Similitud coseno, calculada a partir de los vectores devueltos

Textos 1 y 20,654
Textos 1 y 30,353

Rerank: la mejor respuesta a una pregunta

Qwen3 Reranker 0.6B ordena cuatro textos de ayuda según su relevancia para la pregunta de un cliente y devuelve los tres mejores.

Ruta: POST /v1/rerank
Modelo: qwen3-reranker-0.6b
Tokens: 91 de entrada, estimados a partir de los caracteres

Petición

{
  "model": "qwen3-reranker-0.6b",
  "query": "¿Cómo devuelvo un pedido?",
  "documents": [
    "El plazo de devolución es de 30 días desde la entrega.",
    "Nuestro horario de atención es de 9:00 a 18:00.",
    "Para devolver un pedido, solicita la etiqueta desde tu cuenta y entrégalo en cualquier punto de recogida.",
    "Los envíos a Canarias tardan de 3 a 5 días laborables."
  ],
  "top_n": 3
}

Respuesta

Consulta: ¿Cómo devuelvo un pedido?

Los más relevantes, en orden

1
Para devolver un pedido, solicita la etiqueta desde tu cuenta y entrégalo en cualquier punto de recogida.
relevancia 0,9995
2
El plazo de devolución es de 30 días desde la entrega.
relevancia 0,5659
3
Los envíos a Canarias tardan de 3 a 5 días laborables.
relevancia 0,0036

Fuera de los resultados

Nuestro horario de atención es de 9:00 a 18:00.

Anonimización: datos personales enmascarados

Privacy Filter localiza el nombre, el correo, el teléfono y el IBAN de un mensaje y los sustituye por etiquetas, para que el texto pueda procesarse sin esos datos.

Ruta: POST /v1/redact
Modelo: privacy-filter(por defecto)
Tokens: 35 de entrada, estimados a partir de los caracteres

Petición

{
  "inputs": "Hola, soy Marta Gómez. Podéis escribirme a [email protected] o llamarme al +34 612 345 678. Mi IBAN es ES91 2100 0418 4502 0005 1332."
}

Respuesta

Texto enviado, con los datos detectados

Hola, soy Marta GómezPersona. Podéis escribirme a [email protected]Correo o llamarme al +34 612 345 678Teléfono. Mi IBAN es ES91 2100 0418 4502 0005 1332Número de cuenta.

Texto devuelto

Hola, soy [PERSON]. Podéis escribirme a [EMAIL] o llamarme al [PHONE]. Mi IBAN es [ACCOUNT_NUMBER].

Pruébalo con tu propio código

Cambia la URL base y envía estas mismas peticiones desde tu aplicación.

Obtener clave de API Leer la documentación