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

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

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

{
    "error": true,
    "message": "Error description",
    "status": 408
}

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' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <TU_API_KEY>' \
--data '{
    "modelName":"Saptiva Turbo",
    "newTokens":256,
    "sysPrompt":"",
    "message":"Hola. Cómo estas?",
    "temperature": 0.7
}'

Python

import json
import requests

url = "https://api.saptiva.com"

payload = json.dumps({
  "modelName": "Saptiva Turbo",
  "newTokens": 256,
  "sysPrompt": "",
  "message": "hola, como estas?",
  "temperature": 0.7
})

headers = {
  'Content-Type': 'application/json',
  'Authorization': 'Bearer <TU_API_KEY>'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

Javascript

const myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
myHeaders.append("Authorization", "Bearer <TU_API_KEY>");

const raw = JSON.stringify({
  "modelName": "Saptiva Turbo",
  "newTokens": 256,
  "sysPrompt": "",
  "message": "hola, como estas?",
  "temperature": 0.7
});

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

fetch("https://api.saptiva.com", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

Soporte

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