# Quickstart

La **API** de **Saptiva** te permite integrar **IA** en tus aplicaciones sin complicarte: genera texto (chat/completions), crea embeddings para búsqueda semántica y habilita arquitecturas **RAG**. En esta documentación verás cómo autenticarte, seleccionar modelos, ajustar parámetros (temperatura, longitud y formato), indexar contenidos con embeddings y aplicar buenas prácticas de latencia, cuotas y manejo de errores. Las capacidades disponibles dependen del modelo y del entorno (on-prem, nube privada o pública).

### Crea una API Key

<mark style="color:$primary;">Crea una API Key accediendo al</mark> [<mark style="color:green;">panel de control de nuestro Lab Saptiva</mark>](https://lab.saptiva.com/)  que usarás para acceder de forma segura a la API. En la parte superior izquierda encontrarás el botón.

<figure><img src="https://109074694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1Xeu6KDnv2A0dUxoQDDU%2Fuploads%2Fe1xDsf3w3fdBaf6HP3k1%2FScreenshot%20from%202025-07-24%2009-47-05.png?alt=media&#x26;token=3944a5c0-231c-4189-930d-b83c50928fa3" alt=""><figcaption></figcaption></figure>

Guarda la clave en un lugar seguro, como un archivo [<mark style="color:green;">`.zshrc`</mark>](https://www.freecodecamp.org/news/how-do-zsh-configuration-files-work/) u otro archivo de texto en tu computadora. Una vez que hayas generado una clave API, expórtala como una variable de entorno en tu terminal.

{% tabs %}
{% tab title="Windows" %}

```bash
setx API_KEY "va-ai-618sfuC5Y..."
```

{% endtab %}

{% tab title="MacOS - Linux" %}

```bash
export API_KEY="va-ai-618sfuC5Y..."
```

{% endtab %}
{% endtabs %}

### Haz tu primera solicitud a la API

Con la API Key de Saptiva exportada como variable de entorno, [<mark style="color:green;">estás listo para realizar tu primera solicitud API</mark>](https://saptiva.gitbook.io/saptiva-docs/basicos/api-reference). Puedes usar la API REST directamente con el cliente HTTP que elijas.