GENIM API

Generación de imágenes

URL: https://genim-api.saptiva.com/api

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
prompt	string	Descripción de la imagen deseada.	Robot con gorra roja.

---

Parámetros Opcionales

Parametro	Tipo	Default	Descripción
width	integer	1024	Anchura de la imagen en píxeles.
height	integer	1024	Altura de la imagen en píxeles.

---

Solicitudes

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

Body

{
    "prompt": "gatos jugando",
    "width": 1024,
    "height": 1024,
}

Respuesta

{
    "image_url": "https://[aws-bucket-url]/[session_id].png",
    "status": 200,
    "error": false
}

En el ejemplo pasado, se realizo una petición a la API . Obtuvimos por respuesta lo siguiente:

Gatos jugando

---

Respuesta de error

Este es una respuesta obtenida cuando el servidor no responde

response

{
    "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.

---

Limitación de velocidad

Actualmente no hay límites de velocidad implementados, pero tenga cuidado con su uso.

---

Mejores prácticas

1. Siempre maneje las respuestas de error en su aplicación.

2. Incluya un manejo de errores adecuado para los tiempos de espera (las solicitudes pueden demorar hasta 360 segundos).

3. Almacene las URL de las imágenes devueltas de forma segura.

4. Mantenga su token de autenticación seguro y nunca lo exponga en el código del lado del cliente.

---

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

import requests
import json

url = "https://api.saptiva.com/v1/chat/completions"

payload = json.dumps({
  "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
})

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

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

print(response.text)

Javascript

var request = require('request');

var options = {
  'method': 'POST',
  'url': 'https://api.saptiva.com/v1/chat/completions',
  'headers': {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer <TU_API_KEY>'
  },
  body: JSON.stringify({
    "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
  })
};

request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

---

Soporte

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