TEXT API (ACTUAL)

Importante

A partir del 16 de mayo, esta forma de llamar a la API será descontinuada. Por favor, actualiza tus integraciones antes de esa fecha para evitar interrupciones en el servicio.

Procesamiento de respuestas

URL: https://api.saptiva.com

POST /

Headers

Nombre	Valor
Content-Type	application/json
Authorization	Bearer <API_KEY>

Nuestra API requiere autenticación utilizando un Token Bearer. Genera tu token dentro de nuestro lab y comienza a hacer peticiones. Incluye el token en el header de la solicitud de la siguiente manera:

Authorization: Bearer <TOKEN AUTHORIZATION>

Parámetros Obligatorios

Body

Parametro	Tipo	Descripción	Ejemplo
modelName	string	Nombre del modelo LLM a usar.	DeepSeek R1 Lite
newTokens	number	Número de tokens.	256
sysPrompt	string	Descripción del comportamiento del bot.	Eres un experto en lenguaje humano.
message	string	Mensaje o consulta actual del usuario.	hola, como esta?
temperature	double	Grado de aleatoriedad en la generación del texto. (valor entre 0.0 y 1.0)	0.7

Solicitudes

A continuación, se presenta el formato que debe tener el BODY, junto con el ejemplo de la respuesta esperada.

Body

{
    "modelName":"Saptiva Turbo",
    "newTokens":256,
    "sysPrompt":"",
    "message":"hola, como estas?",
    "temperature": 0.7
}

Respuesta

Respuestas

A continuación, se muestra un ejemplo de una respuesta exitosa y una de error.

éxito

{C
    "error": false,
    "status": 200,
    "response": "¡Hola! Estoy muy bien, gracias por preguntar. ¿Cómo estás tú? 😊"
}

error

Errores

Para analizar y solucionar los errores a los que te puedes enfrentar al hacer uso de esta API, consulta nuestros códigos de errores junto con las soluciones que tenemos para ti.

Mejores Prácticas

• Proteja las credenciales: Nunca exponga tu API Key o tokens de autenticación en el código del lado del cliente. Utiliza variables de entorno o un backend seguro para manejar credenciales.

• Use HTTPS: Siempre realice solicitudes a la API a través de HTTPS para proteger la transmisión de datos.

• Verifique las respuestas de la API: Siempre maneje los códigos de estado HTTP correctamente (200, 300, 350, 400, 401, 422, etc.).

• Gestione los tiempos de espera (timeouts): Establezca límites de tiempo adecuados para evitar que la aplicación se quede bloqueada en solicitudes prolongadas.

Ejemplos

cURL

curl --location 'https://api.saptiva.com/v1/chat/completions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <TU_API_KEY>' \
--data '{
  "model": "Saptiva Turbo",
  "messages": [
    {
      "role": "system",
      "content": "Eres un agente servicial"
    },
    {
      "role": "user",
      "content": "¿Cuál es la capital de Francia?"
    }
  ],
  "max_tokens": 256,
  "temperature": 0.7,
  "top_p": 0.95
}'

Python

Javascript

---

Soporte

Para cualquier problema o pregunta técnica, comuníquese con el equipo de desarrollo.